2017年7月17日以前移植您的View and Data 工程

熟悉Autodesk Forge的朋友可能知道Autodesk 兩年前有個名爲View and Data的技術，即網頁模型瀏覽和業務拓展。使用中須要進行身份認證（獲取token），上傳模型，轉換成網頁瀏覽格式。以及Viewer的JavaScript包對網頁格式進行渲染和加載，拓展。這幾步其實後端用到幾個雲服務端口，形如：

• POST https://developer. api.autodesk.com/authentication/v1/authenticate

• POST https://developer. api.autodesk.com/oss/v1/buckets/

• POST https://developer. api.autodesk.com/oss/v1/buckets/:bucketKey/objects/:objectName

• POST https://developer. api.autodesk.com/viewingservice/v1/register/

在去年6月Forge 大會以後，前面的幾個服務的功能已變成Forge獨立的服務中的一部分：

• 身份認證（authentication）

• 數據管理（Data Management）

• 數據提取和格式轉換（Model Derivitives）

例如上面的幾個端口新版爲：

• POST https://developer. api.autodesk.com/authentication/v1/authenticate

• POST https://developer. api.autodesk.com/oss/v2/buckets/

• POST https://developer. api.autodesk.com/oss/v2/buckets/:bucketKey/objects/:objectName

• POST https://developer.api.autodes...

能夠看到數據管理和模型提取服務版本定爲v2，因此常常稱做v2轉換過程。v2不僅是端口名字的變化，而是開發者能夠單獨的調用，獲取對應的數據。固然，每種服務體系中的端口也更加豐富，例如身份認證（authentication）能夠進行受權認證的過程，讓開發者能夠訪問到最終客戶在Autodesk 雲產品上的數據存儲。數據管理中，能夠對原始模型進行獲取，刪除，轉換後的模型刪除，而也提供Autodesk 雲產品例如Autodesk 360 的Project，Folder，Item等操做。至於數據提取，也可提取出模型的層次結構和對象屬性列表等。並且v2的轉換服務能夠支持轉換出更多格式，例如OBJ，STL，IFC，FBX等等。不只這些，v2的基礎安全機構更加的完善和強壯。

同時，網頁瀏覽和業務拓展的JavaScript庫也不斷升級更新，雖然其版本號體系和後端的Forge雲服務不一樣。而JavaScript也對v2的轉換過程產生的數據進行對應的兼容工做，不斷提升性能和功能。

從去年6月到如今，v1和v2是並存的狀態，客戶均可以用，但實際上v1更多處於維護的狀態。隨着絕大多數客戶已經穩定的使用v2，Autodesk Forge團隊決定，從今年7月17日起，中止v1的服務。也就是說前面提到的那些雲服務端口將終止。而很老的JavaScript庫可能也會沒法訪問。

有些朋友的工程是基於某個時期的樣例寫的，更多關注前端的應用，然後端可能仍舊用的v1端口。因此，特此通知，務必儘快移植相關工程到v2過程。移植須要作的工做很少：

1. 按幫助文檔，用v2的端口替換之前的端口

2. 根據v2的參數說明，調整request和response的細節。例若有些端口的response的json結構變化了

3. 身份認證獲取token，務必提供參數scope

4. 連接到較新的Forge Viewer JavaScript庫。不指定版本目前默認是2.10. 指定版本，如今最高能夠到2.14

5. 調試工程，排查錯誤

能夠直接參考Forge相關的樣例調整, 例如，如下博客提到的樣例：
https://segmentfault.com/a/11...

如在移植過程當中遇到任何問題，請聯繫Autodesk Forge支持團隊。