Status | ||||
---|---|---|---|---|
|
Seamless API Integration: In this section you can connect effortlessly with external services.
This enables users to connect and interact with various services and platforms, enhancing functionality and providing more flexibility for custom workflows.
With Exporter you can see all you APIs, create new ones, and manage them as you want.
REST Api reference:
https://profields-cloud.deiser.com/swagger-ui.htmlHow to authenticate in Exporter REST Api:
Generate API key ID and API Key
Why is this a necessary step?
This will be the information that each customer will have to provide you to use Exporter data in your app.
Step 1 Go to the Apps dropdown and go to API integrations section
Step 3 Create API key
Click on the button:
Step 4 Create your credentials (copy or save temporarily the "API key ID" and "API key")
Using Exporter API
Integrate your app with Projectrak using this API documentation: https://profields-cloud.deiser.com/swagger-ui.html
Login into Projectrak
The first service you will need to integrate your app with Projectrak is api-keys/jwt to create a new JWT (JSON web token):
https://profields-cloud.deiser.com/api-keys/jwt
Request example
Code Block | ||
---|---|---|
| ||
> curl -X POST \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -d "{\"name\": \"<API_KEY_ID>\",\"password\": \"<API_KEY>\"}" \ https://profields-cloud.deiser.com/api-keys/jwt |
This will provide you with a JWT that you must incorporate in all calls. This JWT has an expiration date, if receive an error 401 in your calls, please create a new JWT again.
Info |
---|
This JWT has an expiration date, if receive an error 401 in your calls, please create a new JWT again. |
Response example
Code Block | ||
---|---|---|
| ||
{ "jwt": "MzAwMDY5ZTgyMmFmIiwiYmFzZVVSTCI6Imh0dHBzOi8vcWE...", "baseUrl": "https://documentation-deiser.atlassian.net", "clientKey": "fabf8b45-e66c-3fa5-832b-684631f2d003", "accountId": "60f02aedf85746438494e822af", "created": "2022-02-17T10:22:15.121+0000", "expired": "2022-02-18T02:22:15.121+0000" <--- EXPIRATION DATE } |
Use the JWT in a request:
To use the JWT in any request you need to use Bearer Authentication.
Request example
Code Block | ||
---|---|---|
| ||
> curl -X GET \ -H "Accept: application/json" \ -H "Content-Type: application/json" \ -H "Authorization: Bearer <JWT>" \ https://profields-cloud.deiser.com/fields |