欧盟 CN 编码迁移 API

API ID 15196

查看欧盟合并命名法(CN)编码从 2026 年到 2027 年的变化:状态、后继编码和人工审核标记。对应关系仅供参考,可能需要人工审核。批量请求最多可接受 10 个编码。

API 文档

端点

请求
服务运行且 CN 数据库可用时返回 ok。适用于运行时间监控;不统计 CN 数据。
Endpoint ID: 40656
GET https://zylalabs.com/api/15196/eu+cn+code+migration+api/40656/service+health+check
输入参数

剩余免费测试请求:3 / 3。

此端点不需要任何输入参数。

API 示例响应
JSON
{
    "status": "ok"
}
服务健康检查 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/15196/eu+cn+code+migration+api/40656/service+health+check' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
描述正在运行的 API 版本、CN 数据上次导入的时间、构建该数据所依据的官方出版物,以及其他端点返回的每种迁移状态的含义
Endpoint ID: 40657
GET https://zylalabs.com/api/15196/eu+cn+code+migration+api/40657/api+status+and+data+sources
输入参数

剩余免费测试请求:3 / 3。

此端点不需要任何输入参数。

API 示例响应
JSON
{
    "api_version": "1.0.0",
    "data": {
        "imported_at": "2026-11-18T17:19:47+00:00",
        "schema_version": 1,
        "available_years": [
            2026,
            2027
        ],
        "transitions": [
            {
                "from_year": 2026,
                "to_year": 2027
            }
        ],
        "correspondence_basis": "derived_from_official_texts",
        "coverage": "All 8-digit CN subheadings of Annex I to Regulation (EEC) No 2658/87 as published for 2026 and 2027. TARIC (10-digit) codes, duty rates and national codes are not covered."
    },
    "status_definitions": {
        "unchanged": "The code exists in both versions with identical official description and parent lines, and no CN code was added or removed in its 6-digit HS subheading.",
        "modified": "The code exists in both versions, but its official description or a parent line changed, or other CN codes were added/removed in the same 6-digit HS subheading, so its scope may have changed. Manual review required.",
        "added": "The code exists only in the target version (new code). Possible predecessor codes are listed.",
        "removed": "The code exists only in the source version and no corresponding code could be identified.",
        "replaced": "The code exists only in the source version and corresponds to exactly one new code, which itself has no other predecessor (one-to-one).",
        "split": "The code exists only in the source version and corresponds to two or more new codes, none of which has another predecessor (one-to-many). Manual review required.",
        "merged": "The code exists only in the source version and its single corresponding code also receives goods from other codes (many-to-one). Manual review required.",
        "ambiguous": "The code exists only in the source version and its correspondence is many-to-many; all candidate codes are returned. Manual review required.",
        "unknown": "The code is well formed but is not a CN code in either version covered by this API."
    },
    "correspondence_basis_definitions": {
        "official_correspondence_table": "Pair listed in an official EU correspondence table (Eurostat).",
        "derived_same_hs6_new_codes": "Derived from the two official annexes: the code was deleted and the candidate was created within the same 6-digit HS subheading (HS subheadings are identical in CN 2026 and CN 2027, so goods cannot move to another HS subheading).",
        "derived_same_hs6_retained_codes": "Derived from the two official annexes: no new code exists in the same 6-digit HS subheading, so the candidate is an existing code of that subheading."
    },
    "sources": [
        {
            "role": "cn_annex_2026",
            "title": "Commission Implementing Regulation (EU) 2025/1926, Annex I (Combined Nomenclature 2026), Formex 4 XML, English",
            "publisher": "Publications Office of the European Union (EUR-Lex / Cellar)",
            "url": "http://publications.europa.eu/resource/cellar/c3c0d050-b5fa-11f0-b37f-01aa75ed71a1.0006.02/DOC_1",
            "license": "© European Union. Reuse authorised under Commission Decision 2011/833/EU (commercial and non-commercial reuse permitted, source must be acknowledged, changes must be indicated).",
            "sha256": "23324fedd02019fdff810db0f7fd3e42ff11300e7b5eeec4fe8be75ba0f7bd12",
            "retrieved_at": "2026-11-18T17:19:41+00:00",
            "used_for": "Complete list of CN 2026 8-digit codes, official descriptions, hierarchy, supplementary units",
            "modifications": "Extracted the 'Schedule of customs duties' tables; dashes converted to depth; duty rates not used."
        },
        {
            "role": "cn_annex_2027",
            "title": "Commission Implementing Regulation (EU) 2026/2163, Annex I (Combined Nomenclature 2027), Formex 4 XML, English",
            "publisher": "Publications Office of the European Union (EUR-Lex / Cellar)",
            "url": "http://publications.europa.eu/resource/cellar/f70de77f-d403-11f1-9458-01aa75ed71a1.0006.02/DOC_1",
            "license": "© European Union. Reuse authorised under Commission Decision 2011/833/EU (commercial and non-commercial reuse permitted, source must be acknowledged, changes must be indicated).",
            "sha256": "f99ae077f81f795d9a29e749ea5e5d5979ea2a4af6b24f726c3945d96c47760e",
            "retrieved_at": "2026-11-18T17:19:41+00:00",
            "used_for": "Complete list of CN 2027 8-digit codes, official descriptions, hierarchy, supplementary units",
            "modifications": "Extracted the 'Schedule of customs duties' tables; dashes converted to depth; duty rates not used."
        },
        {
            "role": "eurostat_cn_texts",
            "title": "Eurostat Comext CN classification (CN.txt, English)",
            "publisher": "Eurostat",
            "url": "https://ec.europa.eu/eurostat/api/dissemination/files/?sort=1&downfile=comext%2FCOMEXT_METADATA%2FCLASSIFICATIONS_AND_RELATIONS%2FCLASSIFICATIONS%2FENGLISH%2FCN.txt",
            "license": "© European Union, Eurostat. Licensed under CC BY 4.0 (Commission Decision 2011/833/EU).",
            "sha256": "da4703237379350c8f86d8d2922e1bf4553b72d630ba6088bbd5462438bf4dcd",
            "retrieved_at": "2026-11-18T17:19:41+00:00",
            "used_for": "Cross-check of the CN 2026 code list; self-explanatory English texts for CN 2026 codes",
            "modifications": "Filtered to 8-digit codes valid for the whole of 2026; Comext pseudo-codes dropped."
        },
        {
            "role": "eurostat_pred_succ",
            "title": "Eurostat Comext CN8 predecessor/successor relations",
            "publisher": "Eurostat",
            "url": "https://ec.europa.eu/eurostat/api/dissemination/files/?sort=1&downfile=comext%2FCOMEXT_METADATA%2FCLASSIFICATIONS_AND_RELATIONS%2FRELATIONS%2FCN8-PRED-SUCC.txt",
            "license": "© European Union, Eurostat. Licensed under CC BY 4.0 (Commission Decision 2011/833/EU).",
            "sha256": "a5a28c853da4db6a16c4f5f06abbf59d69b9eee468d838842fcd3ecea5db5fba",
            "retrieved_at": "2026-11-18T17:19:41+00:00",
            "used_for": "Official CN 2026 -> CN 2027 correspondences, when Eurostat has published them",
            "modifications": "Filtered to successors valid from 1 January 2027."
        }
    ],
    "attribution": "© European Union. Reuse authorised under Commission Decision 2011/833/EU (commercial and non-commercial reuse permitted, source must be acknowledged, changes must be indicated). © European Union, Eurostat. Licensed under CC BY 4.0 (Commission Decision 2011/833/EU).",
    "disclaimer": "Indicative information derived from official EU publications. Correspondences between CN versions are not legally binding classifications; the classification of specific goods must be confirmed with the official texts, the customs authorities or a Binding Tariff Information decision. Not affiliated with or endorsed by the European Union or any national authority."
}
API 状态和数据源 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/15196/eu+cn+code+migration+api/40657/api+status+and+data+sources' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
列出 API 中可用的 CN 版本(目前为 2026 和 2027),以及其法律依据、《官方公报》参考信息、通过日期、适用期限、8 位代码数量和当前生效的版本
Endpoint ID: 40658
GET https://zylalabs.com/api/15196/eu+cn+code+migration+api/40658/list+cn+versions
输入参数

