変更履歴

APIの変更、非推奨化、互換性を壊す変更の履歴。

更新日: 2026年10月23日

非推奨化の方針

互換性を壊す変更は、適用の少なくとも60日前に告知します。項目の削除、型の変更、エンドポイントの削除、認証動作の変更など、既存連携のコード修正が必要になる変更を指します。

新しい項目、エンドポイント、任意パラメータの追加など、互換性を壊さない変更は予告なく行う場合があります。

2026年

2026年10月

修正 — プロジェクトの承認（リリース済みのプロジェクトへの"status": "approved"のPATCH）には、Webアプリでの承認と同じく、プロジェクトに加えて在庫品目を変更する権限がキーのユーザーに必要になりました。承認はプロジェクトの工具アセンブリのカタログ品を、プロジェクトの作成者の在庫品目としてコピーするため、キーのユーザーはその在庫品目を作成し、既存の在庫品目を更新できる必要があります。この権限のないキーには"You are not authorized to perform this action"とともに401 Unauthorizedを返し、プロジェクトはリリース済みのまま、在庫品目は作成されません。これまでは承認され、在庫品目が作成されていました。Webアプリが拒否している書き込みを閉じる修正のため、60日前の告知なしに適用します。

修正 — 部品の作成または更新（部品のPOSTまたはPATCH）で送ったdrawingを、部品の2D図面として保存するようになりました。これまでは図面をpicture項目から読み取っていたため、両方を送ると図面に写真のバイト列が入り、drawingだけを送ると失敗していました。項目、型、応答に変更はないため、pictureやmodelだけを送る連携には影響ありません。

修正 — 別の組織の材料のmaterial_idで部品を作成または更新すると（部品のPOSTまたはPATCH）、material_idのエラーとともに422 Unprocessable Entityを返すようになりました。これまでは、その材料のまま部品を保存していました。部品に使えるのは組織自身の材料か共有の材料で、Webアプリの部品フォームも同じく求めるようになりました。

修正 — 1件のレコードを扱うリクエスト（プロジェクト、部品、機械のGET、PATCH、DELETE、機械のtool_crib、GET /tool_assemblies/:id）は、URLで指定した組織の中だけでレコードを検索するようになりました。別の組織のレコードには、このドキュメントの記載どおり、存在しないIDと同じ本文で404 Not Foundを返します。これまでは、キーのユーザーがそのレコードの組織で権限を持っていれば、読み取り、変更、削除ができていました。Fusion用のプラグインは常にレコード自身の組織を指定するため、影響はありません。APIをドキュメントに合わせ、別の組織のアドレスを通じた組織をまたぐ読み書きを閉じる修正のため、60日前の告知なしに適用します。

修正 — GET /tool_assemblies/:idは、存在しない工具アセンブリIDに、加工部品、プロジェクト、機械と同じく単数形のerrorキーで404 Not Foundを返すようになりました。これまでは500 Internal Server Errorを返していました。

修正 — キーのユーザーが承認されていない組織のデータを、そのキーで読み取ったり変更したりすることはできなくなりました。対象は、組織への参加を申請して管理者の承認を待っているユーザー、招待をまだ承諾していないユーザー、管理者に利用を停止されたユーザーです。そのユーザーがその組織で所属するグループの権限にかかわらず、その組織のすべてのエンドポイント（プロジェクト、部品、機械、材料、工具アセンブリ）は、キーの所有者に権限がないほかの操作と同じく、401 Unauthorizedと"You are not authorized to perform this action"を返します。Webアプリは、このようなユーザーをすでにアクセス申請ページへ案内しています。Fusion用の工具ライブラリのエクスポート（GET /tool_library/fusion）も、このようなキーと、組織の工具アセンブリを一覧表示する権限がないユーザーのキーなど、拒否するほかのキーに、同じ401 Unauthorizedを返すようになりました。これまでは、ライブラリの代わりにerrorオブジェクトを200 OKで返していました。存在しない組織IDにも同じ本文で同じ401を返します。組織のほかのすべてのエンドポイントも同じです。一覧、検索、作成はこれまで404 Not Foundを返していました。IDでレコードを指定するエンドポイントは、キーが届かない組織には、レコードを探す前にこの401を返すようになりました。どのエンドポイントからも、どの組織IDが存在するかを知ることはできなくなりました。エクスポートで組み立てられない工具アセンブリは、これまでどおりライブラリから除き、そのユーザーに通知します。それらを除いてもエクスポートを組み立てられない場合は、理由をerrorsに入れて422 Unprocessable Entityを返し、それ以外の失敗では"The tool library export failed"とともに500 Internal Server Errorを返します。どちらも、これまではerrorオブジェクトを200 OKで返していました。200 OKで返すのは、ライブラリか、対応していないベンダーやエクスポートするものがない組織の場合のnullです。Webアプリがすでに拒否していたアクセスを閉じ、どの組織IDが存在するかを知らせないようにし、エクスポートの拒否と失敗をエラーステータスで返す修正のため、60日前の告知なしに適用します。組織の有効なメンバー、またはそのサイトのオーナーのキーはこれまでどおり応答します。GET /organizationsは、以前からキーのユーザーが有効なメンバーである組織だけを返しています。

