Versions Compared

Key

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

...

Step 1 Go to the Project Navigator

...

Step 2 Go to API Integrations 
Image Modified

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

Using Projectrak API

...

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
titleRequest example
> 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
title
languagejsResponse example
{
    "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
}

...

To use the JWT in any request you need to use Bearer Authentication.

Request example
Code Block
languagebashtitleRequest example
> curl -X GET \
    -H "Accept: application/json" \
    -H "Content-Type: application/json" \
    -H "Authorization: Bearer <JWT>" \
    https://profields-cloud.deiser.com/fields

...