剩余免费测试请求:3 / 3。

此端点不需要任何输入参数。

API 示例响应
JSON
{
    "versions": [
        {
            "year": 2026,
            "legal_basis": "Commission Implementing Regulation (EU) 2025/1926",
            "celex": "32025R1926",
            "eli": "http://data.europa.eu/eli/reg_impl/2025/1926/oj",
            "official_journal": "OJ L, 2025/1926, 31.10.2025",
            "eur_lex_url": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32025R1926",
            "adopted": "2025-09-22",
            "applies_from": "2026-01-01",
            "applies_to": "2026-12-31",
            "in_force_today": true,
            "cn_code_count": 9791
        },
        {
            "year": 2027,
            "legal_basis": "Commission Implementing Regulation (EU) 2026/2163",
            "celex": "32026R2163",
            "eli": "http://data.europa.eu/eli/reg_impl/2026/2163/oj",
            "official_journal": "OJ L, 2026/2163, 30.10.2026",
            "eur_lex_url": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32026R2163",
            "adopted": "2026-09-17",
            "applies_from": "2027-01-01",
            "applies_to": "2027-12-31",
            "in_force_today": false,
            "cn_code_count": 9809
        }
    ],
    "default_year": 2026
}
列出中文版本 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/15196/eu+cn+code+migration+api/40658/list+cn+versions' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
每年的 CN 编码实际数量,以及 2026 年至 2027 年间的变更数量:新增、删除、拆分、合并、含糊不清和修改的编码,各章的变更数量,以及需要人工审核的编码数量
Endpoint ID: 40659
GET https://zylalabs.com/api/15196/eu+cn+code+migration+api/40659/cn+change+statistics
输入参数

