海关企业档案（九维） · 创建任务（异步）

POST

/insight/customs/profile

Last modified:2026-10-26 10:13:41

用 match 返回的 matched_id 拉取九维海关档案。创建时不扣费，completed 后扣约 6 积分；company_id 在海关库不存在时任务直接 failed 且 0 扣费（实测）。轮询方式同 match。

Request

Body Params application/jsonRequired

Example

{
    "company_id": "12345678",
    "role": "exporter",
    "customs_id": null,
    "customs_date": null,
    "options": {
        "shipment_limit": 20
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location 'https://app.trade-wind.co/insight/customs/profile' \
--header 'Content-Type: application/json' \
--data '{
    "company_id": "12345678",
    "role": "exporter",
    "customs_id": null,
    "customs_date": null,
    "options": {
        "shipment_limit": 20
    }
}'

Responses

🟢200

application/json

任务创建成功（结构与 match 创建相同）

Bodyapplication/json

Example

{
    "success": true,
    "request_id": "req_xxx",
    "task_id": "clyyyyyyyy",
    "status": "pending",
    "meta": {
        "billing": {
            "credits_charged": 0,
            "note": "Credits (6) charged when task completes"
        }
    },
    "error": null
}

🟠400ValidationError

🟠401InvalidApiKey

🔴500InternalError

Modified at 2026-10-26 10:13:41

报关主体匹配 · 查询任务（异步轮询）

海关企业档案（九维） · 查询任务（异步轮询）