主页 > API > 添加个人的Webhook


添加个人的Webhook

/v1/webhook
  • URL

    https://api.worktile.com/v1/webhook

  • HTTP请求方式

    POST

  • 支持格式

    JSON

    Header参数

    {
       "Content-Type":"application/json",
       "access_token":"xxx"
    }
    

    示例

    curl -d 'name=名称&web_hook_url=http://webhook.com/webhook' 'https://api.worktile.com/v1/webhook?access_token=xxx' 
    
  • HTTP请求参数

    参数 必选 类型 说明
    access_token true string OAuth授权后获得,请求时可放在header中
    name true string Webhook名称
    web_hook_url true string Webhook的url
  • 返回数据

    示例

    HTTP/1.1 200 ok

    { "wid":"xafdfasdf", "pid":"eda54f766b7f457ea7cdb5a93c6d892e", "uid":"890a7e8dc3e24b87ac376ffa82a75460", "name":"名称", "web_hook_url":"http://webhook.com/webhook", "created_at":"2015-03-23T09:43:42.863Z", "updated_at":"2015-03-23T09:43:42.863Z", "actions":[ ], "is_every":0, "type":1 }


    返回值字段 类型 说明
    wid string Webhook的wid
    pid string 项目pid(个人Webhook,此处为空)
    uid string 设置Webhook的用户uid
    name string Webhook的名称
    web_hook_url string Webhook的url
    created_at string 创建时间
    updated_at string 更新时间
    actions array (个人Webhook,此处结果无意义)
    is_every number (个人Webhook,此处结果无意义)
    type number 类型:1:代表个人,0:代表项目
  • 异常结果

    示例

    HTTP/1.1 400 Bad Request

    { "error_code":130001, "error_message":"webhook url 不能为空", "request":"/v1/webhook" }


    错误码(error_code) 错误信息(error_message) http状态码(statusCode)
    100005 没授权,请授权后再操作 401
    100006 access_token不正确 400
    130001 webhook url 不能为空 400
    130002 添加webhook失败 500