修正 — Fusion用の工具ライブラリのエクスポート（GET /tool_library/fusion）で、ねじ切り工具のminimum-thread-pitchとmaximum-thread-pitchを、これまでの文字列ではなく、Fusionの工具ライブラリ形式が定める数値で出力するようになりました。エクスポートをFusionの形式に合わせる修正で、互換性を壊す変更には当たらないため、60日前の告知なしに適用します。ピッチの範囲を1インチあたりの山数でしか持たないねじ切りフライスやねじ切りインサートにも、この2項目をmm単位で出力します。自身のピッチ範囲に使える端が片方しかないねじ切りフライスやねじ切りインサートは、その端だけを文字列で出力することはなくなり、範囲を1インチあたりの山数から丸ごと求めるか、どちらの項目も出力しません。

修正 — 同じエクスポートで、タップのtypeがねじの向きを表すようになりました。左ねじのタップはtap left hand、それ以外のタップは、向きのコードを持たないものも含めてtap right handです。これまでは、右ねじのタップ以外はすべてtapでした。

修正 — 同じエクスポートで、読み取れないデータを持つ工具があっても、エクスポート全体が失敗してライブラリの代わりにエラーを返すことはなくなりました。有限の数値として読めないプロパティ（1e400や、小数点にカンマを使った11,5など）はその工具から除き、工具はそのプロパティなしで出力します。数値として読めない刃数（NT、NOF）も除きます。これまでは0として出力していました。1インチあたりの山数が無限大になるほど小さいねじピッチ（1e-320 mmなど）は、ピッチ0と同じく使えないものとして扱い、工具は1インチあたりの山数からTPを求めるか、TPなしで出力します。エクスポートで組み立てられない工具はライブラリから除き、残りのライブラリを出力します。対象は、アセンブリが工具アイテムをちょうど1つ持たない工具、インサート形状から刃先角が分からない旋削ホルダ、インサートをちょうど1つ保持していない旋削・溝入れ・ねじ切りホルダ、およびエクスポートが想定していないエラーを起こすデータを持つ工具です（このエラーは当社に報告されます）。エクスポートを実行したユーザー（APIキーのユーザー）には、除いた工具と、工具から除いたプロパティ、プリセット、インサートを、その理由とともにToolingMetricsの通知でお知らせします。コーナ半径を読み取れない旋削インサートは、溝入れインサートや回転工具と同じくRE 0を持つようになりました。

追加 — 同じエクスポートで、切削条件のプリセットに、Fusionの工具ライブラリ形式が求める送りの項目を追加しました。スポットドリル、センタードリル、カウンターシンクのプリセットは、v_f_plungeに加えてuse-feed-per-revolution（false）とv_f_retractを持ちます。すべてのフライス加工のプリセットと、ボーリングバー、カウンターボア、スポットドリル、センタードリル、カウンターシンクのプリセットは、v_fと同じ値のv_f_transitionを持ちます。プリセットのf_nは、丸めたv_fを丸めたnで割った値ではなく、丸める前のv_fを丸める前のnで割った、正確な1回転あたりの送りになりました。刃数2のドリルを1刃あたり0.1 mmで送る場合、0.200126ではなく0.2 mmです。削除される項目や型が変わる項目はありません。

追加 — 同じエクスポートで、すべてのフライス加工のプリセットが、Fusionの工具ライブラリ形式が求めるramp-angleを持つようになりました。切削データ自体はランプ角を持たないため、Autodeskのサンプルライブラリと同じ2度です。ねじ切りインサート、またはクラスがプロファイル角（PNA）を挙げているねじ切りフライスが自身のPNAを持つ場合は、それをthread-profile-angleとして出力するようになりました。これまでは、フランク角やねじの種類から求められる場合にだけ出力し、その場合も自身の値より優先していました。削除される項目や型が変わる項目はありません。

2024年

2024年12月

追加 — APIトークンは、別の個人用アクセストークンの手順ではなく、プロフィール → APIトークンで作成・取消しを行い、自分のアカウントに関連付けます。

2024年9月

追加 — GET /machines/:id/tool_cribは、機械に現在装着されているセット工具を、工具アセンブリごとにまとめて返すエンドポイントです。

追加 — tool_assembliesのレスポンスに、ネストしたcutting_data配列が追加されました。

2024年3月

初回リリース — 組織、機械、加工部品、プロジェクト、工具アセンブリのエンドポイントを持つv1 API。