第三方平台账号授权

一、第三方平台账号授权

通过第三方授权获取月结账号授权码

1.1 接口格式

提供统一格式的HTTP POST或GET调用接口,并返回统一格式JSON数据。

1.2 请求地址

https://poll.kuaidi100.com/printapi/authThird.do

请求参数（header）

请求参数（body）

param数据结构：

1.3 返回结果

returnCode=200时，说明系统已经授权完成，data的内容

returnCode=201时，说明系统未授权需要进行第三方授权，data的内容

1.4 提供数据内容

returnCode=200时，说明系统已经授权完成：

{  
    "result": true,
     "returnCode": "200",
     "message": "成功",
     "data": {
         "customerId": null,
         "createTime": null,
         "partnerKey": "****", // 面单需要的partnerKey 
         "parterId": "****",   // 面单需要的parterId 
         "data": null,
         "net": "****"         // 面单需要的net 
     }
}

returnCode=201时，说明系统未授权需要进行第三方授权:

{  
    "result": false,
    "returnCode": "201",
    "message": "成功",
    "data": {
        "url": "****"  // 通过返回的URL调转到第三方进行授权登录 
    }
}

1.5 返回信息代码含义

二、第三方授权回调

提交的第三方授权中，通过返回的url进行提交后，系统会根据填入的callBackUrl进行数据回传。

2.1 接口格式

提供统一格式的HTTP POST，并以application/x-www-form-urlencoded格式进行回调请求。

2.2 请求地址

例如：

<form method="post" name="" action="[callbackUrl]">
    <input type="text" name="param" value="{XXX}" />
</form>

请求参数：

param数据结构：

message数据结构：

请求参数示例

param = {
	"result": true,
	"returnCode": "200",
	"message": "{\"createTime\":\"2022-04-25 17:45:20\",\"customerId\":null,\"data\":null,\"net\":\"taobao\",\"parterId\":\"1746****72\",\"partnerKey\":\"6200c075bf42ab***********35df1746080372\"}"
}

2.3 返回结果

返回结果示例

{  
    "result": true,
    "returnCode": "200",
    "message": "成功" 
}

2.4 回调响应报文

其他信息快递100会忽略。

三、第三方平台网点&面单余额接口

通过第三方平台账号授权接口提交的授权成功后，通过该接口可以获取到该授权账户对应的绑定网点信息以及账户可用单量。

3.1 接口格式

提供统一格式的HTTP POST,并返回统一格式JSON数据。

3.2 请求地址

http://poll.kuaidi100.com/eorderapi.do

请求参数：

param数据结构：

3.3 返回结果

data数据结构

BranchAccount数据结构

3.4 提供数据内容

{
    "result": true,
    "message": "成功",
    "status": "200",
    "data": [
        {
            "kuaidicom": "shentong",
            "comName": "申通",
            "branchAccounts": [
                {
                    "branchCode": "00001",
                    "branchName": "辽宁**市场部一部",
                    "quantity": 268,
                    "tbNet": "辽宁**市场部一部, 00001"
                },
                {
                    "branchCode": "00005",
                    "branchName": "辽宁**市场部七部",
                    "quantity": 18875,
                    "tbNet": "辽宁**市场部七部, 00005"
                }
            ]
        }
    ]
}

3.5 返回信息代码含义