Catalog

curl -H "Authorization: Bearer hm_sk_..." \
     -H "X-Hermai-Intent: comparing prices on allbirds.com for a shopping agent" \
     "https://api.hermai.ai/v1/catalog/allbirds.com"

{
  "domain": "allbirds.com",
  "session_id": "abc123...",
  "endpoints": [
    {
      "name": "shopify_products",
      "method": "GET",
      "url": "https://www.allbirds.com/products.json",
      "description": "Shopify store product catalog",
      "params": []
    },
    {
      "name": "add_to_cart",
      "method": "POST",
      "url": "https://www.allbirds.com/cart/add.js",
      "headers": { "Content-Type": "application/json" },
      "kind": "api_call",
      "description": "Add a product variant to the cart",
      "params": [
        { "name": "id", "source": "body", "required": true },
        { "name": "quantity", "source": "body", "required": true }
      ]
    }
  ]
}

# Query 參數
GET /v1/catalog/allbirds.com?intent=looking+up+product+prices+for+a+comparison+agent

# Header(適合較長的 intent)
X-Hermai-Intent: looking up product prices for a comparison agent

curl "https://api.hermai.ai/v1/categories"

# 列出所有 schema(分頁)
GET /v1/schemas

# 依分類篩選
GET /v1/schemas?category=commerce

# 以網站名稱搜尋
GET /v1/schemas?q=shopify

# 依 trending 或最近認證排序
GET /v1/schemas?sort=trending

# 只顯示已認證
GET /v1/schemas?verified=true

# 取得特定網站最新的 schema 卡片
GET /v1/schemas/allbirds.com

# 版本歷史
GET /v1/schemas/allbirds.com/versions