オートデスクは、WebHooks API で検出したイベントを外部コールバック URL に配信する際の Webhooks API のイベント配信リクエスト ヘッダーの形式に変更を加える予定です。具体的には、既存のヘッダー値の一部を変換します。これらのヘッダー フィールドは以前に公開されておらず、トレースを目的としてで内部のみで使用することを意図しているため、これは便宜上の注意です。
フォーマットの変更は、以下のドキュメント化されていないヘッダーフィールドに影響します。
- x-ads-ul-ctx-tracking-id
- x-ads-ul-ctx-head-span-id
- x-adsk-delivery-id
次の表は、変更前と変更後の違いを示しています。
| 変更前（現在） | 変更後（2025年6月24日～） | |
| x-ads-ul-ctx-tracking-id | httpadapter~autodesk.data.fevnt.example~1-68224086-e98bac01d35d6b918ce393c1 | httpadapter~autodesk.data.fevnt.example~ 5059ff4f452f4a3ebb50677da14869e2 |
| x-ads-ul-ctx-head-span-id | 1-68224086-e98bac01d35d6b918ce393c1 | 50851c1ea26c9cdf |
| x-adsk-delivery-id | httpadapter~autodesk.data.fevnt.example~1-68224086-e98bac01d35d6b918ce393c1/19234e4a-df4f-4fed-9b65-9ed18585727b | httpadapter~autodesk.data.fevnt.example~ 5059ff4f452f4a3ebb50677da14869e2/269e11c4-3c93-4458-ab50-7abecc3df2ec |
必要なアクション
上記のヘッダーフィールドの値に返信する場合は、2025年6月24日 から適用される形式の変更を処理するようにコードを更新をお願いしますい。注: リクエスト自体の配信ボディに変更はありません。API の意図された機能は影響を受けません。
この変更についてご不明な点がございましたら、APS support までお問い合わせください。
※ 本記事は Webhooks API: format changes to the event delivery request headers | Autodesk Platform Services から転写・意訳したものです。
By Toshiaki Isezaki
You must be logged in to post a comment.