Para habilitar el uso de la API, necesitamos crear una nueva clave de integración en la plataforma. Esta clave sirve para autenticarse en la API y puede ser creada usando tres modos diferentes: “lectura”, “escritura” o “ambos”.

Para crear una nueva integración, siga estos pasos:

1. En el menú superior, haga clic en Integraciones.

2. Haga clic en el botón Nueva Integración.

3. Seleccione la organización para la cual se creará la integración.

4. Seleccione el alcance que se utilizará en la integración (solo lectura, solo escritura o ambos).

5. Ingrese un nombre para identificar esta integración posteriormente.

6. Haga clic en Guardar.

7. Será redirigido a una pantalla con información importante sobre la integración como

   ID de la Organización

   Clave de Integración

Con el ID de la Organización y la Clave de Integración comenzaremos el proceso de integración con la API.

Para autenticarse en la API, siga estos pasos:

1. En el menú superior, haga clic en Integraciones.
2. Haga clic en el botón Documentación de la API.

3. Haga clic en el endpoint llamado Session y luego haga clic en el botón Try it out
4. Ingrese el ID de la Organización y la Clave de Integración
5. Haga clic en el botón Execute.

   Recibirá un Access Token en la respuesta, copie este token para que podamos utilizarlo en el siguiente paso.

6. En la misma pantalla de Swagger UI, haga clic en el botón Authorize.

7. Pegue el Access Token en el campo y luego haga clic en el botón Authorize.

Ahora está autenticado en la API y podrá utilizarla.