統合を v1 から v2 に移動する
V1 は引き続き利用可能です。準備ができたら、同じキーとクレジット残高を使用して個々の統合を移行します。 V2 はリクエストとレスポンスのコントラクトが異なるため、URL のみを変更するだけでは十分ではありません。
| V1コンセプト | V2相当 |
|---|---|
| 名前、電子メール、ユーザー名の個別のエンドポイント | POST /api/v2/gender と type および value |
| 複数のエンドポイントを分離する | POST /api/v2/gender/batch と items |
| askToAI | options.ai_mode: fallback;単一リクエストはすでにデフォルトで fallback に設定されています |
| forceToGenderize | 3 つのタイプすべてで同じオプションのフィールド。最初にデータセット、次にニックネーム認識 AI |
| フラット応答フィールド | 結果については data。アクセスと請求用の meta |
| probability パーセンテージ | 0 ～ 1 スケールの confidence に confidence_kind を加えたもの。 AI スコアは調整された確率ではありません |
| total_names | data.sample_count、null 可能 |
| used_credits / remaining_credits | meta.usage.charged_credits / remaining_credits |
| レガシーエラー形式 | HTTP ステータスと Problem Details code および action |
| POST が再試行します | 各再試行は通常の課金による新しい操作です |
クライアントを更新して検証する
移行する統合には、v2 リクエストおよびレスポンス コントラクトを使用します。再試行する前に、meta.access.mode を確認し、JSON null の結果を保存し、項目ごとのバッチ エラーを検査し、請求を確認します。クライアントが更新されるまで、v1 統合を既存のパスに保持します。