Autodesk Forma, ACC i testowa integracja przez APS

Co to jest APS?

Autodesk Platform Services, wcześniej znane jako Forge, to zestaw webowych API Autodesk. W praktyce jest to warstwa, która pozwala budować własne narzędzia korzystające z danych projektowych: modeli, plików, wersji, metadanych, widoków 2D/3D, automatyzacji Revit czy powiadomień o zmianach.

API nie jest osobnym programem do modelowania. To sposób komunikacji między aplikacjami. Frontend może pokazywać drzewo projektu, backend może bezpiecznie przechowywać sekrety aplikacji, a APS zwraca dane z konta Autodesk użytkownika zgodnie z jego uprawnieniami.

ACC, Autodesk Docs i Autodesk Forma

Autodesk Construction Cloud było przez lata rozpoznawalnym miejscem pracy z dokumentacją, koordynacją i procesami budowlanymi. Autodesk zapowiedział, że 24 marca 2026 ACC dołącza do Autodesk Forma. Ważne jest to, że Autodesk opisuje tę zmianę jako ewolucję marki i doświadczenia, a nie wymianę fundamentu technicznego: projekty, dane, workflow i infrastruktura pozostają w tym samym ekosystemie.

W dokumentacji APS coraz częściej pojawia się nazwa Forma Data Management, czyli środowisko wspólnego zarządzania plikami i folderami, wcześniej kojarzone jako Autodesk Docs. Dla integracji najważniejsze jest to, że Data Management API nadal pozwala przechodzić po strukturze danych: huby, projekty, foldery, pliki i wersje.

Nowy system hubów

W nowym języku Autodesk konto organizacji jest coraz częściej opisywane jako Hub, a administrator konta jako Hub Admin. Zmiana jest widoczna szczególnie po przejściu ACC do Autodesk Forma w 2026 roku. Hub staje się miejscem, w którym organizacja zarządza projektami, członkami, regionem danych, dostępem do produktów oraz aplikacjami APS.

Daje to spójniejszy model administracji, ale ma też konsekwencje techniczne. Aplikacja APS musi rozumieć, że użytkownik może mieć dostęp do wielu hubów i że nie każdy hub ma te same produkty, region danych ani uprawnienia. Dodatkowo dokumentacja Autodesk wskazuje, że huby tworzone dla własnych integracji APS są zarządzane z poziomu manage.autodesk.com, a nie tak samo jak zwykłe projekty użytkowników.

Jakie endpointy są potrzebne?

Minimalna przeglądarka struktury projektu nie potrzebuje od razu całego APS. Najpierw wystarczy OAuth oraz Data Management API. Dopiero później można dołożyć Viewer, Model Derivative, AEC Data Model, Webhooks albo Automation API.

• OAuth 3-legged - logowanie użytkownika Autodesk i zgoda na dostęp do danych, które użytkownik rzeczywiście widzi.
• GET /project/v1/hubs - lista hubów dostępnych dla zalogowanego użytkownika.
• GET /project/v1/hubs/{hub_id}/projects - projekty w wybranym hubie.
• GET /project/v1/hubs/{hub_id}/projects/{project_id}/topFolders - foldery główne projektu, np. Project Files.
• GET /data/v1/projects/{project_id}/folders/{folder_id}/contents - zawartość folderu: podfoldery i pliki.
• GET /data/v1/projects/{project_id}/items/{item_id}/versions - wersje konkretnego pliku wraz z datami i metadanymi.

W prawdziwej aplikacji trzeba pamiętać o paginacji, odświeżaniu tokenów, regionach danych, różnicach między typami projektów oraz ograniczeniu zakresów OAuth do tego, co naprawdę jest potrzebne. Jeżeli celem jest tylko odczyt struktury, aplikacja nie powinna prosić o uprawnienia zapisu.

Po co taka aplikacja?

Najprostszy scenariusz to szybki raport struktury: jakie projekty są dostępne, gdzie są foldery, jakie pliki mają wersje i czy da się przygotować czytelny eksport CSV. To nie zastępuje Autodesk Forma. To małe narzędzie pomocnicze dla osób, które chcą zrozumieć układ danych albo przygotować własny audyt techniczny.

W kolejnych wersjach taka aplikacja mogłaby porównywać foldery, sprawdzać nazewnictwo, wykrywać stare wersje plików, raportować braki w strukturze albo łączyć dane z innymi narzędziami BIM. Najpierw jednak trzeba mieć bezpieczne logowanie, świadomie dobrane endpointy i jasną granicę między publicznym opisem a prywatnymi danymi użytkownika.

Fraza „ACC viewer” często kojarzy się z podglądem modelu 3D, ale w praktyce równie ważny jest viewer danych: huby, projekty, foldery, pliki, wersje i metadane. Taki prosty Autodesk ACC viewer przez APS może pomóc BIM managerowi szybko sprawdzić, czy struktura projektu jest czytelna, czy pliki mają aktualne wersje i czy z danych da się przygotować raport bez ręcznego klikania po całym portalu.

Źródła

Wpis opiera się na dokumentacji Autodesk Platform Services: Data Management API, tutorialu Data Browsing, opisie AEC Data Model API, pomocy Autodesk o Forma Data Management, dokumentacji Hub Administration oraz komunikacie Autodesk Construction Cloud to join Autodesk Forma.