Obtener el access token

El Access Token se utiliza para autenticarte en la API de ZapSign. Este token está asociado a tu usuario y a la organización que especifiques al generarlo, y su validez es de 1 hora.

Pasos para obtener el Access Token:

1. Realiza una solicitud al endpoint de autenticación utilizando las credenciales de tu usuario en ZapSign.

2. Este endpoint te devolverá tanto el Access Token como el Refresh Token.

POST https://api.zapsign.com.br/api/v1/auth/token/{{organization_ID}}/

Cómo obtener tu Organization ID: Ve a Ajustes > Integraciones > API ZapSign y copia el número al lado de ID Organización.

Request body
{
    "username": "[email protected]",
    "password": "StrongPassword123"
}

200: OK Authentication successfully completed.

{
    "refresh": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0b2tlbl90eXBlIjoicmVmcmVzaCIsImV4cCI6MTcxMDE3ODM0NCwianRpIjoiYjhmZjMwNDJmNjRkNDJmM2FlMzczZmRiNDQ3YTQ2NGEiLCJ1c2Vyb",
    "access": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c"
}

401: Unauthorized Invalid credentials

400: Bad Request Login attempts exceeded.

Una vez que tengas tu token, puedes autenticarte en los endpoints de ZapSign incluyéndolo en el encabezado "Authorization" de tus solicitudes, con el prefijo "Bearer". Por ejemplo

  'headers': {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ0b2tlbl90eXBlIjoiYWNjZXNzIiwiZXhwIjoxNzA5ODIwMTQxLCJqdGkiOiIxMGM4YmVhOTkxNDM0ZGU5OWQxNmViMGE2ZTA3MTU1YyIsInVzZXJfaWQiOjEsInR5cGUiOiJwdWJsaWMifQ.GhMKXDyiidHrWCSmU3I9e6-zDm61mBmDqEavir4IW0c'
  },

Después de una hora, debes volver a autenticarte. En la siguiente sección conoce como Actualizar el Access Token.