拼货邦开放平台 API接口文档

调用前期准备

• 商户注册：在 拼货邦商户平台 注册登录。
• 创建应用：单应用调用/token接口频率限制为100次/分钟，发布货物接口为500次/分钟，超出返回429错误码。
• 提交公司信息审核，开通api请求权限：72小时内审核。
• 生成app_secret：app_secret 为敏感信息，需加密存储，禁止明文传输。

一、基础信息

接口概览

头部参数

请求头参数

返回头参数

二、通过Code换取AccessToken

接口信息

请求参数

请求示例（curl）

curl -X POST 'https://api.xxx.com/v1/oauth/access_token' \
-H 'Content-Type: application/json' \
-d '{
    "app_id": "wx1234567890abcdef",
    "app_secret": "1234567890abcdef1234567890abcdef",
    "code": "013Z5t0w3X8b621n0U2w3F8k23Z5t0w9",
    "redirect_uri": "https://yourdomain.com/callback",
    "grant_type": "authorization_code"
}'

返回数据

成功响应（HTTP 200）

{
    "code": 0,
    "msg": "success",
    "data": {
        "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
        "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
        "expires_in": 7200,
        "openid": "o6_bmjrPTlm6_2sgVt7hMZOPfL2M",
        "scope": "snsapi_userinfo",
        "create_time": 1734567890
    },
    "request_id": "req-1234567890abcdef"
}

失败响应（HTTP 400）

{
    "code": 40001,
    "msg": "授权码code已过期或无效",
    "request_id": "req-1234567890abcdef",
    "detail": "code有效期为5分钟，且仅可使用一次"
}

返回参数说明

三、刷新AccessToken

接口信息

请求参数

返回示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
        "expires_in": 7200,
        "refresh_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
        "openid": "o6_bmjrPTlm6_2sgVt7hMZOPfL2M",
        "scope": "snsapi_userinfo"
    },
    "request_id": "req-0987654321fedcba"
}

四、获取用户基本信息

接口信息

请求参数

请求示例（curl）

curl -X GET 'https://api.xxx.com/v1/user/info?access_token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...&openid=o6_bmjrPTlm6_2sgVt7hMZOPfL2M'

返回示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "openid": "o6_bmjrPTlm6_2sgVt7hMZOPfL2M",
        "nickname": "张三",
        "sex": 1,
        "city": "北京",
        "province": "北京",
        "country": "中国",
        "avatar_url": "https://thirdwx.qlogo.cn/mmopen/vi_32/Q0j4TwGTfT..."
    },
    "request_id": "req-abcdef1234567890"
}

五、创建订单接口

接口信息

请求参数

请求示例（curl）

curl -X POST 'https://api.xxx.com/v1/order/create' \
-H 'Content-Type: application/json' \
-d '{
    "access_token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
    "order_no": "ORD202512190001",
    "amount": 100,
    "goods_name": "VIP会员月卡",
    "notify_url": "https://yourdomain.com/order/notify"
}'

返回示例

{
    "code": 0,
    "msg": "success",
    "data": {
        "order_id": "1234567890",
        "order_no": "ORD202512190001",
        "pay_url": "https://pay.xxx.com/pay?orderId=1234567890",
        "create_time": 1734567890
    },
    "request_id": "req-9876543210abcdef"
}

六、错误码说明

七、调用注意事项

• 协议要求：所有接口必须使用HTTPS协议调用，HTTP请求会被直接拒绝。
• 频率限制：单应用调用/token接口频率限制为100次/分钟，订单接口为500次/分钟，超出返回429错误码。
• 缓存建议：AccessToken有效期2小时，建议本地缓存（如Redis），避免频繁调用接口。
• 敏感信息：code、refresh_token、access_token均为敏感信息，需加密存储，禁止明文传输。
• 订单幂等性：创建订单接口需保证商户订单号唯一，避免重复创建订单。
• 问题排查：调用失败时请先核对参数，若仍有问题，保留request_id联系平台技术支持。

八、Data数据加密

八、头部数据加密