Authentication

Client Tokens

Ces tokens, uniquement utilisé par l'API /Messages, sont des tokens publiques identifiant l'assistant avec qui communiquer.

Access Tokens

Ces tokens sont privés et permettent l'usage des API Prisme.ai avec le même niveau de permissions que le compte depuis lequel ils ont été générés.

Ils peuvent aussi être générés par API, en utilisant un autre access token ou le token de session stocké par le navigateur, et visible dans les headers X-Parse-Session-Token.

Générer un access token

Exemple de requête

curl --location --request POST 'https://api.prisme.ai/v2/auth/accessToken' \
--header 'X-Parse-Session-Token: SESSION_TOKEN' \
--header 'Content-Type: application/json' \
--data-raw '{
    "expiresAt": "2037-04-02T10:04:34.519Z"
}'

Exemple de réponse

Code : 200

{
    "_id": "KYsrHNrAeR",
    // This is your access token
    "_session_token": "6989be62-7b3e-4569-88e1-481137f9bfb9",
    "_p_user": "xxx",
    "createdWith": {
        "action": "api",
        "authProvider": "sessionToken"
    },
    "restricted": false,
    "expiresAt": "2037-04-02T10:04:34.519Z",
    "_created_at": "2021-06-03T17:34:32.440Z",
    "_updated_at": "2021-06-03T17:34:32.440Z"
}  

Lister ses access tokens

Exemple de requête

curl --location --request GET 'https://api.prisme.ai/v2/auth/accessToken' \
--header 'X-Parse-Session-Token: SESSION_TOKEN' \

Exemple de réponse

Code : 200

[
  {
      "_id": "KYsrHNrAeR",
      // This is your access token
      "_session_token": "6989be62-7b3e-4569-88e1-481137f9bfb9",
      "_p_user": "xxx",
      "createdWith": {
          "action": "api",
          "authProvider": "sessionToken"
      },
      "restricted": false,
      "expiresAt": "2037-04-02T10:04:34.519Z",
      "_created_at": "2021-06-03T17:34:32.440Z",
      "_updated_at": "2021-06-03T17:34:32.440Z"
  }    
]

Révoquer un access token

Exemple de requête

curl --location --request DELETE 'https://api.prisme.ai/v2/auth/accessToken/ACCESS_TOKEN' \
--header 'X-Parse-Session-Token: SESSION_TOKEN' \

Exemple de réponse

Code : 200