剩余免费测试请求:3 / 3。

此端点不需要任何输入参数。

API 示例响应
JSON
{
    "cn_codes_per_year": {
        "2026": 9791,
        "2027": 9809
    },
    "transitions": [
        {
            "from_year": 2026,
            "to_year": 2027,
            "added_codes": 35,
            "removed_codes": 17,
            "retained_codes": 9774,
            "by_status": {
                "unchanged": 9756,
                "modified": 18,
                "added": 35,
                "removed": 0,
                "replaced": 0,
                "split": 10,
                "merged": 0,
                "ambiguous": 7
            },
            "correspondences": 55,
            "correspondences_by_basis": {
                "derived_same_hs6_new_codes": 55
            },
            "hs_subheadings_with_new_or_deleted_codes": 13,
            "changed_codes_by_chapter": {
                "02": 3,
                "03": 3,
                "39": 6,
                "44": 10,
                "64": 7,
                "72": 5,
                "73": 5,
                "76": 10,
                "84": 1,
                "85": 20
            },
            "manual_review_required": 70
        }
    ]
}
CN 更改统计信息 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/15196/eu+cn+code+migration+api/40659/cn+change+statistics' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
返回指定 CN 版本中 8 位 CN 编码的官方描述、层级、章、品目、HS 子目和补充计量单位,以及该编码有效的版本。编码中的空格和点号将被忽略。
Endpoint ID: 40660
GET https://zylalabs.com/api/15196/eu+cn+code+migration+api/40660/look+up+cn+code
输入参数

查询 CN 代码 — 端点功能

对象 描述
year 可选 CN version year (2026 or 2027). Defaults to the version in force today.
code 必需

剩余免费测试请求:3 / 3。


输入参数

year
API 示例响应
JSON
{
    "code": "02013000",
    "code_formatted": "0201 30 00",
    "year": 2026,
    "valid": true,
    "valid_in_years": [
        2026
    ],
    "version": {
        "legal_basis": "Commission Implementing Regulation (EU) 2025/1926",
        "applies_from": "2026-01-01",
        "applies_to": "2026-12-31",
        "eur_lex_url": "https://eur-lex.europa.eu/legal-content/EN/TXT/?uri=CELEX:32025R1926"
    },
    "description": "Boneless",
    "hierarchy": [
        "Meat of bovine animals, fresh or chilled"
    ],
    "chapter": "02",
    "heading": "0201",
    "hs_subheading": "020130",
    "supplementary_unit": null,
    "eurostat_self_explanatory_text": "Fresh or chilled bovine meat, boneless",
    "disclaimer": "Indicative information derived from official EU publications. Correspondences between CN versions are not legally binding classifications; the classification of specific goods must be confirmed with the official texts, the customs authorities or a Binding Tariff Information decision. Not affiliated with or endorsed by the European Union or any national authority."
}
查询 CN 代码 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/15196/eu+cn+code+migration+api/40660/look+up+cn+code?year=2026&code=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
说明一个 CN 编码在两个版本之间的变化情况:其迁移状态、候选继承或前身编码及其描述,以及应用结果前是否需要人工分类审核
Endpoint ID: 40661
GET https://zylalabs.com/api/15196/eu+cn+code+migration+api/40661/cn+code+migration+2026+to+2027
输入参数

