🔍 单个 HS Code 查询
输入商品品名,AI 自动匹配加拿大 HS Code
搜索加拿大海关税则,为进口到加拿大的任何产品查找 HS Code 和适用税率
Salmonidae, fresh or chilled, excluding fillets, meat, livers and roes
Pacific salmon species, fresh or chilled, whole or in pieces
Sockeye salmon (Oncorhynchus nerka), frozen, excluding fillets
Fresh or chilled fillets and other meat of salmonidae, fresh
Describe your product in natural language — our AI maps it to the correct HS code classification automatically.
View MFN rates, GST, PST, and any applicable preferential tariff treatments (CUSMA, CPTPP, etc.).
Integrate HS code lookup into your own systems with our developer-friendly API. Rate-limited free tier available.
通过 REST API 批量提交 HS Code 查询任务,支持 Webhook 回调通知
https://hscode.proxy.jiayouexp.com/api
API 支持两种鉴权方式:
在请求头中携带 API Key 和 Secret:
X-Api-Key: sk_your_api_key_here
X-Api-Secret: your_secret_here
📌 每个用户最多创建 10 个 API Key。请在「个人中心 - API Keys」中管理。
使用用户登录后的 JWT Token:
Authorization: Bearer eyJhbGciOiJIUzI1NiIs...
/api/api/submit
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| products | array | 是 | 商品品名数组,最多 500 个 |
| webhook_url | string | 否 | 本次任务的回调 URL(可选覆盖) |
curl -X POST https://hscode.proxy.jiayouexp.com/api/api/submit \
-H "X-Api-Key: sk_your_key" \
-H "X-Api-Secret: your_secret" \
-H "Content-Type: application/json" \
-d '{
"products": [
"Fresh Atlantic Salmon",
"Cotton T-shirts",
"Wireless Mouse"
]
}'
{
"code": 0,
"message": "任务已提交,共3条",
"data": {
"batch_no": "BAT20240422123456001",
"total": 3,
"processed": 3,
"paused": 0,
"balance": 47,
"task_ids": [101, 102, 103],
"paused_ids": []
}
}
/api/api/tasks
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| page | int | 否 | 页码,默认 1 |
| limit | int | 否 | 每页数量,默认 20,最大 100 |
| batch_no | string | 否 | 按批次号筛选 |
| status | string | 否 | 按状态筛选:queued/processing/success/failed/paused |
curl "https://hscode.proxy.jiayouexp.com/api/api/tasks?batch_no=BAT20240422123456001" \
-H "X-Api-Key: sk_your_key" \
-H "X-Api-Secret: your_secret"
当任务处理完成后(成功或失败),系统会自动向用户配置的 Webhook URL 发送 HTTP POST 请求。
{
"event": "task.completed",
"task_id": 101,
"batch_no": "BAT20240422123456001",
"type": "api",
"product_name": "Fresh Atlantic Salmon",
"hscode": "0302110000",
"confidence": 0.95,
"status": "success",
"error_msg": null,
"created_at": "2024-04-22 12:34:56",
"finished_at": "2024-04-22 12:34:58"
}
如果 Webhook 配置了 Secret,回调请求头会包含签名:
X-Webhook-Signature: sha256=abc123...
X-Webhook-Timestamp: 1713772496
验证方式:HMAC-SHA256(payload_body, secret)
🔄 回调失败时自动重试,最多重试 3 次:
您的 Webhook 服务应在 10 秒内返回 HTTP 2xx 状态码,否则视为回调失败。
| HTTP 状态码 | 说明 |
|---|---|
| 401 | 鉴权失败(API Key 无效或 Token 过期) |
| 400 | 请求参数错误 |
| 403 | 权限不足(API Key 已禁用) |
| 500 | 服务器内部错误 |
{
"code": -1,
"message": "错误描述",
"data": []
}
Log in to continue using HS Code lookup services
Register to start using HS Code intelligent lookup
AI 驱动的商品品名匹配加拿大 HS Code 服务
输入品名查询 HS Code
上传 Excel 批量处理
查看所有任务和进度
1 元 = 50 积分
输入商品品名,AI 自动匹配加拿大 HS Code
为账户充值积分,用于 HS Code 查询