计算状态推送
本接口只推送计算状态,而不推送数据。
应用场景
计算完成后,模型云会使用此接口通知三方系统,三方系统需要接收处理,并按文档规范返回应答。
注意:
同样的推送可能会多次发送给三方系统,三方系统必须能够正确的处理重复的推送。
数据推送交互时,如果模型云收到三方系统的应答不符合规范或超时,模型云会判定本次推送失败,重新推送数据,直到成功为止(在推送一直不成功的情况下,模型云总共会发起多次推送。推送频率为15s/15s/30s/3m/10m/20m/30m/30m/30m/60m/3h/3h/3h/6h/6h - 总计 24h4m),但模型云不保证推送最终一定能成功。
在计算状态不明或没有收到计算结果的情况下,建议三方系统主动调用模型云获取结果【获取计算结果】。
特别提醒:
- 当收到结果回调时,首先检查对应业务数据的状态,判断该推送是否已经处理过,如果没有处理过再进行处理,如果处理过直接返回成功。在对业务数据进行状态检查和处理之前,要采用数据锁进行并发控制,以避免函数重入造成的数据混乱。
接口链接
该链接是通过【提交模拟计算】中提交的参数cbUrl设置,如果链接无法访问,三方系统将无法接收到模型云通知。
通知url必须为直接可访问的url,不能携带参数。示例:cbUrl:"http://172.10.104.22:8080/api/callback"。
该需要满足restful风格,请求类型为POST。推送参数在Body体内。如下形式:
推送参数
字段名 | 变量名 | 示例值 | 描述 | 位置 |
---|---|---|---|---|
计算任务ID | taskId | 2564 | 计算任务的ID | Body |
计算状态 | status | SUCCESS/FAIL | SUCCESS:成功;FAIL:失败 | Body |
错误消息 | message | 模拟结果与实测流量的数据长度不一致,无法完成计算 | 当status为FAIL时,才会有message | Body |
Request Body 举例如下:
{
"taskId":"2206",
"status": "SUCCESS"
}
返回参数
三方系统需要接收处理,并按以下格式返回应答
字段名 | 变量名 | 必填 | 示例值 | 描述 |
---|---|---|---|---|
返回状态码 | code | 是 | SUCCESS | SUCCESS/FAIL SUCCESS表示三方接收数据成功并校验成功 |
返回信息 | message | 否 | 返回信息,如非空,为错误原因: 签名失败 参数格式校验错误 | |
最后修改时间: 1 年前