Welcome to the deskbird Public API
The deskbird Public API empowers developers to seamlessly integrate our workplace management features into their applications. This developer portal provides comprehensive resources to guide you through the API, including authentication, available resources, code examples, and response definitions.Calling the deskbird Public API#
The deskbird Public API can be accessed at:All requests should be directed to this domain.Authentication#
All requests to the Public API require a valid API key for authentication. This key uniquely identifies your company and grants access to the API. To include the API key in your requests, set the Authorization
header with the key as its value:Obtaining an API Key#
To obtain an API key for your company, follow these steps:1.
Log in to your deskbird account as a company Admin user. 2.
Navigate to the Integrations section within the deskbird app.
3.
Locate the Public API section and create a new API key.
Important Note: When creating an API key, ensure you select the "Public API" key type.Availability per Subscription#
Availability of this API depends on your subscription. See our pricing page for more information and contact us is case of any questions or upgrade requests.The deskbird Public API employs pagination to efficiently handle large datasets. This mechanism allows for the retrieval of data in manageable chunks.Parameters#
Two primary parameters control pagination:limit: Specifies the maximum number of records to be returned in a single response. Example: setting limit
to 10
will yield a maximum of 10 records per request.
offset: Determines the starting point within the overall dataset. This parameter is typically used to fetch subsequent pages of results after receiving the initial response. For example, if the first response contains 10 records (as defined by the limit
), setting offset to 10
in the subsequent request will retrieve the next 10 records.
API Response#
The API response includes a total field, indicating the total number of records matching your query. This helps estimate the number of pages needed to retrieve all results based on the specified limit
.Example
Consider fetching a list of all desks in your office, assuming a total of 100 desks. By setting limit
to 20
, you'll receive the first 20 desks in the initial response. The total field will inform you that there are 100 desks overall. To obtain the next 20 desks, send another request with the same limit but an offset of 20.By effectively utilizing limit, offset, and the total field, you can efficiently navigate through large datasets provided by the Deskbird Public API.