CN编码迁移 2026至2027 — 端点功能

对象 描述
from_year 可选 Source CN version year. Currently only 2026 is supported.
to_year 可选 Target CN version year. Currently only 2027 is supported.
code 必需

剩余免费测试请求:3 / 3。


输入参数

from_year
to_year
API 示例响应
JSON
{
    "code": "02013000",
    "code_formatted": "0201 30 00",
    "from_year": 2026,
    "to_year": 2027,
    "status": "split",
    "status_definition": "The code exists only in the source version and corresponds to two or more new codes, none of which has another predecessor (one-to-many). Manual review required.",
    "valid_in_from_year": true,
    "valid_in_to_year": false,
    "manual_review_required": true,
    "reasons": [
        "correspondence_derived_from_official_texts"
    ],
    "from": {
        "description": "Boneless",
        "hierarchy": [
            "Meat of bovine animals, fresh or chilled"
        ],
        "chapter": "02",
        "heading": "0201",
        "hs_subheading": "020130",
        "supplementary_unit": null,
        "eurostat_self_explanatory_text": "Fresh or chilled bovine meat, boneless"
    },
    "to": null,
    "successor_candidates": [
        {
            "code": "02013010",
            "code_formatted": "0201 30 10",
            "year": 2027,
            "description": "Tenderloin, rib steak, flank steak, sirloin and rump steak",
            "hierarchy": [
                "Meat of bovine animals, fresh or chilled",
                "Boneless"
            ],
            "basis": "derived_same_hs6_new_codes"
        },
        {
            "code": "02013090",
            "code_formatted": "0201 30 90",
            "year": 2027,
            "description": "Other",
            "hierarchy": [
                "Meat of bovine animals, fresh or chilled",
                "Boneless"
            ],
            "basis": "derived_same_hs6_new_codes"
        }
    ],
    "predecessor_candidates": [],
    "other_codes_in_same_hs_subheading": [
        {
            "code": "02013010",
            "status": "added"
        },
        {
            "code": "02013090",
            "status": "added"
        }
    ],
    "disclaimer": "Indicative information derived from official EU publications. Correspondences between CN versions are not legally binding classifications; the classification of specific goods must be confirmed with the official texts, the customs authorities or a Binding Tariff Information decision. Not affiliated with or endorsed by the European Union or any national authority."
}
CN编码迁移 2026至2027 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/15196/eu+cn+code+migration+api/40661/cn+code+migration+2026+to+2027?from_year=2026&to_year=2027&code=Required' --header 'Authorization: Bearer YOUR_API_KEY' 


    
请求
两个版本之间所有变更的 CN 编码分页列表。按变更类型和两位数章筛选,以规划目录迁移或仅审核与您的产品相关的编码。
Endpoint ID: 40662
GET https://zylalabs.com/api/15196/eu+cn+code+migration+api/40662/list+changed+cn+codes
输入参数

列出已更改的 CN 编码 — 端点功能

对象 描述
type 可选 Change type to return: added, removed, replaced, split, merged, ambiguous or modified. Omit for all changes.
chapter 可选 2-digit CN chapter to filter on, e.g. 85 for electrical machinery.
page 可选 Page number of the results, starting at 1.
page_size 可选 Number of items per page, from 1 to 100 (default 50).
from_year 可选 Source CN version year. Currently only 2026 is supported.
to_year 可选 Target CN version year. Currently only 2027 is supported.

剩余免费测试请求:3 / 3。


输入参数

