Nhật ký thay đổi

Lịch sử thay đổi của API, các mục ngừng hỗ trợ và các thay đổi phá vỡ tương thích.

Cập nhật 23 tháng 10, 2026

Chính sách ngừng hỗ trợ

Các thay đổi phá vỡ tương thích được thông báo ít nhất 60 ngày trước khi có hiệu lực. Thay đổi phá vỡ tương thích là mọi thay đổi buộc các tích hợp hiện có phải cập nhật mã — xóa trường, đổi kiểu của trường, xóa endpoint hoặc thay đổi hành vi xác thực.

Các thay đổi không phá vỡ tương thích (thêm trường mới, endpoint mới, tham số tùy chọn mới) có thể được thực hiện bất cứ lúc nào mà không báo trước.

2026

Tháng 10 năm 2026

Sửa lỗi — Phê duyệt một dự án (PATCH một dự án đã phát hành với "status": "approved") giờ yêu cầu người dùng của khóa có quyền thay đổi hàng hóa bên cạnh dự án, như khi phê duyệt trong ứng dụng web. Việc phê duyệt sao chép các sản phẩm của mô hình dụng cụ trong dự án thành hàng hóa do người tạo dự án tạo, nên người dùng của khóa phải được phép tạo các hàng hóa đó và cập nhật các hàng hóa đã có. Khóa không có quyền này nhận 401 Unauthorized với "You are not authorized to perform this action", dự án vẫn ở trạng thái đã phát hành và không hàng hóa nào được tạo, thay vì được phê duyệt và tạo hàng hóa như trước. Vì bản sửa này đóng một thao tác ghi mà ứng dụng web đã từ chối, nó được áp dụng mà không cần thông báo trước 60 ngày.

Sửa lỗi — Tạo hoặc cập nhật một chi tiết (POST hoặc PATCH một chi tiết) với drawing giờ lưu bản vẽ đó làm bản vẽ 2D của chi tiết. Trước đây bản vẽ được đọc từ trường picture: gửi cả hai thì bản vẽ chứa dữ liệu của ảnh, còn chỉ gửi drawing thì yêu cầu thất bại. Không trường, kiểu dữ liệu hay phản hồi nào thay đổi, nên các tích hợp chỉ gửi picture hoặc model không bị ảnh hưởng.

Sửa lỗi — Tạo hoặc cập nhật một chi tiết (POST hoặc PATCH một chi tiết) với material_id của vật liệu thuộc tổ chức khác giờ trả về 422 Unprocessable Entity kèm lỗi ở material_id, thay vì lưu chi tiết với vật liệu đó như trước. Một chi tiết dùng vật liệu của chính tổ chức hoặc vật liệu dùng chung, như biểu mẫu chi tiết của ứng dụng web giờ cũng yêu cầu.

Sửa lỗi — Một yêu cầu cho một bản ghi (GET, PATCH hoặc DELETE một dự án, chi tiết hay máy gia công, tool_crib của một máy, và GET /tool_assemblies/:id) giờ chỉ tìm bản ghi trong tổ chức mà URL chỉ định. Một bản ghi của tổ chức khác trả về 404 Not Found với cùng thân phản hồi như một mã không tồn tại, như tài liệu này vốn đã ghi; trước đây bản ghi đó được đọc, thay đổi hay xóa nếu người dùng của khóa có quyền làm vậy trong tổ chức của chính bản ghi. Plugin cho Fusion luôn chỉ định tổ chức của chính bản ghi nên không bị ảnh hưởng. Vì bản sửa này đưa API về đúng với tài liệu và đóng việc đọc, ghi xuyên tổ chức qua địa chỉ của một tổ chức khác, nó được áp dụng mà không cần thông báo trước 60 ngày.

Sửa lỗi — GET /tool_assemblies/:id giờ trả về 404 Not Found với khóa error số ít cho một mã mô hình dụng cụ không tồn tại, như với chi tiết, dự án và máy gia công, thay vì 500 Internal Server Error như trước.

