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;

请求参数

  必选 类型及范围 说明
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."
}

关于错误返回值与错误代码,参见 错误代码说明

字段说明

其他



Language: [[{{{2/uri}}}|中文]]


文档更新时间: 2013-05-31