日本国内向けAPI Docs

日本商品販売可否判定API

japan_product_sellability

商品を日本で販売できるか、公的根拠と不足情報を残して一次判定します。

AI Toolの使い分け

使うとき

  • この商品を日本で売れるか知りたい
  • 販売可能・条件付き・確認必要・不可を判定したい
  • 次に確認すべき情報を知りたい

使わないとき

  • 許可・届出を手順別に一覧化する場合
  • 利益だけを計算する場合

推奨Tool Call: japan_product_sellability({"product_name":"Bluetoothスピーカー","category":"Electronics","origin_country":"CN","wireless_function":true})

入力・出力schema

POST /v1/japan/product/sellability

必須入力

  • product_name
  • category

任意入力

  • description、intended_use、materials、原産国、HSコード、無線・電源・食品接触等

返却内容

  • 販売可否4段階
  • 判定理由
  • 関係省庁・法令
  • 不足情報・次アクション・confidence
OpenAPI 3.1 / JSON Schemaを確認

実行例

curl -X POST https://api.japanapistore.com/v1/japan/product/sellability \
  -H "Authorization: Bearer ${JAPAN_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"product_name":"Bluetoothスピーカー","category":"Electronics","origin_country":"CN","wireless_function":true}'

JSONリクエスト

{
  "product_name": "Bluetoothスピーカー",
  "category": "Electronics",
  "origin_country": "CN",
  "wireless_function": true
}

JSONレスポンス

{
  "success": true,
  "data": {
    "judgment": "確認必要",
    "status": "REVIEW_REQUIRED",
    "reason": "技術基準適合証明の確認が必要です。",
    "related_authorities": [
      "MIC",
      "METI"
    ]
  },
  "confidence": 0.92,
  "source": [
    {
      "source_id": "official_source",
      "name": "公的データ",
      "url": null,
      "updated_at": null
    }
  ],
  "updated_at": "2026-09-04T00:00:00.000Z",
  "request_id": "req_0123456789abcdef0123456789abcdef",
  "warnings": []
}

失敗例

{
  "success": false,
  "error": {
    "code": "INVALID_INPUT",
    "message": "入力内容を確認できませんでした。",
    "retryable": false,
    "suggested_action": "必須項目と型をOpenAPIで確認してください。"
  },
  "request_id": "req_0123456789abcdef0123456789abcdef"
}

401、403、429、500、503も同じ機械可読構造で返ります。429と5xxはretryable: trueです。

判定可能範囲・判定不能条件

  • 法的保証ではありません。
  • 商品固有情報が不足する場合は販売可能と推測せず確認必要を返します。

すべての応答でconfidence、source、updated_at、warningsを確認してください。