type
chapter
page
page_size
from_year
to_year
API 示例响应
JSON
{
    "from_year": 2026,
    "to_year": 2027,
    "type": "split",
    "chapter": null,
    "page": 1,
    "page_size": 3,
    "total": 10,
    "total_pages": 4,
    "items": [
        {
            "code": "02013000",
            "code_formatted": "0201 30 00",
            "status": "split",
            "presence": "only_in_from",
            "manual_review_required": true,
            "description": "Boneless",
            "hierarchy": [
                "Meat of bovine animals, fresh or chilled"
            ],
            "related_codes": [
                "02013010",
                "02013090"
            ]
        },
        {
            "code": "39076100",
            "code_formatted": "3907 61 00",
            "status": "split",
            "presence": "only_in_from",
            "manual_review_required": true,
            "description": "Having a viscosity number of 78 ml/g or higher",
            "hierarchy": [
                "Polyacetals, other polyethers and epoxide resins, in primary forms; polycarbonates, alkyd resins, polyallyl esters and other polyesters, in primary forms",
                "Poly(ethylene terephthalate)"
            ],
            "related_codes": [
                "39076110",
                "39076190"
            ]
        },
        {
            "code": "39076900",
            "code_formatted": "3907 69 00",
            "status": "split",
            "presence": "only_in_from",
            "manual_review_required": true,
            "description": "Other",
            "hierarchy": [
                "Polyacetals, other polyethers and epoxide resins, in primary forms; polycarbonates, alkyd resins, polyallyl esters and other polyesters, in primary forms",
                "Poly(ethylene terephthalate)"
            ],
            "related_codes": [
                "39076910",
                "39076990"
            ]
        }
    ]
}
列出已更改的 CN 编码 — 代码片段

curl --location --request GET 'https://zylalabs.com/api/15196/eu+cn+code+migration+api/40662/list+changed+cn+codes?type=split&chapter=85&page=1&page_size=50&from_year=2026&to_year=2027' --header 'Authorization: Bearer YOUR_API_KEY' 


    

API 访问密钥和身份验证

注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 欧盟 CN 编码迁移 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。

标头
标头 描述
授权 必需 应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。

无长期承诺。随时升级、降级或取消。

(年度计费可节省 2 个月 🎉)

起价
$10,000/年


  • 自定义数量
  • 自定义速率限制
  • 专业客户支持
  • 实时 API 监控

概览

查看欧盟组合命名法(CN)代码从2026年到2027年的变化:状态、后继代码和人工审核标记。对应关系仅供参考,可能需要人工审核。批量请求最多可接受10个代码

欧盟 CN 编码迁移 API FAQs

欧盟 CN 编码迁移 API 允许用户查看欧盟组合命名法(CN)编码预计如何从 2026 年分类期变更为 2027 年分类期。它提供有关这些变更状态的信息,标明后续编码,并标记可能需要人工审核的编码

该 API 提供 CN 编码的迁移状态、下一分类期对应的后继编码(如适用),以及一个标志,指示是否建议对已识别的对应关系进行人工审核

是的,该 API 支持批量请求。用户可以在单个批量请求中提交最多 10 个 CN 代码,以高效查询其迁移状态

该 API 接受 CN 代码列表或数组作为批量请求的输入。具体结构取决于实际实现,但通常是一个字符串 JSON 数组,其中每个字符串都是一个 CN 代码。

CN 代码通常以字母数字字符串表示。API 要求将这些代码作为字符串数据类型提供。 .

API 响应通常以 JSON 格式返回。对于每个输入的 CN 编码,它将提供迁移状态、后续编码和人工审核标志等详细信息

“status”字段表示 CN 编码迁移检查的结果。这可能包括“已迁移”“无变化”“已停用”或与分类周期之间转换相关的其他状态信息。

“successor_code”字段提供了新的 CN 编码,预计将在后续分类期(例如,从 2026 年查询时为 2027 年)取代输入编码。如果没有直接的后继编码或该编码已停用,此字段可能为 null 或缺失

“manual_review_flag”是一个布尔值或指示标志,用于表明自动确定的新旧 CN 编码对应关系是否需要进一步人工核验。“true”或“yes”表示由于可能存在复杂情况或歧义,建议进行人工审核

从事国际贸易的企业可以使用此 API 主动识别其现有的 CN 编码将如何变化。这使他们能够提前更新产品分类、海关申报和内部系统,确保合规并避免延误

