get_latest_derivative_urn

APSToolkitPython/src/aps_toolkit/BIM360.py

@@ -195,6 +195,21 @@ def get_item_info(self, project_id: str, item_id: str):
             raise Exception(response.content)
         return response.json()
 
+    def get_latest_derivative_urn(self, project_id: str, item_id: str):
+        """
+        Get the latest derivative urn of an item by project_id and item_id
+        :param project_id: :class:`str` the unique identifier of a project
+        :param item_id: :class:`str` the unique identifier of an item
+        :return: :class:`str` the latest derivative urn of an item
+        """
+        headers = {'Authorization': 'Bearer ' + self.token.access_token}
+        url = f"{self.host}/data/v1/projects/{project_id}/items/{item_id}/versions"
+        response = requests.get(url, headers=headers)
+        if response.status_code != 200:
+            raise Exception(response.content)
+        item_versions = response.json()
+        return item_versions['data'][0]['relationships']['derivatives']['data']['id']
+
     def batch_report_projects(self, hub_id: str) -> pd.DataFrame:
         """
         Get batch all projects with general information by hub_id

APSToolkitPython/src/test/test_bim360.py

@@ -45,6 +45,10 @@ def test_get_item_info(self):
         item_info = self.bim360.get_item_info(self.project_id, self.item_id)
         self.assertNotEquals(item_info, 0)
 
+    def test_get_latest_derivative_urn(self):
+        urn = self.bim360.get_latest_derivative_urn(self.project_id, self.item_id)
+        self.assertNotEquals(urn, "")
+
     def test_get_item_versions(self):
         items = self.bim360.batch_report_items(self.project_id, self.folder_id)
         self.assertNotEquals(len(items), 0)