C/2/proxy/wrw/order/taskadd
(以“{{Api_desc_business| uri=proxy/wrw/order/taskadd| desc=需求方创建任务。| httpMethod=POST| needAuth=是| rateLimit={{B_rate_limit}}| params={{api_args|bid|tru...”为内容创建页面) |
|||
第10行: | 第10行: | ||
{{api_args|type|true|int|价格类型,1:直发;2:转发;默认无价格限制。}} | {{api_args|type|true|int|价格类型,1:直发;2:转发;默认无价格限制。}} | ||
{{api_args|demo|false|string|备注信息。}} | {{api_args|demo|false|string|备注信息。}} | ||
− | {{api_args|orders|true|string|json序列化后数据,内容如下:[{“uid”:730,“text”:””,“pic”:””,“forwardurl”:””,“forwardtext”:””,“starttime”:””},...]。uid为资源方在微任务注册的ID。类型为直发时,forwardurl和forwardtext为空。任务开始时间,必须是当前时间半小时之后的时间。}} | + | {{api_args|orders|true|string|json序列化后数据,内容如下:[{“uid”:730,“text”:””,“pic”:””,“forwardurl”:””,“forwardtext”:””,“starttime”:””,“boid”:””},...]。uid为资源方在微任务注册的ID。类型为直发时,forwardurl和forwardtext为空。任务开始时间,必须是当前时间半小时之后的时间。}} |
{{api_args|timestamp|true|string|时间戳,格式:yyyymmddhhMMss。}} | {{api_args|timestamp|true|string|时间戳,格式:yyyymmddhhMMss。}} | ||
{{api_args|ip|false|string|用户在第三方平台下单时的ip地址,用于风控校验。}} | {{api_args|ip|false|string|用户在第三方平台下单时的ip地址,用于风控校验。}} |
2013年5月31日 (五) 11:18的最后版本
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." }
关于错误返回值与错误代码,参见 错误代码说明
字段说明
无
其他
无
文档更新时间: 2013-05-31