Sửa lỗi — Một khóa không còn đọc hay thay đổi được gì của một tổ chức mà người dùng của khóa chưa được chấp thuận: người dùng đã xin tham gia và đang chờ quản trị viên duyệt, người được mời nhưng chưa chấp nhận lời mời, hoặc người bị quản trị viên tạm ngưng trong tổ chức đó. Dù các nhóm của người dùng trong tổ chức đó cấp quyền gì, mọi endpoint của tổ chức đó (dự án, chi tiết, máy gia công, vật liệu và mô hình dụng cụ) đều trả về 401 Unauthorized với "You are not authorized to perform this action", như với mọi thao tác khác mà chủ của khóa không có quyền; ứng dụng web vốn đã đưa người dùng như vậy đến trang yêu cầu truy cập. Tệp xuất thư viện dụng cụ cho Fusion (GET /tool_library/fusion) giờ cũng trả về cùng 401 Unauthorized cho khóa như vậy và cho mọi khóa khác mà nó từ chối, như khóa của người dùng không được liệt kê mô hình dụng cụ của tổ chức, thay vì 200 OK với một đối tượng error thay cho thư viện như trước. Với một mã tổ chức không tồn tại, nó cũng trả về cùng 401 với cùng thân phản hồi, và mọi endpoint khác của tổ chức cũng vậy: endpoint liệt kê, tìm kiếm hay tạo mới trước đây trả về 404 Not Found trong trường hợp này, còn endpoint chỉ định một bản ghi theo mã giờ trả về 401 này cho một tổ chức mà khóa không truy cập được trước khi tìm bản ghi. Không endpoint nào còn cho biết mã tổ chức nào tồn tại. Mô hình dụng cụ mà tệp xuất không dựng được vẫn bị bỏ khỏi thư viện như trước, và người dùng của nó được thông báo; khi tệp xuất vẫn không dựng được dù đã bỏ các mô hình đó, nó trả về 422 Unprocessable Entity kèm lý do trong errors, và mọi lỗi khác trả về 500 Internal Server Error với "The tool library export failed", thay vì 200 OK với một đối tượng error như trước. 200 OK giờ chỉ mang một thư viện, hoặc null khi vendor không được hỗ trợ hay tổ chức không có gì để xuất. Vì bản sửa này đóng một quyền truy cập mà ứng dụng web đã từ chối, không còn cho biết mã tổ chức nào tồn tại, và khiến tệp xuất trả về mã lỗi khi từ chối hay thất bại, nó được áp dụng mà không cần thông báo trước 60 ngày. Khóa của thành viên đang hoạt động của tổ chức, hoặc của chủ sở hữu site của tổ chức, vẫn hoạt động như trước, và GET /organizations vốn chỉ liệt kê các tổ chức mà người dùng của khóa là thành viên đang hoạt động.

Sửa lỗi — Tệp xuất thư viện dụng cụ cho Fusion (GET /tool_library/fusion) giờ ghi minimum-thread-pitch và maximum-thread-pitch của dụng cụ gia công ren dưới dạng số, đúng kiểu mà định dạng thư viện dụng cụ của Fusion quy định, thay vì dạng chuỗi như trước. Vì thay đổi này đưa tệp xuất về đúng định dạng của Fusion, đây là một bản sửa lỗi chứ không phải thay đổi phá vỡ tương thích, nên được áp dụng mà không cần thông báo trước 60 ngày. Dao phay ren hoặc mảnh dao tiện ren chỉ có dải bước ren theo số ren trên inch giờ cũng có cả hai trường này, tính bằng mm. Dao phay ren hoặc mảnh dao tiện ren có dải bước ren riêng mà chỉ một đầu dùng được không còn xuất riêng đầu đó dưới dạng chuỗi: dải được lấy trọn từ số ren trên inch, hoặc không ghi trường nào.

Sửa lỗi — Cũng trong tệp xuất này, type của mũi ta rô giờ cho biết chiều ren: tap left hand với mũi ta rô ren trái và tap right hand với mọi mũi ta rô khác, kể cả mũi ta rô không có mã chiều ren. Trước đây, mọi mũi ta rô trừ loại ren phải đều có type là tap.

