技术文档

接入流程

1. 注册账号（手机号 + 密码），注册即送 1,000 次调用额度。
2. 在价格页选择订阅套餐并提交订单；工作人员 1 个工作日内确认并发送付款信息。
3. 确认到款后开通额度，产品密钥（AppKey）与本文档发送至下单邮箱。
4. 按各接口详情页的参数说明发起 HTTPS 请求。

请求方式

接口地址前缀：https://api.dzdzhineng.top，支持 GET 与 POST（application/x-www-form-urlencoded），统一使用 UTF-8 编码。输入数据格式为「经度,纬度」，小数点后最多 6 位。

公共参数

鉴权与签名

每个请求必须携带 key。建议在控制台开启以下两项以防密钥被盗用：

• IP 白名单：仅允许指定服务器 IP 调用。
• 数字签名：将除 sig 外的全部参数按参数名升序拼接为 k1=v1&k2=v2，末尾追加私钥后计算 MD5（32 位小写）作为 sig。

sig = md5("address=杭州市西湖区文三路90号&key=您的AppKey&output=json" + 私钥)

返回结构

所有接口统一返回 status（1 成功 / 0 失败）、info（状态描述）、infocode（错误码）三个字段，业务数据在各自字段中，见接口详情页示例。

错误码

调用示例

curl

curl "https://api.dzdzhineng.top/v3/geo/geocode?key=您的AppKey&address=杭州市西湖区文三路90号&city=杭州"

Python

import requests
r = requests.get("https://api.dzdzhineng.top/v3/geo/geocode",
                 params={"key": "您的AppKey", "address": "杭州市西湖区文三路90号", "city": "杭州"}, timeout=5)
data = r.json()
if data["status"] == "1":
    print(data["geocodes"][0]["location"])

Java

String url = "https://api.dzdzhineng.top/v3/geo/geocode?key=您的AppKey&address="
        + URLEncoder.encode("杭州市西湖区文三路90号", "UTF-8");
HttpResponse<String> resp = HttpClient.newHttpClient()
        .send(HttpRequest.newBuilder(URI.create(url)).GET().build(), HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());

接口列表

• AI客服机器人 /v3/geo/geocode
• 智能文档识别 /v3/geo/regeo
• 低代码开发平台 /v3/place/text
• API网关管理 /v3/place/around
• BI数据看板 /v3/assistant/inputtips
• 数据中台 /v3/direction/driving
• 等保合规平台 /v3/distance
• WAF防护 /v3/ip
• ERP管理系统 /v3/config/district
• OA协同办公 /v3/assistant/coordinate/convert
• CRM客户管理 /v3/staticmap
• HR人力资源 /v3/weather/weatherInfo

建议：客户端设置 3~5 秒超时并做一次重试；批量任务控制并发不超过默认 QPS；密钥请勿写入前端代码。