旅行プラットフォーム向けバッテリーコンプライアンス API。

公開 verifier エンドポイントはアカウントなしでテストできます。Partner key は上限、許可 origin、サポート条件だけを変更し、判定契約は変更しません。

curl -s https://certiwatt.app/api/verify \
  -H 'content-type: application/json' \
  -d '{
    "model_id": "anker-737",
    "ccc_mark": "present",
    "trip": {
      "origin": "CN",
      "destination": "CN",
      "airline": "CA",
      "compartment_intent": "carry_on"
    },
    "options": { "language": "en" }
  }'

エンドポイント

POST /api/verify

Auth

匿名呼び出しを受け付けます。Partner traffic は発行済みの x-certiwatt-key または Authorization: Bearer を使います。

Rate limit

公開 traffic は rate limit され、429 と Retry-After を返します。Partner limit は key と一緒に発行されます。

Contract

OpenAPI contract: /openapi.yaml

{
  "verdict": "conditional",
  "verdict_id": "vdt_01JZ8EXAMPLETRIP00000001",
  "ruleset_version": "2026-05-15",
  "generated_at": "2026-06-06T08:40:12.000Z",
  "expires_at": "2026-06-13T08:40:12.000Z",
  "summary": "Carry-on only. Airline approval may be required.",
  "device_resolved": {
    "model_id": "anker-737",
    "brand": "Anker",
    "model_name": "737 Power Bank",
    "watt_hour": 86.4,
    "recall_status": "not_affected",
    "recall_check_method": "model_match"
  },
  "constraints": [
    { "code": "carry_on_only", "message": "Carry-on only — never in checked baggage." },
    { "code": "max_units_2", "message": "Maximum 2 power banks per passenger." }
  ],
  "warnings": [
    { "code": "airline_approval_review", "severity": "advisory", "message": "Confirm airline handling before departure." }
  ],
  "citations": [
    { "kind": "regulator", "authority": "CAAC", "jurisdiction": "CN", "url": "https://...", "pulled_at": "2026-05-29" },
    { "kind": "airline", "authority": "Singapore Airlines", "jurisdiction": "SG", "url": "https://...", "pulled_at": "2026-05-29" }
  ],
  "verdict_path": ["iata_spare_lithium_battery", "cn_3c_screening", "sq_power_bank_policy"]
}

製品フローで単一路線ではなく旅程全体の判定が必要な場合は POST /api/trips/verify を使います。CertiWatt は origin、transit、destination をセグメント別 verdict に展開し、埋め込みワークフロー向けの aggregate verdict を返します。

POST /api/trips/verify

{
  "device": { "model_id": "anker-737" },
  "trip": {
    "origin": "CN",
    "transit": ["SG"],
    "destination": "US",
    "airline": "SQ",
    "compartment_intent": "carry_on"
  },
  "options": { "language": "en" }
}

{
  "public_name": "Trip Battery Pass",
  "trip_verdict_id": "trip_lx5t9d3a_q8z1r2p4",
  "verdict": "conditional",
  "summary": "Trip requires conditions or approval on at least one of 2 segments.",
  "segments": [
    {
      "index": 1,
      "origin": "CN",
      "destination": "SG",
      "airline": "SQ",
      "verdict": { "verdict": "conditional", "ruleset_version": "2026-05-15", "verdict_id": "vdt_..." }
    },
    {
      "index": 2,
      "origin": "SG",
      "destination": "US",
      "airline": "SQ",
      "verdict": { "verdict": "allowed", "ruleset_version": "2026-05-15", "verdict_id": "vdt_..." }
    }
  ],
  "device_resolved": { "model_id": "anker-737", "watt_hour": 86.4 },
  "citation_count": 4,
  "ruleset_version": "2026-05-15",
  "generated_at": "2026-06-06T08:40:12.000Z",
  "expires_at": "2026-06-13T08:40:12.000Z"
}

verdict

allowed、conditional、banned、insufficient のいずれか。

verdict_id

サポートとパートナーログ用の安定した監査ハンドル。

ruleset_version

回答に使われたルールコーパス。公開 API は現在の ruleset_version のみを受け付け、未対応の pin は 400 を返します。

