ドキュメントへの記載が遅れていますが、Design Automation API の利便性向上を目的に、WorkItem 関連の新しい機能が追加されました。GET workitems/:id エンドポイントへの新しいクエリーパラメータと WorkItem ステータスを得る新しいエンドポイントの追加です。
WorkItem IDの取得
既存の GET workitems/:id エンドポイントに新しいクエリーパラメータ startAfterTime が追加されました。startAfterTime パラメータを利用すると、指定した UNIX 時間 以降に起動した WorkItem の ID 一覧を JSON 内の配列で返します。
メソッド：GET
エンドポイント：https://developer.api.autodesk.com/da/us-east/v3/workitems
クエリーパラメータ：startAfterTime=<<UNIX 時間>>
リクエスト ヘッダー：Authorization Bearer <<アクセス トークン>>
- UNIX 時間は、Epoch Converter – Unix Timestamp Converter のようなツールで得ることが出来ます。
- WorkItem のステータスは、WorkItem 完了後、3 日間のみ保持されます。
例：
WorkItem ステータスの取得
複数の WorkItem ID からステータスを得るための新しいエンドポイントです。リクエスボディに WorkItem ID を配列指定すると、レポート URL を含むステータス等の情報が同じく配列で返されます。
メソッド：POST
エンドポイント：https://developer.api.autodesk.com/da/us-east/v3/workitems/status
リクエスト ヘッダー：Authorization Bearer <<アクセス トークン>>
リクエスト ヘッダー：Content-Type application/json
リクエスト ボディ： [“workitem id1″,”workitem id2″,”workitem id3”, …]
- WorkItem のステータスは、WirkItem 完了後、3 日間のみ保持されます。
例：
By Toshiaki Isezaki
Leave a Reply