核心价值主张是让企业清晰预见欧盟合并命名法编码即将发生的变化,从而顺利管理过渡、保持合规并优化贸易运营

不,API 明确说明这些对应关系仅供参考。“manual_review_flag”标记表明,某些转换可能需要专家人工判断,以确保分类正确

单次查询有助于快速核实特定产品 CN 编码的迁移状态,例如在推出新产品或对某个具体分类存疑时

可通过使用海关管理系统中的 CN 编码列表调用 API 端点来集成该 API 返回的迁移数据随后可用于更新产品主数据标记需要审核的商品或自动更新分类

批量请求功能显著提升了效率,用户可以同时查询多个 CN 编码,从而减少 API 调用次数和处理时间,这对于大型产品目录至关重要

根据描述,该 API 专门关注从 2026 年到 2027 年的过渡。它似乎不提供其他时期的历史迁移数据】【。

单个查询响应通常是一个 JSON 对象,其中包含诸如“original_code”“migration_status”“successor_code”和“manual_review_flag”等字段,用于表示查询的代码

通过提前通知 CN 编码变更并指出需要人工审核的潜在问题,该 API 可帮助企业确保其分类符合最新的欧盟贸易法规并保持最新状态

对于报关行而言,“manual_review_flag”起到预警系统的作用。它会将其注意力引向特定的、并非一目了然的 CN 编码转换,这些转换需要他们凭借专业知识确认正确的分类,从而降低出错和受罚的风险

所提供的 API 描述侧重于迁移结果(状态、后继项、审核标记),而非变更背后的原因。具体代码变更的详细说明可能需要查阅欧盟官方关税出版物

当 API 服务正在运行且 CN 数据库可用时,它会返回一个小型 JSON 对象,例如 `{"status":"ok"}`。此端点用于运行监控,不会返回 CN 编码、迁移结果或分类数据

它返回 API 版本、数据导入元数据、架构版本、可用的 CN 年份、支持的转换、对应关系依据、覆盖范围说明以及迁移状态的定义。使用它来解读响应字段,并确认哪些数据集和转换可用

覆盖范围包括《第2658/87号条例(EEC)》附件一中已发布的2026年和2027年版本所列的所有8位CN子目。答复可包含描述、层级、章、品目、HS子目、补充单位以及按年份划分的有效性。不包括TARIC代码、关税税率和国家代码。

它返回一个 JSON 数组,用于描述每个可用的中文版本。每个项目可能包含年份、法律依据、CELEX 和 ELI 标识符、《官方公报》参考信息、EUR-Lex 网址、通过日期、适用期限、代码数量以及该版本当前是否有效

迁移响应标明源年份和目标年份、状态、状态定义、在各年份的有效性、人工审核标记、原因,以及源分类和目标分类的详细信息。对于非直接变更,`successor_candidates`或前置候选项可能会列出相关代码及其描述。

状态包括 `unchanged`、`modified`、`added`、`removed`、`replaced`、`split`、`merged` 和 `ambiguous`。它们的确切含义由 API Status 端点提供。例如,`split` 表示一个源代码对应多个新代码,需要人工审核】【。

请求可以指定源年份、目标年份、变更 `type`、两位数的 `chapter`、`page` 和 `page_size`。响应包含已应用的筛选条件、分页信息、总数、总页数,以及一个包含变更代码、状态、是否存在、描述和相关代码的 `items` 数组

CN 编码是 8 位数值,可能包含空格或点号;这些分隔符会被忽略。响应会同时提供紧凑格式的 `code` 和格式化的 `code_formatted` 值。查询还会报告 `valid` 和 `valid_in_years`,使客户端能够区分无效编码与仅在另一个 CN 版本中有效的编码

一般常见问题

Zyla API Hub 就像一个大型 API 商店,您可以在一个地方找到数千个 API。我们还为所有 API 提供专门支持和实时监控。注册后,您可以选择要使用的 API。请记住,每个 API 都需要自己的订阅。但如果您订阅多个 API,您将为所有这些 API 使用相同的密钥,使事情变得更简单。
价格以 USD(美元)、EUR(欧元)、CAD(加元)、AUD(澳元)和 GBP(英镑)列出。我们接受所有主要的借记卡和信用卡。我们的支付系统使用最新的安全技术,由 Stripe 提供支持,Stripe 是世界上最可靠的支付公司之一。如果您在使用卡片付款时遇到任何问题,请通过 [email protected]

