Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Status
colourYellow
titleWork in progress

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.html

How 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

Frame 413.png

Step 3 Create API key

Click on the button:

Group 395.png

Step 4 Create your credentials (copy or save temporarily the "API key ID" and "API key")

token created.png

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
languagebash
> 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
languagejs
{
    "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
languagebash
> curl -X GET \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <JWT>" \
    https://profields-cloud.deiser.com/fields