查看指定webhook

1.描述:查看用户指定webhook

2.接口地址:

请求路径:/ws-rest/v1/users/{user-id}/webhooks/{webhook-id}?fields=null

请求头:采用HMAC认证

请求体:

{
}

3.请求方式

GET

4.请求参数说明

a.请求示例

curl -X POST \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--header "Date: Wed, 02 Nov 2016 03:25:54 GMT" \
--header "User-Agent: SignIt RestAPI Client v1.0.0" \
--header "Host: api.signit.cn" \
--header "Authorization:HmacSHA512 a1S0H2-U0-v5I-0586-017-z6D-7B5-K0h-1o0-G0-9923G3Xm:53f7ae4a-937b-4ddc-8872-42dd094d56eb:NCMwvHfZS9ZzB2SgVbRzTuS/N5yDRM8Ak6tRvCavHD5T9nKjydc9ha+Rj48e0YIFC5V9IRtFL8Z1d0hvse7Ulg==" 
}" "http://api.signit.cn/ws-rest/v1/users/1834/webhooks/7"

b.请求字段说明

字段 是否必填 类型 位置 说明
user-id long URL-PATH 用户id
fields String URL-PATH 字段选择(webhookId,createDatetime,updateDatetime,status,webhookName,webhookUrl,event,metadata),默认(webhookId,createDatetime,updateDatetime,status,webhookName,webhookUrl)
filters String URL-PATH 过滤条件(webhookId,createDatetime,updateDatetime,status)组合,eg:filters=active=false
offset int URL-PATH 分页索引偏移量,默认为0
limit int URL-PATH 分页索引个数,默认为20
sortings String URL-PATH 排序(webhookId,createDatetime,updateDatetime)

5.响应参数说明

a.响应示例

  • 响应成功:
    {
      "resultStatusCode": "100700000",
      "resultCode": 0,
      "resultDesc": "webhook操作成功",
      "resultData": {
          "userId": 1834,
          "createDatetime": 1487325636000,
          "updateDatetime": 1487325637000,
          "status": 1,
          "events": [
              "envelopeStart",
              "envelopeCompleted",
              "envelopeReject",
              "envelopeRevoke",
              "envelopeTimeout",
              "envelopeNotify",
              "recipientConfirm",
              "recipientReject"
          ],
          "notifyUrl": {
              "returnUrl": "https://www.baidu.com"
          },
          "webhookId": 7,
          "webhookName": "赵刚",
          "webhookUrl": "http://env.dl.signit.cn/ws-rest/v1/users/123/webhooks"
      }
    }
    
  • 响应失败:
    {
      "resultStatusCode": "100700104",
      "resultCode": 1,
      "resultDesc": "禁止操作当前webhook"
    }
    

b.响应字段说明

字段 是否必填 类型 位置 长度 说明
webhookId long BODY webhookid
webhookName String BODY webhook名
webhookUrl String BODY webhook调用url地址
event array BODY webhook定义的事件,详见webhook事件
notifyUrl Object BODY 回调数据封装
returnUrl string BODY 未实名认证重定向地址
status int BODY 是否启动webhook链接(0:不启动,1:启动)
createDatetime long BODY webhook创建时间
updateDatetime long BODY webhook更新时间
resultStatusCode String BODY 状态码
resultCode int BODY 结果码
resultDesc String BODY 状态描述

results matching ""

    No results matching ""