Project API
The Anywhere Project API is used to retrieve the list of Anywhere Projects that the user has access to and retrieve details of individual projects where required.
The Anywhere Project API can now be used to retrieve a list of Folders that the user has access to, starting from the root folder and a list of folders within a specific folder.
Finally the Anywhere Project API can also be used to create Folders or Projects in Anywhere.
The retrieved information can then be used as an input to subsequent API calls, such as the Anywhere Estimate API.
Prerequisites
Section titled “Prerequisites”In order to use the API the user must:
- Must be permissioned in the Accubid Anywhere Manager for ‘API Data Access’ (‘Full’ permission).
- Be successfully authenticated via Trimble ID.
- Retrieve a database token from the Anywhere Database API.
Use Cases
Section titled “Use Cases”Create Folder
Section titled “Create Folder”This API allows you to create a new folder in a specific database that the current user has access to.
Retrieve Folder(s) From Root
Section titled “Retrieve Folder(s) From Root”This API allows you to get a list of folders in the root folder within a specific database that the current user has access to.
Retrieve Folder(s)
Section titled “Retrieve Folder(s)”This API allows you to get a list of folders in a specific parent folder within a specific database that the current user has access to.
Create Project
Section titled “Create Project”This API allows you to create a new project in a specific folder for a specific database that the current user has access to.
Retrieve Project List
Section titled “Retrieve Project List”This API allows you to get a list of projects that the current user has access to within a specific database.
Retrieve Project Details
Section titled “Retrieve Project Details”This API allows you to get details of a specific project that the user has access to.
How-to Guides
Section titled “How-to Guides”Getting Started
Section titled “Getting Started”- Follow the below instructions regarding authorization.
- Follow the instructions regarding authenticating with Trimble Identity.
- Call the database list API to return a list of database names and tokens. Note - database tokens do not change, so they can be saved for future use.
- Call the project list API to return a list of project names and IDs. Note - Project IDs do not change, so they can be saved for future use.
Explanation and Concepts
Section titled “Explanation and Concepts”- Database - The user requires a database token in order to retrieve a list of projects (for that database).
Reference
Section titled “Reference”Dependencies
Section titled “Dependencies”- Anywhere Database API - In order to use the Projects API you will require database tokens from the Anywhere Database API.
Error Message Table
Section titled “Error Message Table”Please see below table containing the list of currently used error codes
| Code | Description |
|---|---|
| 200 | The request was successful |
| 400 | Parameter(s) are invalid |
| 401 | Request could not be authorized |
| 403 | Request was explicitly forbidden, user does not have access to database |
| 404 | A required reference was not found |
| 409 | Conflict. Database is locked please try again later |