回调请求 Method | POST |
---|---|
回调请求 Content-Type | 您的回调 URL 需要同时支持如下 2 种 Content-Type
|
回调超时时间 | 5秒,响应时间超过 5 秒则放弃本次回调,并且不会重试。 |
参数 | 类型 | 参数说明 |
---|---|---|
open_appid | string | 授权账号的 appid |
open_code | string | 由猎户星空颁发的回调鉴权暗码,用于接入方在收到回调请求之后识别是猎户星空的合法请求,而不是非猎户星空的非法请求。鉴权暗码长度为 32 字节。鉴权暗码不能透漏给第三方。 |
robot_sn | string | 机器人 sn |
ov_corpid | string | 企业 id |
task_id | string | 任务唯一 id |
task_type | string | 任务类型,请参考 回调任务和事件列表。 |
event_type | string | 任务事件的类型,不同的任务类型会有不同的事件类型,请参考 回调任务和事件列表。 |
task_data | jsonString | 任务附加数据,格式为 json 对象字符串,可能为空串,例如:{"pos_name":"桌号A01"}。不同的任务类型会有不同的附加数据,请参考 回调任务和事件列表。 |
event_data | jsonString | 任务事件附加数据,格式为 json 对象字符串,可能为空串,例如:{"pos_name":"桌号A01"}。不同的任务事件类型会有不同的附加数据,请参考 回调任务和事件列表。 |
curl --location 'https://your_domain.com/your_callback_url' \ --form 'open_appid=test_appid' \ --form 'open_code=b317979b11292276e0a1b49a08953dec' \ --form 'robot_sn=test_sn' \ --form 'ov_corpid=test_ov_corpid' \ --form 'task_id=85b35e3b5fc452a0f7a6d2a60d9edb9b' \ --form 'task_type=meals_deliver_task-deliver' \ --form 'event_type=te_arrived' \ --form 'task_data={"pos_name":"桌号A01"}' \ --form 'event_data={"pos_name":"桌号A01"}'
回调响应 HTTP 状态码 | 200 |
---|
任务类型 task_type | 说明 |
---|---|
meals_deliver_task-deliver | 送餐到桌任务。给任何 1 桌送 1 次餐即为 1 个送餐到桌任务。 |
meals_deliver_task-return | 送餐返程任务。送餐到桌任务完成之后的返程任务即为 1 个送餐返程任务。 |
任务类型 task_type | 任务名称 | 任务事件类型 event_type | 事件说明 |
---|---|---|---|
meals_deliver_task-deliver | 送餐到桌任务 | te__start | 开始执行。请注意此 event_type 包含两个下划线_。 |
te_arrived | 到达目的地。请注意此 event_type 只包含一个下划线_。 | ||
meals_deliver_task-return | 送餐返程任务 | te__start | 开始执行。请注意此 event_type 包含两个下划线_。 |
te__end | 执行结束。请注意此 event_type 包含两个下划线_。 |
各任务类型(task_type)的不同任务事件类型(event_type)下的任务附加数据(task_data)
任务类型 task_type | 任务事件类型 event_type | 任务附加数据 task_data |
---|---|---|
送餐到桌任务 meals_deliver_task-deliver | te__start | 无 |
te_arrived | { "pos_name" : "桌号A01" // 目标点位名称 } |
|
送餐返程任务 meals_deliver_task-return | te__start | { "pos_name" : "桌号A01" // 目标点位名称 } |
te_arrived | 同上 |
各任务类型(task_type)的不同任务事件类型(event_type)下的任务事件附加数据(event_data)
任务类型 task_type | 任务事件类型 event_type | 任务事件附加数据 event_data |
---|---|---|
送餐到桌任务 meals_deliver_task-deliver | te__start | 无 |
te_arrived | { "pos_name" : "桌号A01" // 目标点位名称 } |
|
送餐返程任务 meals_deliver_task-return | te__start | 无 |
te_arrived | { "task_result" : "succ" // 任务执行结果,succ: 成功,skip: 跳过 } |