APIキーはログインユーザーがマイページから発行・失効できます。平文キーは 発行時だけ表示され、サーバにはSHA-256ハッシュとメタデータだけを保存します。 ユーザーごとに環境変数やSecrets Managerを更新する必要はありません。

画面から発行する場合は マイページの「外部APIキー」を使います。APIで発行する場合はAuth0のアクセストークンで ユーザー認証を行います。

curl -X POST "https://drawing-agent.com/api/users/me/api-keys" \
  -H "Authorization: Bearer <Auth0 access token>" \
  -H "Content-Type: application/json" \
  -d '{"label":"Production integration"}'

curl -X DELETE "https://drawing-agent.com/api/users/me/api-keys/{key_id}" \
  -H "Authorization: Bearer <Auth0 access token>"

リクエストでは X-API-Key ヘッダー、またはAuthorization: Bearerでキーを送れます。

curl -X POST "https://drawing-agent.com/api/v1/conversions/takeoff" \
  -H "X-API-Key: da_live_partner-a.xxxxx" \
  -F "file=@drawing.pdf" \
  -F 'target_items=["コンクリート","鉄筋","掘削"]' \
  -F "description=10m当たりの代価数量を拾ってください"

レスポンスは 200 OK で、resultに数量拾い結果を返します。

{
  "id": "00000000-0000-0000-0000-000000000000",
  "status": "completed",
  "result": {
    "schema_version": "quantity_takeoff_v1",
    "structures": [
      {
        "structure_id": "S1",
        "name": "見切壁",
        "items": [
          {
            "item_id": "S1:I1",
            "item_name": "コンクリート",
            "spec": "18-8-25-BB",
            "quantity": 0.675,
            "unit": "m3",
            "formula": "wall_thickness * wall_height * basis_length",
            "computed_quantity": 0.675,
            "calculation_status": "recomputed_from_formula"
          }
        ]
      }
    ],
    "totals_by_item": [
      {
        "item_name": "コンクリート",
        "spec": "18-8-25-BB",
        "quantity": 0.675,
        "unit": "m3",
        "source_item_ids": ["S1:I1"]
      }
    ]
  }
}

curl -X POST "https://drawing-agent.com/api/v1/conversions" \
  -H "X-API-Key: da_live_partner-a.xxxxx" \
  -F "file=@drawing.png" \
  -F "output_formats=glb,stl,step" \
  -F "quality_target=85" \
  -F "max_iterations=6"

レスポンスは 202 Accepted です。

{
  "id": "00000000-0000-0000-0000-000000000000",
  "status": "processing",
  "urls": {
    "status": "/api/v1/conversions/00000000-0000-0000-0000-000000000000",
    "events": "/api/v1/conversions/00000000-0000-0000-0000-000000000000/events"
  },
  "artifacts": {}
}

curl "https://drawing-agent.com/api/v1/conversions/{id}" \
  -H "X-API-Key: da_live_partner-a.xxxxx"

status が completed になると、artifactsに取得用URLが入ります。

{
  "id": "00000000-0000-0000-0000-000000000000",
  "status": "completed",
  "final_score": 91,
  "artifacts": {
    "glb": "/api/v1/conversions/{id}/artifacts/glb",
    "stl": "/api/v1/conversions/{id}/artifacts/stl",
    "step": "/api/v1/conversions/{id}/artifacts/step"
  }
}

curl -L "https://drawing-agent.com/api/v1/conversions/{id}/artifacts/glb" \
  -H "X-API-Key: da_live_partner-a.xxxxx" \
  -o model.glb

• 対応形式は glb, stl, step, ifc, inp です。
• 指定形式が生成されていない場合、取得エンドポイントは 404 を返します。
• 詳細な生成ログが必要な場合だけイベントエンドポイントを使います。

curl "https://drawing-agent.com/api/v1/conversions/{id}/events" \
  -H "X-API-Key: da_live_partner-a.xxxxx"