発酵・食材データを構造化 API で

クイックスタート

1. アカウント登録 / ログイン（ウェイトリスト承認制）
2. /profile/api-keys で Dev キーを発行（無料・self-serve）
3. Authorization ヘッダに Bearer で渡してリクエスト

# 微生物一覧を取得
curl https://hakko.app/api/v1/microbes \
  -H "Authorization: Bearer hakko_live_..."

# スパイスだけ絞り込み
curl "https://hakko.app/api/v1/ingredients?category=spice&limit=20" \
  -H "Authorization: Bearer hakko_live_..."

# 味噌の詳細
curl "https://hakko.app/api/v1/foods?category=fermented_paste" \
  -H "Authorization: Bearer hakko_live_..."

# 今月の利用量
curl https://hakko.app/api/v1/usage \
  -H "Authorization: Bearer hakko_live_..."

認証

すべてのエンドポイントは Bearer トークンが必要です。キーの形式は hakko_live_<32hex>。キーは /profile/api-keys で発行・失効・使用量確認が可能です。

エンドポイント

レスポンス形式

すべてのレスポンスは JSON。一覧エンドポイントは data と pagination、詳細エンドポイントは data のみを返します。

// GET /api/v1/ingredients?category=spice&limit=2 のレスポンス例
{
  "data": [
    {
      "id": "uuid",
      "name": "黒胡椒 テリチェリー TGSEB",
      "name_en": "Black Pepper Tellicherry TGSEB",
      "category": "spice",
      "subcategory": "black_pepper",
      "species": "Piper nigrum",
      "origin_country": "IN",
      "origin_region": "ケーララ州 マラバル海岸",
      "grade": "TGSEB",
      "gi_certification": [],
      "active_compounds": {
        "piperine_pct_range": [5.5, 9.0],
        "essential_oil_pct_range": [2.5, 4.5]
      },
      "properties": { "berry_size_mm_min": 4.75, ... },
      "sources": [ { "type": "spices_board_india", "url": "..." }, ... ],
      "verification_status": "expert_reviewed",
      "license": "Curated (HAKKO internal)"
    },
    ...
  ],
  "pagination": { "limit": 2, "offset": 0, "total": 9 }
}

レート制限

すべてのレスポンスに以下のヘッダが付与されます:

X-RateLimit-Limit: 1000           # プランの月次上限
X-RateLimit-Remaining: 823        # 今月の残り
X-RateLimit-Reset: 2026-05-01T00:00:00Z  # 月次リセット時刻

プラン

Basic / Pro / Enterprise は現在手動請求（月次または年次、請求書払い）。 PoC・データライセンスのご相談は info@hakko.app まで。

データの特性

• 全エントリに 出典（sources jsonb） を付与。学術誌・公的機関・一次文献を明示
• 検証ステータス: unverified / auto_imported / expert_reviewed / published
• 微生物は NCBI Taxonomy / Wikidata Q-ID にリンク、商用利用のライセンス情報あり
• 食材は 産地 × グレード × 活性化合物 を構造化（テリチェリー TGSEB のピペリン濃度レンジ等）
• 諸説あり の記述には明示的に注記（起源年代・発明者伝承など）
• GI 認証（EU PGI/PDO/TSG / 日本 GI / India GI / Morocco IGP 等）を構造化