GET
/wc-api/v3/orders/count?_jsonp=ordersCount
```shell
curl https://example.com/wc-api/v3/orders/count?_jsonp=ordersCount \
-u consumer_key:consumer_secret
```
> Response:
```
\**\ordersCount({"count":8})
```
> If the site administrator has chosen to disable it, you will receive a `400 Bad Request` error:
```json
{
"errors": [
{
"code": "woocommerce_api_jsonp_disabled",
"message": "JSONP support is disabled on this site"
}
]
}
```
> If your callback contains invalid characters, you will receive a `400 Bad Request` error:
```json
{
"errors": [
{
"code": "woocommerce_api_jsonp_callback_invalid",
"message": "The JSONP callback function is invalid"
}
]
}
```
## Webhooks ##
Webhooks 可通过 WooCommerce 设置界面或使用 REST API 端点进行管理。`WC_Webhook` 类负责管理自定义文章类型的所有数据存储与检索，以及将 webhook 操作加入队列、处理/发送/记录 webhook。在 `woocommerce_init` 时，会加载活跃的 webhooks 并添加其关联的钩子。
每个 webhook 包含：
* 状态：活跃（发送有效载荷）、暂停（管理员暂停发送）、禁用（因失败暂停发送）
* 主题：决定 webhook 针对哪些资源事件触发
* 发送 URL：接收有效载荷的 URL，必须是 HTTP 或 HTTPS 协议
* 密钥：可选的密钥，用于生成请求正文的 HMAC-SHA256 哈希值，以便接收方验证 webhook 的真实性
* 钩子：为处理 webhook 而添加并绑定的一系列钩子名称数组
### 主题 ###
主题是资源（例如订单）和事件（例如创建）的组合，并映射到一个或多个钩子名称（例如 `woocommerce_checkout_order_processed`）。可以使用主题名称创建 Webhook，相应的钩子会自动添加。
核心主题包括：
* `coupon.created, coupon.updated, coupon.deleted`
* `customer.created, customer.updated, customer.deleted`
* `order.created, order.updated, order.deleted`
* `product.created, product.updated, product.deleted`
也可以使用自定义主题，它们映射到单个钩子名称。例如，您可以添加一个主题为 `action.woocommerce_add_to_cart` 的 Webhook，该 Webhook 将在该事件触发时执行。自定义主题会将第一个钩子参数传递给有效载荷，因此在此示例中，`cart_item_key` 将包含在有效载荷中。
### 交付/负载 ###
交付默认使用 `wp_remote_post()`（HTTP POST）完成，并通过 wp-cron 在后台处理。请求中添加了几个自定义标头，以帮助接收方处理 webhook：
* `X-WC-Webhook-Topic` - 例如 `order.updated`
* `X-WC-Webhook-Resource` - 例如 `order`
* `X-WC-Webhook-Event` - 例如 `updated`
* `X-WC-Webhook-Signature` - 负载的 base64 编码 HMAC-SHA256 哈希值
* `X-WC-Webhook-ID` - webhook 的文章 ID
* `X-WC-Delivery-ID` - 交付日志 ID（一条评论）
负载采用 JSON 编码，对于 API 资源（优惠券、客户、订单、产品），其响应与通过 REST API 请求时完全相同。
### 日志记录 ###
请求/响应以评论形式记录在 webhook 自定义文章类型中。每条投递日志包含：
* 请求时长
* 请求 URL、方法、头部和正文
* 响应代码、消息、头部和正文
为减少评论表膨胀，仅保留最近的 25 条投递日志。
连续 5 次投递失败（定义为非 HTTP 2xx 响应代码）后，webhook 将被禁用，必须通过 REST API 编辑以重新启用。
可通过 REST API 端点或使用 `WC_Webhook::get_delivery_logs()` 代码获取投递日志。
### 端点 ###
[请参阅 Webhook 资源部分](#webhooks7)。
### 可视化界面 ###
您可以通过访问“WooCommerce” > “设置” > “API” > “Webhooks”找到 Webhooks 界面，更多详情请参阅我们的[可视化 Webhooks 文档](https://docs.woocommerce.com/document/webhooks/)。
## 故障排除 ##
* Nginx - 旧版 Nginx 配置可能导致 API 问题，详情参见[此问题](https://github.com/woocommerce/woocommerce/issues/5616#issuecomment-47338737)
* ModSecurity - 启用时可能阻止 `POST`、`PUT` 和 `DELETE` 请求，通常显示 `501 Method Not Implemented` 错误，详情参见[此问题](https://github.com/woocommerce/woocommerce/issues/9838)
## Official Libraries ##
- [Node.js](https://www.npmjs.com/package/woocommerce-api)
- [PHP](https://packagist.org/packages/automattic/woocommerce)
- [Python](https://pypi.python.org/pypi/WooCommerce)
- [Ruby](https://rubygems.org/gems/woocommerce_api)
```javascript
// Install:
// npm install --save woocommerce-api
// Setup:
var WooCommerceAPI = require('woocommerce-api');
var WooCommerce = new WooCommerceAPI({
url: 'http://example.com', // Your store URL
consumerKey: 'consumer_key', // Your consumer key
consumerSecret: 'consumer_secret', // Your consumer secret
version: 'v3' // WooCommerce API version
});
```
```php
'v3' // WooCommerce API version
]
);
?>
```
```python
# Install:
# pip install woocommerce
# Setup:
from woocommerce import API
wcapi = API(
url="http://example.com", # Your store URL
consumer_key="consumer_key", # Your consumer key
consumer_secret="consumer_secret", # Your consumer secret
version="v3" # WooCommerce API version
)
```
```ruby
# Install:
# gem install woocommerce_api
# Setup:
require "woocommerce_api"
woocommerce = WooCommerce::API.new(
"http://example.com", # Your store URL
"consumer_key", # Your consumer key
"consumer_secret", # Your consumer secret
{
version: "v3" # WooCommerce API version
}
)
```