public class OpenApiDemo { private static final String API_KEY = ""; private static final String API_SECRET = ""; private static final String BASE_URL = "https://openapi.bittap.com"; private static final String SEPARATOR = "&"; private static final String EQUALS = "="; private static final OkHttpClient CLIENT = new OkHttpClient(); private static final ObjectMapper MAPPER = new ObjectMapper(); public static void main(String[] args) throws Exception { String url = "https://openapi.bittap.com/fmapi/v1/time"; sendGetPublic(url); } // ----------------- 工具方法 ------------------- private static void sendSignedPost(String url, JsonNode body) throws Exception { long timestamp = System.currentTimeMillis(); String nonce = UUID.randomUUID().toString().replace("-", ""); // 1. 排序 JSON JsonNode sortedNode = sortJsonNode(body); // 1. 扁平化 body String bodyData = convertJsonToQueryString(sortedNode); // 2. 拼接签名串 String signData = (bodyData.isEmpty() ? "" : bodyData + "&") + "timestamp=" + timestamp + "&nonce=" + nonce; String sign = hmacSha256Hex(signData, API_SECRET); String bodyJson = MAPPER.writeValueAsString(body); RequestBody requestBody = RequestBody.create(bodyJson, MediaType.parse("application/json; charset=utf-8")); Request request = new Request.Builder() .url(url) .post(requestBody) .addHeader("X-BT-APIKEY", API_KEY) .addHeader("X-BT-SIGN", sign) .addHeader("X-BT-TS", String.valueOf(timestamp)) .addHeader("X-BT-NONCE", nonce) .build(); try (Response response = CLIENT.newCall(request).execute()) { System.out.println("POST " + url); System.out.println("Response: " + response.code() + " " + (response.body() != null ? response.body().string() : "")); } } private static void sendGetPublic(String url) throws Exception { Request request = new Request.Builder() .url(url) .get() .build(); try (Response response = CLIENT.newCall(request).execute()) { System.out.println("GET " + url); System.out.println("Response: " + response.code() + " " + (response.body() != null ? response.body().string() : "")); } } private static void sendSignedPut(String url, JsonNode body) throws Exception { long timestamp = System.currentTimeMillis(); String nonce = UUID.randomUUID().toString().replace("-", ""); // 1. 排序 JSON JsonNode sortedNode = sortJsonNode(body); // 1. 扁平化 body String bodyData = convertJsonToQueryString(sortedNode); // 2. 拼接签名串 String signData = (bodyData.isEmpty() ? "" : bodyData + "&") + "timestamp=" + timestamp + "&nonce=" + nonce; String sign = hmacSha256Hex(signData, API_SECRET); String bodyJson = MAPPER.writeValueAsString(body); RequestBody requestBody = RequestBody.create(bodyJson, MediaType.parse("application/json; charset=utf-8")); Request request = new Request.Builder() .url(url) .put(requestBody) .addHeader("X-BT-APIKEY", API_KEY) .addHeader("X-BT-SIGN", sign) .addHeader("X-BT-TS", String.valueOf(timestamp)) .addHeader("X-BT-NONCE", nonce) .build(); try (Response response = CLIENT.newCall(request).execute()) { System.out.println("POST " + url); System.out.println("Response: " + response.code() + " " + (response.body() != null ? response.body().string() : "")); } } private static void sendSignedPost(String url) throws Exception { long timestamp = System.currentTimeMillis(); String nonce = UUID.randomUUID().toString().replace("-", ""); String signData = "×tamp=" + timestamp + "&nonce=" + nonce; String sign = hmacSha256Hex(signData, API_SECRET); Request request = new Request.Builder() .url(url) .post(RequestBody.create("", MediaType.parse("application/json; charset=utf-8"))) .addHeader("X-BT-APIKEY", API_KEY) .addHeader("X-BT-SIGN", sign) .addHeader("X-BT-TS", String.valueOf(timestamp)) .addHeader("X-BT-NONCE", nonce) .build(); try (Response response = CLIENT.newCall(request).execute()) { System.out.println("POST " + url); System.out.println("Response: " + response.code() + " " + (response.body() != null ? response.body().string() : "")); } } private static void sendSignedGet(String url) throws Exception { long timestamp = System.currentTimeMillis(); String nonce = UUID.randomUUID().toString().replace("-", ""); // 从 URL 中解析已有 query String query = ""; int idx = url.indexOf("?"); if (idx != -1) { query = url.substring(idx + 1); } query = sortQueryParams(query); String signData = (query.isEmpty() ? "&" : query + "&") + "timestamp=" + timestamp + "&nonce=" + nonce; String sign = hmacSha256Hex(signData, API_SECRET); String finalUrl = url; Request request = new Request.Builder() .url(finalUrl) .get() .addHeader("X-BT-APIKEY", API_KEY) .addHeader("X-BT-SIGN", sign) .addHeader("X-BT-TS", String.valueOf(timestamp)) .addHeader("X-BT-NONCE", nonce) .build(); try (Response response = CLIENT.newCall(request).execute()) { System.out.println("GET " + finalUrl); System.out.println("Response: " + response.code() + " " + (response.body() != null ? response.body().string() : "")); } } private static String convertJsonToQueryString(JsonNode jsonNode) { if (jsonNode == null || jsonNode.isNull()) { return ""; } MultiValueMap params = new LinkedMultiValueMap<>(); flattenJson(jsonNode, "", params); StringBuilder queryString = new StringBuilder(); boolean first = true; for (Map.Entry entry : params.toSingleValueMap().entrySet()) { if (!first) { queryString.append("&"); } else { first = false; } queryString.append(entry.getKey()).append("=").append(entry.getValue()); } return queryString.toString(); } private static void flattenJson(JsonNode node, String path, MultiValueMap params) { if (node.isObject()) { Iterator> fields = node.fields(); while (fields.hasNext()) { Map.Entry field = fields.next(); if (field.getValue().isNull()) { continue; } String newPath = path.isEmpty() ? field.getKey() : path + "." + field.getKey(); flattenJson(field.getValue(), newPath, params); } } else if (node.isArray()) { for (int i = 0; i < node.size(); i++) { JsonNode jsonNode = node.get(i); if (jsonNode.isNull() || jsonNode.isArray() && jsonNode.isEmpty()) { continue; } String newPath = path + "[" + i + "]"; flattenJson(node.get(i), newPath, params); } } else { // 基本类型 if (node.asText().isBlank()) { return; } params.add(path, node.asText()); } } private static String hmacSha256Hex(String data, String secret) throws Exception { Mac mac = Mac.getInstance("HmacSHA256"); SecretKeySpec keySpec = new SecretKeySpec(secret.getBytes(StandardCharsets.UTF_8), "HmacSHA256"); mac.init(keySpec); byte[] raw = mac.doFinal(data.getBytes(StandardCharsets.UTF_8)); StringBuilder sb = new StringBuilder(raw.length * 2); for (byte b : raw) sb.append(String.format("%02x", b)); return sb.toString(); } private static JsonNode sortJsonNode(JsonNode node) { try { if (node == null || node.isNull()) return node; if (node.isObject()) { ObjectNode out = MAPPER.createObjectNode(); TreeMap sorted = new TreeMap<>(); Iterator> fields = node.fields(); while (fields.hasNext()) { Map.Entry f = fields.next(); sorted.put(f.getKey(), sortJsonNode(f.getValue())); } for (Map.Entry e : sorted.entrySet()) { out.set(e.getKey(), e.getValue()); } return out; } else if (node.isArray()) { ArrayNode arr = MAPPER.createArrayNode(); for (JsonNode el : node) arr.add(sortJsonNode(el)); return arr; } else { return node; } } catch (Exception ex) { return node; } } private static String sortQueryParams(String query) { if (StringUtils.isBlank(query)) { return ""; } try { // 使用 LinkedMultiValueMap 处理相同 key 的参数 MultiValueMap paramMap = new LinkedMultiValueMap<>(); String[] paramPairs = query.split(SEPARATOR); for (String pair : paramPairs) { String[] keyValue = pair.split(EQUALS, 2); if (keyValue.length == 2) { paramMap.add(keyValue[0], keyValue[1]); } } // 将 MultiValueMap 转换为 Map，相同 key 的值转为数组 Map convertedMap = new LinkedHashMap<>(); for (Map.Entry> entry : paramMap.entrySet()) { String key = entry.getKey(); List values = entry.getValue(); if (values.size() == 1) { convertedMap.put(key, values.get(0)); } else { convertedMap.put(key, values); } } // 使用 Jackson 将 Map 转换为 JsonNode JsonNode jsonNode = MAPPER.valueToTree(convertedMap); // 对 JsonNode 进行排序 JsonNode sortedJsonNode = sortJsonNode(jsonNode); // 将排序后的 JsonNode 转换为查询字符串 return convertJsonToQueryString(sortedJsonNode); } catch (Exception e) { return query; } } }

参数名	类型	描述
code	STRING	响应代码
msg	STRING	响应消息
success	BOOLEAN	成功标识
data	INTEGER	数据载荷

获取服务器时间

请求地址

请求参数

响应参数

请求示例

响应示例

错误码解释

代码示例