Sửa lỗi — Cũng trong tệp xuất này, một dụng cụ có dữ liệu mà tệp xuất không đọc được không còn làm hỏng toàn bộ tệp xuất, vốn trả về lỗi thay cho thư viện. Một thuộc tính không phải là số hữu hạn, như 1e400, hoặc được viết với dấu phẩy thập phân, như 11,5, được bỏ khỏi dụng cụ của nó, và dụng cụ được xuất không có thuộc tính đó; số răng hoặc số me cắt (NT, NOF) không phải là số cũng được bỏ đi, thay vì ghi là 0 như trước. Bước ren nhỏ đến mức số ren trên inch thành vô hạn, như 1e-320 mm, được coi là không dùng được, giống bước ren 0: dụng cụ lấy TP từ số ren trên inch, hoặc được xuất không có TP. Một dụng cụ mà tệp xuất không dựng được sẽ bị bỏ khỏi thư viện, và phần còn lại của thư viện vẫn được xuất: dụng cụ có mô hình dụng cụ không có đúng một dao cắt; cán dao tiện có hình dạng mảnh cắt không xác định được góc mũi; cán dao tiện, cắt rãnh hoặc tiện ren không giữ đúng một mảnh cắt; và dụng cụ có dữ liệu gây ra lỗi mà tệp xuất không lường trước, lỗi này được báo về cho chúng tôi. Người dùng chạy tệp xuất, tức người dùng của khóa API, nhận một thông báo trong ToolingMetrics nêu từng dụng cụ bị bỏ, cùng từng thuộc tính, preset hoặc mảnh cắt bị bỏ khỏi một dụng cụ, kèm lý do. Mảnh dao tiện không đọc được bán kính mũi giờ có RE 0, như mảnh dao cắt rãnh và dụng cụ quay.

Bổ sung — Cũng trong tệp xuất này, các preset thông số cắt có thêm các lượng chạy dao mà định dạng thư viện dụng cụ của Fusion yêu cầu. Preset của mũi khoan định tâm (spot drill), mũi khoan tâm (center drill) hoặc dao vát mép lỗ (countersink) có use-feed-per-revolution (false) và v_f_retract bên cạnh v_f_plunge; mọi preset phay, cùng preset của cán dao doa (boring bar), dao khoét bậc (counterbore), mũi khoan định tâm, mũi khoan tâm hoặc dao vát mép lỗ, có v_f_transition bằng v_f của nó. f_n của preset giờ là lượng chạy dao mỗi vòng chính xác, tức v_f chưa làm tròn chia cho n chưa làm tròn, thay vì v_f đã làm tròn chia cho n đã làm tròn: 0,2 mm thay vì 0,200126 với mũi khoan hai me cắt chạy dao 0,1 mm mỗi răng. Không trường nào bị bỏ hay đổi kiểu dữ liệu.

Bổ sung — Cũng trong tệp xuất này, mọi preset phay có ramp-angle mà định dạng thư viện dụng cụ của Fusion yêu cầu: 2 độ, như thư viện mẫu của Autodesk, vì dữ liệu cắt không có góc ăn dao nghiêng (ramp) riêng. Mảnh dao tiện ren, hoặc dao phay ren có lớp liệt kê góc biên dạng ren (PNA), có PNA riêng giờ ghi góc đó vào thread-profile-angle, trường trước đây chỉ được ghi khi suy ra từ góc sườn hoặc kiểu ren, và khi đó còn thay cho góc riêng của nó. Không trường nào bị bỏ hay đổi kiểu dữ liệu.

2024

Tháng 12 năm 2024

Bổ sung — Khóa API giờ được tạo và thu hồi tại Hồ sơ của bạn → Khóa API, gắn với chính tài khoản của bạn thay vì một quy trình personal access token riêng.

Tháng 9 năm 2024

Bổ sung — endpoint GET /machines/:id/tool_crib trả về các dụng cụ đang được nạp trên một máy gia công, nhóm theo mô hình dụng cụ.

Bổ sung — phản hồi tool_assemblies giờ có thêm mảng lồng cutting_data.

Tháng 3 năm 2024

Phát hành lần đầu — API v1 với các endpoint cho tổ chức, máy gia công, chi tiết, dự án và mô hình dụng cụ.