C/2/proxy/wrw/order/taskadd
proxy/wrw/order/taskadd
需求方创建任务。
URL
https://c.api.weibo.com/2/proxy/wrw/order/taskadd.json
支持格式
JSON
HTTP请求方式
POST
是否需要登录
是
关于登录授权,参见 如何登录授权
访问授权限制
请求所有商业接口:
- 50000次/小时/IP;
- 50000次/小时/IP;
请求参数
必选 | 类型及范围 | 说明 | |
---|---|---|---|
source | false | string | 采用OAuth授权方式不需要此参数,其他授权方式为必填参数,数值为应用的AppKey。 |
access_token | false | string | 采用OAuth授权方式为必填参数,其他授权方式不需要此参数,OAuth授权后获得。 |
bid | true | int | 第三方在微任务注册的标识ID。 |
taskname | true | string | 任务名称。 |
version | true | string | 网关版本号,固定值:v1.0。注意为小写字母。 |
type | true | int | 价格类型,1:直发;2:转发;默认无价格限制。 |
demo | false | string | 备注信息。 |
orders | true | string | json序列化后数据,内容如下:[{“uid”:730,“text”:””,“pic”:””,“forwardurl”:””,“forwardtext”:””,“starttime”:””,“boid”:””},...]。uid为资源方在微任务注册的ID。类型为直发时,forwardurl和forwardtext为空。任务开始时间,必须是当前时间半小时之后的时间。 |
timestamp | true | string | 时间戳,格式:yyyymmddhhMMss。 |
ip | false | string | 用户在第三方平台下单时的ip地址,用于风控校验。 |
sign | true | string | 以上所有非空参数及其值与密钥组合,经MD5加密后生成。生成后为大写的32位字符串。例:Strtoupper(MD5(参数1={参数1}&参数2={参数2}&……&参数n={参数n}&key={密钥}))。 |
注意事项
无
返回结果
JSON示例
//成功返回 { “taskid”: 177237, “orders”: { “woids”: [ //微任务生成的订单ID 456, 347, ... ], “boids”: [ //第三方生成的订单ID “tm3847653”, “tb95687845”, ... ] }, “totalfee”: 1245.5 } //失败返回 { "request": "/statuses/bilateral_timeline/ids.json", "error_code": "201XX", "error": "error message." }
关于错误返回值与错误代码,参见 错误代码说明
字段说明
无
其他
无