citations

規制当局、航空会社、メーカー、リコール根拠への出典リンク。

conditions

持ち込み、承認、数量、ラベル、認証、リコール制約。

Public answers can summarize policy. Platform integrations need freshness, request preservation, source-change visibility, and reviewable evidence for support and operations.

Freshness window

Verdicts carry generated_at and expires_at; source monitoring keeps regulator, airline, manufacturer, and recall evidence reviewable.

Audit trail

パートナーは verdict_id、request payload、ruleset_version、citations を保存し、サポートレビューと audit export に使用できます。未対応の historical ruleset pin は明示的な 400 を返します。

Change intelligence

Partner policy-change access exposes change history, source-watch rows, fingerprints, and review queue signals.

Serial responsibility

Pattern-backed recalls resolve locally; manufacturer-list recalls return external_list_required and an official lookup URL instead of guessed clearance.

Pilot scope

レスポンス目標、サポート時間帯、許可 origin、rate limit、escalation path はパートナーパイロット範囲で定めます。

The public API surface is useful for discovery and testing. Partner traffic uses an agreed pilot scope, credential setup, and failure-mode review.

Partner auth

Partner traffic uses issued partner API keys; anonymous public calls do not carry pilot support terms.

Allowed origins

Allowed origins, rate limits, Retry-After behavior, production response targets, and support windows are agreement terms.

Failure modes

conditional, banned, insufficient, MODEL_NOT_FOUND, AIRLINE_NOT_COVERED, external_list_required, 429, 5xx, and stale expires_at cannot be converted into allowed.

Ruleset pins

The public API accepts the current ruleset_version only; historical replay requires the stored request payload and a controlled audit export.

Data boundary

No PII is required by default. Use serial_hash unless signed data-flow terms permit raw serial transit.

これらの公開エンドポイントは OpenAPI 契約で保護されており、エージェントは /developers、/mcp、llms.txt、AEO manifest から発見できます。

POST /api/verify

旅程別バッテリー判定を返します。引用、ルート要因、リコール根拠、航空会社ポリシー文脈、ruleset_version、verdict_id を含みます。Transit stop があるリクエストは POST /api/trips/verify を使用してください。

GET /api/devices

対象モバイルバッテリーモデルを検索します。カタログ発見向けに q、limit、recent をサポートします。

GET /api/devices/[modelId]

標準モデル情報を返します。任意の serial は、適用可能な場合にモデルレベルのリコール serial_evaluation を追加します。

GET /api/devices/[modelId]/recalls

正確なモデルの Battery Recall Intelligence を返し、任意のシリアル評価をサポートします。

GET /api/recalls

モデル別リコール記録を一覧します。model_id、status、serial をサポートします。

GET /api/airlines

Airline Policy Intelligence 記録を一覧します。q、confidence、limit をサポートします。

GET /api/airlines/[code]

匿名リクエストは公開 preview を返し、partner/authenticated リクエストは有効ルール、引用、policy_fields、change_log を返します。

GET /api/policy-changes

匿名リクエストは変更/監視 count を返し、partner/authenticated リクエストは変更履歴、source-watch rows、fingerprints、review queue signals を返します。

GET /api/rules

有効な規制当局および航空会社ルールを検索します。

GET /api/sources

モデルまたはルールの正規化済み引用根拠を返します。

透明性と機械発見のため、CertiWatt は限定的な静的 JSON プレビューだけを公開します。完全な航空会社ポリシー項目、ルールロジック、変更履歴、パートナー向け export は製品/API 面に残します。

{
  "long_tail_verdicts": [
    {
      "route_factors": [
        "capacity check is tied to this exact catalog model",
        "Citation sources: CAAC (regulator, CN, 2026-05-29)"
      ],
      "article_body": "Summary plus route factors. Citation sources: CAAC (regulator, CN, 2026-05-29).",
      "ruleset_version": "2026-05-15",
      "citation_count": 3,
      "sources": [
        { "authority": "CAAC", "url": "https://...", "pulled_at": "2026-05-29" }
      ]
    }
  ]
}