# 変更履歴
APIの変更、非推奨化、互換性を壊す変更の履歴。
Source: https://support.toolingmetrics.com/ja/api/changelog/
Updated: 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。