Skip to content

Async API 异步API对接指南

获取一个异步任务

GET请求

shell
curl https://hub.apiok.us/eapi/async/dispatch/v1?task_type=***
  • task_type 提前定义好的任务类型

返回样例

json
{
    "code": 0,
    "result": {
        "items": [
            {
                "rid": "123",
                "params": {
                    "goods_id": "601099518118140",
                    "country": "us"
                },
                "expiredTS": 1718619453
            }
        ]
    }
}
  • rid 全局唯一的请求id, 在上传的时候需要带上此id
  • params 请求参数
  • expiredTS 任务过期时间, 必须在此之前上传才能成功

上传结果 - 每次1个

POST请求

shell
curl https://hub.apiok.us/eapi/async/upload/v1 \
  -H "Content-Type: application/json" \
  -d '{
    "rid":"123",
    "data":{
        "a":123
    }
  }'
  • rid 取任务的时候获取
  • data 上传的数据,可以是json也可以是字符串,大小不能超过10Mb

返回样例

json
{
    "code": 0
}
  • code 返回0表示成功, 其它任何值都表示失败

Make things simple and timeproof.