Deals | Obtener token de autenticación para publicar en Deals vía API

:timer_clock: Tiempo estimado: 5–10 minutos

¿Para qué sirve?

Genera el Bearer Token necesario para autenticar las llamadas a la API de publicación de Deals. El proceso consta de dos pasos: primero se obtiene un jwttoken y luego se intercambia por el Token definitivo que se usa en las publicaciones.

Antes de empezar

La empresa debe estar activa en Deals.

:round_pushpin: Menú → Deals → Configurar Empresa → Activar

URLs base por ambiente

La URL completa de cada llamada se forma concatenando la URL base del ambiente con el endpoint correspondiente.


Modo de uso

Paso 1 — Obtener la CFU y la Secret Key

Ir a Deals → Configurar Empresa y copiar los siguientes valores:

  • CFU (Clave Finnegans Única)
  • Secret Key

Ambos valores son necesarios para solicitar el token en el paso siguiente.

Paso 2 — Solicitar el jwttoken

Realizar la siguiente llamada:

  • Method: POST
  • Endpoint: api/1/deals-back/authenticate
  • Authorization: No Auth
  • Body: raw / JSON
{
  "cfu": "<CFU obtenida en el Paso 1>",
  "secretKey": "<Secret Key obtenida en el Paso 1>"
}

Del response, guardar el valor del campo jwttoken. Se usa en el paso siguiente.

Paso 3 — Obtener el Token definitivo

Realizar la siguiente llamada:

  • Method: GET
  • Endpoint: api/1/deals-back/info
  • Authorization: Bearer Token → ingresar el valor del “jwttoken” obtenido en el Paso 2

Del response, guardar el valor del campo Token. Este es el Bearer Token que se utiliza en las llamadas de publicación de documentos.


Qué hace y qué no hace

:backhand_index_pointing_right: Hace: genera el Token de autenticación necesario para publicar documentos en Deals vía API.

:backhand_index_pointing_right: No hace: no configura el método de publicación ni el documento en Deals. Para el flujo completo de publicación, ver Publicar documentos en Deals vía API — Acceso Directo.