此外,如果您已经以这些货币中的任何一种(USD、EUR、CAD、AUD、GBP)拥有有效订阅,该货币将保留用于后续订阅。只要您没有任何有效订阅,您可以随时更改货币。
定价页面上显示的本地货币基于您 IP 地址的国家/地区,仅供参考。实际价格以 USD(美元)为单位。当您付款时,即使您在我们的网站上看到以本地货币显示的等值金额,您的卡片对账单上也会以美元显示费用。这意味着您不能直接使用本地货币付款。
有时,银行可能会因其欺诈保护设置而拒绝收费。我们建议您首先联系您的银行,检查他们是否阻止了我们的收费。此外,您可以访问账单门户并更改关联的卡片以进行付款。如果这些方法不起作用并且您需要进一步帮助,请通过 [email protected]
价格由月度或年度订阅决定,具体取决于所选计划。
API 调用根据成功请求从您的计划中扣除。每个计划都包含您每月可以进行的特定数量的调用。只有成功的调用(由状态 200 响应指示)才会计入您的总数。这确保失败或不完整的请求不会影响您的月度配额。
Zyla API Hub 采用月度订阅系统。您的计费周期将从您购买付费计划的那一天开始,并在下个月的同一日期续订。因此,如果您想避免未来的费用,请提前取消订阅。
要升级您当前的订阅计划,只需转到 API 的定价页面并选择您要升级到的计划。升级将立即生效,让您立即享受新计划的功能。请注意,您之前计划中的任何剩余调用都不会转移到新计划,因此在升级时请注意这一点。您将被收取新计划的全部金额。
要检查您本月剩余多少 API 调用,请参考响应标头中的 "X-Zyla-API-Calls-Monthly-Remaining" 字段。例如,如果您的计划允许每月 1,000 个请求,而您已使用 100 个,则响应标头中的此字段将显示 900 个剩余调用。
要查看您的计划允许的最大 API 请求数,请检查 "X-Zyla-RateLimit-Limit" 响应标头。例如,如果您的计划包括每月 1,000 个请求,此标头将显示 1,000。
"X-Zyla-RateLimit-Reset" 标头显示您的速率限制重置之前的秒数。这告诉您何时您的请求计数将重新开始。例如,如果它显示 3,600,则意味着还有 3,600 秒直到限制重置。
是的,您可以随时通过访问您的账户并在账单页面上选择取消选项来取消您的计划。请注意,升级、降级和取消会立即生效。此外,取消后,您将不再有权访问该服务,即使您的配额中还有剩余调用。
为了让您有机会在没有任何承诺的情况下体验我们的 API,我们提供 7 天免费试用,允许您免费进行最多 50 次 API 调用。此试用只能使用一次,因此我们建议将其应用于您最感兴趣的 API。虽然我们的大多数 API 都提供免费试用,但有些可能不提供。试用在 7 天后或您进行了 50 次请求后结束,以先发生者为准。如果您在试用期间达到 50 次请求限制,您需要"开始您的付费计划"以继续发出请求。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。或者,如果您在第 7 天之前不取消订阅,您的免费试用将结束,您的计划将自动计费,授予您访问计划中指定的所有 API 调用的权限。请记住这一点以避免不必要的费用。
7 天后,您将被收取试用期间订阅的计划的全额费用。因此,在试用期结束前取消很重要。因忘记及时取消而提出的退款请求不被接受。
当您订阅 API 免费试用时,您可以进行最多 50 次 API 调用。如果您希望超出此限制进行额外的 API 调用,API 将提示您执行"开始您的付费计划"。您可以在个人资料中的订阅 -> 选择您订阅的 API -> 定价标签下找到"开始您的付费计划"按钮。
付款订单在每月 20 日至 30 日之间处理。如果您在 20 日之前提交请求,您的付款将在此时间范围内处理。
您可以通过我们的聊天渠道联系我们以获得即时帮助。我们始终在线,时间为上午 8 点至下午 5 点(EST)。如果您在该时间之后联系我们,我们将尽快回复您。此外,您可以通过 [email protected]

相关 API