Container Intelligence API

Parse, validate, normalize, and compute ISO 6346 shipping container identifiers.

原始信息汇总

数据集概述

Container Intelligence API 是一个用于处理 ISO 6346 标准海运集装箱标识符的 REST API，专注于集装箱号码的解析、验证和规范化。该 API 在 RapidAPI 平台上提供，属于物流类别，目前为免费订阅方案。

核心功能

• 单次验证：验证一个完整的集装箱号码（如 MSCU6639870）是否符合 ISO 6346 格式和校验位规则。
• 批量验证：在单次请求中验证最多 100 个集装箱号码。
• 校验位计算：根据有效的 10 位集装箱号前缀（如 MSCU663987）计算期望的校验位。
• 健康检查：确认 API 的服务状态和已部署版本。

关键端点

端点 (Endpoint)	方法 (Method)	请求字段	说明
/validate	POST	container_number	验证单个完整的集装箱号码。
/validate/bulk	POST	container_numbers (数组)	批量验证，最大 100 个，保持输入顺序并保留重复项。
/check-digit	POST	container_number (10位前缀)	计算给定有效前缀的校验位，并返回完整的集装箱号码。
/health	GET	-	轻量级运行状况检查。
/version	GET	-	返回当前已部署的应用版本。

API 行为说明

• 业务无效输入：即使输入不符合规范，通常仍返回 200 OK 状态码，但在响应体中标记 "valid": false，并附带具体的验证错误码（如 CHECK_DIGIT_MISMATCH）。
• 请求格式错误：当请求体结构本身有问题时，会返回请求错误。
• 空字符串：对于请求格式来说是有效的，但业务上会被判定为无效。
• 响应结构：验证响应包含顶级的 meta 字段，用于请求追踪和处理时间测量。

验证响应结构示例 (成功)

API 成功验证一个号码后，会返回一个包含输入值、规范化值、有效性标志、组件（如所有者代码、设备类别、序列号、校验位）、详细的格式和校验位验证结果以及可能的警告的 JSON 对象。

适用人群

该 API 适用于需要处理海运集装箱标识符的物流软件、内部数据验证管道、ERP 集成、海关与合规工具以及运营仪表盘的开发者和团队。

认证方式

在 RapidAPI 上订阅该 API 后，需在请求头中提供以下凭证：

• X-RapidAPI-Key: 你的 RapidAPI 密钥
• X-RapidAPI-Host: container-intelligence-api.p.rapidapi.com