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 请联系技术人员排除问题