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

{
    "detail": "No active account found with the given credentials"
}

400: Bad Request Login attempts exceeded.

{
    "message": "Rate limit 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.