查询 Webhook 列表

GET 
/openapi/2022-01/webhooks

返回店铺已注册的所有 Webhook 列表。

请求

Query参数

address string

Webhook 通知 URL，例如：https://example.com/webhook。

topic string

Webhook 主题。

created_at_min string

最早创建时间。

created_at_max string

最晚创建时间。

updated_at_min string

最早更新时间。

updated_at_max string

最晚更新时间。

limit int32
Result per page, max: 250
默认值： 50
page int32

Page number

响应

200

200

application/json

数据结构

数据结构

webhooks object[]
Array [
idstring
示例： ea88df20-525b-457b-beed-d49e546be683
addressstring
示例： https://example.com/webhook
topicstring
示例： orders/create
created_atstring
示例： 2018-08-26T06:30:55Z
updated_atstring
示例： 2018-08-26T06:30:55Z
formatstring
示例： json
]

示例

{
  "webhooks": [
    {
      "id": "ea88df20-525b-457b-beed-d49e546be683",
      "address": "https://example.com/webhook",
      "topic": "orders/create",
      "created_at": "2018-08-26T06:30:55Z",
      "updated_at": "2018-08-26T06:30:55Z",
      "format": "json"
    }
  ]
}

Result

{
  "webhooks": [
    {
      "id": "ea88df20-525b-457b-beed-d49e546be683",
      "address": "https://example.com/webhook",
      "topic": "orders/create",
      "created_at": "2018-08-26T06:30:55Z",
      "updated_at": "2018-08-26T06:30:55Z",
      "format": "json"
    },
    {
      "id": "2c3772b4-8a92-4afd-bb7b-d89cd31844c2",
      "address": "https://example.com/webhook",
      "topic": "orders/delete",
      "created_at": "2018-08-26T06:30:55Z",
      "updated_at": "2018-08-26T06:30:55Z",
      "format": "json"
    }
  ]
}

422

422

application/json

数据结构

数据结构

oneOf
• object
• object
errors object
limitstring[]
pagestring[]

示例

{
  "errors": {
    "limit": [
      "must be less than or equal to 250"
    ],
    "page": [
      "must be greater than or equal to 1"
    ]
  }
}

Result

{
  "errors": [
    "Address is invalid",
    "Topic is not allowed, allowed topic are: app/expired,app/uninstalled,cart/create,cart/update,collections/create,collections/delete,collections/update,customers/create,customers/delete,customers/update,fulfillments/create,fulfillments/update,orders/cancelled,orders/create,orders/delete,orders/finished,orders/fulfilled,orders/paid,orders/partially_fulfilled,orders/partially_refunded,orders/refunded,orders/update,procurements/create,procurements/update,products/create,products/delete,products/publish,products/unpublish,products/update,shop/update,stores/subscribe,suppliers/create,suppliers/delete,suppliers/update,themes/create,themes/delete,themes/publish,themes/update"
  ]
}