快速接入

5分钟完成从注册到第一次API调用。

第一步：注册开发者账号

访问开放平台控制台，使用手机号 + 短信验证码完成注册。

TIP

注册即可获得沙箱环境的访问权限，无需等待审核。

第二步：创建应用

登录控制台后，在「应用管理」中点击「创建应用」：

填写应用名称、类型、简介
上传应用 Logo
系统自动生成 AppKey 和 AppSecret

重要

AppSecret 仅在创建时完整显示一次，请妥善保存。后续只能通过重置获取新密钥。

第三步：配置应用

在应用详情页完成以下配置：

回调地址：用于接收事件通知（订单状态变更等）
IP 白名单：限制API调用的来源IP，提升安全性
API 权限：选择需要的API模块权限

第四步：发起 API 调用

请求示例

bash

curl -X GET 'https://openapi.example.com/v1/merchants?page=1&size=10' \
  -H 'X-App-Key: your_app_key' \
  -H 'X-Timestamp: 1709280000' \
  -H 'X-Nonce: a1b2c3d4' \
  -H 'X-Sign: calculated_signature'

签名计算

所有API请求都需要携带签名，详见签名算法。

响应格式

json

{
  "code": 0,
  "msg": "success",
  "data": {
    "list": [...],
    "total": 100
  }
}

第五步：沙箱测试

在沙箱环境完成功能验证后，联系平台运营切换到生产环境。

环境	API 地址	说明
沙箱	`https://sandbox-openapi.example.com`	测试数据，随时重置
生产	`https://openapi.example.com`	真实数据

接下来

了解签名算法的详细实现
查看 API 文档了解所有可用接口
下载 SDK 快速集成

快速接入 ​

第一步：注册开发者账号 ​

第二步：创建应用 ​

第三步：配置应用 ​

第四步：发起 API 调用 ​

请求示例 ​

签名计算 ​

响应格式 ​

第五步：沙箱测试 ​

接下来 ​