Primers passos

Prerequisits

Abans de començar, assegureu-vos de disposar del següent:

• Credencials de l'API: Obtingueu el vostre client_id, client_secret i application_id de vitalera.
• Entorn de desenvolupament: Configureu el vostre entorn de programació preferit.
• Documentació de l'API: Familiaritzeu-vos amb la nostra Referència de l'API.

Configuració de l'autenticació

Ús de l'autenticació JWT

1. Obtingueu un JWT:

   Envieu una petició POST al punt d'accés d'autenticació amb les vostres credencials de client.

   curl -X POST "https://api.vitalera.io/api/auth/tokens/" \
        -H "Content-Type: application/json" \
        -d '{"grant_type": "client_credentials", "client_id": "<CLIENT_ID>", "client_secret": "<CLIENT_SECRET>"}'

   Rebreu un JWT a la resposta:

   {
     "access_token": "<ACCESS_TOKEN>",
     "expires_in": 3600,
     "token_type": "Bearer"
   }

2. Incloeu el JWT a les vostres peticions:

   Afegiu el JWT a la capçalera Authorization:

   GET https://api.vitalera.io/api/plans/
   Authorization: Bearer <ACCESS_TOKEN>

Feu la vostra primera crida a l'API

Exemple: Obtenir els plans disponibles

1. Punt d'accés:

GET https://api.vitalera.io/api/plans/

2. Exemple amb curl:

curl -X GET "https://api.vitalera.io/api/plans/" \
     -H "Authorization: Bearer <ACCESS_TOKEN>"

3. Resposta:

[
  {
    "id": 123,
    "name": "Plan Example 1"
  },
  {
    "id": 321,
    "name": "Plan Example 2"
  }
]

Passos següents

Després de fer la vostra primera crida a l'API, exploreu el següent per millorar la vostra integració:

• Autenticació: Aprofundiu en la seguretat de les vostres interaccions amb l'API.
• Referència de l'API: Accediu a informació detallada sobre tots els punts d'accés disponibles i el seu ús.
• SDKs i biblioteques: Utilitzeu els nostres SDKs per simplificar la integració al vostre flux de desenvolupament.

Necessiteu ajuda?

Si trobeu algun problema o teniu preguntes, el nostre equip de suport és aquí per ajudar-vos! Contacteu-nos a support@vitalera.io o visiteu la nostra secció de Suport per a més recursos.