Introducción

A diferencia de otros sistemas, en esta API no se solicita un token diferente para cada cuenta hija. Se utiliza un único token maestro y se cambia el contexto dinámicamente en cada petición.

Paso 1: Autenticación Inicial

Obtén tu token de acceso (x-auth-token) autenticándote con tus credenciales de Cuenta Administradora. Este token será el que utilices para todas tus operaciones, tanto propias como de tus hijos.

• Endpoint: POST /api/v1/auth/login

• Resultado: Recibes un token que identifica tu identidad como Administrador.

Paso 2: Identificar el ID del Negocio Hijo

Debes conocer el identificador único (business_id) del negocio sobre el cual deseas operar. Puedes obtener una lista de tus cuentas vinculadas consultando tu panel de administración o el endpoint de negocios.

Paso 3: Configurar los Headers de la Petición

Para realizar una petición sobre un hijo, debes incluir dos headers obligatorios:

1. x-auth-token: Tu token de administrador (Paso 1).

2. child-id: El ID del negocio hijo (Paso 2).

Ejemplo de llamada (cURL):

curl -X GET "https://api.trazo.com/api/v1/transactions" \
     -H "x-auth-token: TU_TOKEN_DE_ADMINISTRADOR" \
     -H "child-id: ID_DEL_NEGOCIO_HIJO"

Paso 4: Procesamiento de la API

Cuando la API recibe estos headers, realiza lo siguiente:

• Valida que el token sea vigente.

• Verifica que tú (dueño del token) seas realmente el administrador de ese child-id.

• Aísla la consulta: El sistema responderá como si la petición hubiera sido hecha por el hijo, devolviendo solo los saldos, transacciones o configuraciones de ese negocio específico.

El child-id no se "guarda" en la sesión. Debes enviarlo en cada una de las peticiones que quieras realizar sobre el hijo.

Paso 5: Volver al Contexto de Administrador

Si deseas realizar una operación sobre tu propia cuenta principal, simplemente realiza la petición omitiendo el header child-id.

curl -X GET "https://api.trazo.com/api/v1/transactions" \
     -H "x-auth-token: TU_TOKEN_DE_ADMINISTRADOR"

Nunca pidas un token usando las llaves del hijo si eres el administrador, usa siempre tu propio token para mantener la trazabilidad de quién realizó la acción.