共通スキーマ
すべての Annie Insights API エンドポイントは、共通のリクエスト パラメーターと応答パターンを共有します。
標準リクエストパラメータ
すべてのイメージベースのエンドポイントには、次の 3 つのパラメータが必要です。
| パラメータ | タイプ | 必須 | 説明 |
|---|---|---|---|
PatientID | 弦 | ✅ はい | システムからの一意の患者 ID |
TimeStamp | 弦 | ✅ はい | 分析セッションのタイムスタンプ (例: "2026-05-24") |
ImageName | 弦 | ✅ はい | 分析する歯科画像への完全な URL |
リクエスト本文の例
{
"PatientID": "P-001",
"TimeStamp": "2026-05-24",
"ImageName": "https://your-storage.com/images/patient-photo.jpg"
}
画像の URL 要件
- 公的にアクセス可能な HTTPS URL である必要があります
- サポートされている形式: JPEG、PNG
- 最大ファイルサイズ: 20MB
- 推奨解像度：1024×768以上
標準応答フィールド
| 分野 | タイプ | 説明 |
|---|---|---|
Version | 弦 | 処理に使用したAPIのバージョン |
PatientID | 弦 | リクエストからエコーされました |
TimeStamp | 弦 | リクエストからエコーされました |
ImageName | 弦 | 処理された画像ファイル名 |
Results | 物体 | エンドポイント固有の分析結果 |
OutputImageUrl | 弦 | 注釈付き画像 URL (SAS 保護、72 時間有効期限) |
オプションのパラメータ
一部のエンドポイントは追加のオプション パラメーターを受け入れます。
| パラメータ | タイプ | 利用可能日 | 説明 |
|---|---|---|---|
StandardName | 弦 | 正面セグメンテーション | 評価基準（デフォルト：「ICON」） |
PlotLabels | ブール値 | 正面セグメンテーション | 出力時に分類ラベルを表示する |
DrawContours | ブール値 | セグメンテーションエンドポイント | 出力に等高線を描画します |