Init‐Journey‐Token - nxtele/http-api-document GitHub Wiki
初始化Journey Token
通过API获取Zalo Journey Token
- URL:
https://api.nxcloud.com/v1/zalo/initJourneyToken
- Method:
POST
- Content-Type:
application/json
- 需要鉴权:
是
鉴权机制
鉴权规则请参考地址:API接口调用约定
请求参数
header参数:
参数名 | 类型 | 必选 | 示例值 | 说明 |
---|---|---|---|---|
accessKey | String | 是 | fme2na3kdi3ki | 用户身份标识 |
ts | String | 是 | 1655710885431 | 当前请求的时间戳(单位是毫秒),牛信服务端允许用户端请求最大时间误差为60秒 |
bizType | String | 是 | 9 | Zalo业务类型,取固定值“9” |
action | String | 是 | mt | Zalo业务操作,取固定值“mt” |
sign | String | 是 | 6e9506557d1f289501d333ee2c365826 | API入参参数签名,签名算法 |
body参数:
参数名 | 类型 | 必选 | 示例值 | 说明 |
---|---|---|---|---|
appkey | String | 是 | pem28kje | 应用appkey |
phone | String | 是 | 848xxxx1795 | 消息接收方的zalo号码,需要带国码。如848xxxx1795 |
tokenType | String | 是 | token_logistics_7 | Journey Token 类型: token_logistics_7token_logistics_30token_coach_bus_7token_coach_bus_30 |
请求示例
Journey Token 请求示例
body(application/json) 参数:
{
"appkey": "cWF32dfsa",
"phone": "848xxxx1795",
"tokenType": "token_logistics_7"
}
响应示例
成功示例
{
"code": 0,
"message": "Success",
"data": {
"journeyId": "1257624175686111232",
"token": "HmXFqeO5jM1Mw96XuhlVwR1uQQQAxvu8faW8LtTFhXaHuDrywWweA9Zt5bmFCy0JZOMG_2uo3ZWdRDS1rBeJ7NnOZgiLtw78NzDehSkeEyWJCETRMvHCF-8PVSI16UjNuEMVkAkP21p-xCcMcba7l74cJuouUgZlyW1sMIx1Dm6yu6aKswXaeG3zSCb5mYwJb-AZvxsFd8U1BJhmNQYKPe78TyRz5NphTrX-bI8wF5bOpYDxv4DmkcDDgABP6n6E"
}
}
失败示例
{
"code": -1,
"message": "Failure",
"traceId": "77f8709b545f4fee93fd7f098be9df04"
}
响应码说明
code | message | 解决办法 |
---|---|---|
0 | Success | |
-1 | Failure | 请联系技术人员排除问题 |
1000~100X | Authentication failed | 详情查看API鉴权部分 |
1100 | Customer does not exist / Status is unavailable | 账号状态异常,联系业务人员处理账号问题 |
9000 | Request parameter error | 参数缺失,请检查必须的参数 |
9001 | System business error | 系统业务错误,请联系技术人员排除问题 |
9002 | Phone number error | 非法号码,请检查号码正确性 |
9003 | Customer APP does not exist / Status is unavailable | 应用状态异常,联系业务人员处理云平台应用创建/禁用问题 |
9004 | Customer APP does not have quotation | 应用报价缺失,联系业务人员处理应用报价问题 |
9005 | Missing customer APP routes | 应用路由缺失,请联系技术人员排查路由 |
9010 | Rate limit exceeded | 超过限速 |
17009 | Zalo vendor token does not exist | 供应商Journey Token 报价不存在 |
17010 | Zalo vendor token status is unavailable | 供应商Journey Token报价状态不可用 |
9999 | Unknown error | 请联系技术人员排除问题 |