Ir al contenido principal

🔐 Autenticación y acceso a la API

Esta guía te explica cómo crear tu cuenta, obtener tus credenciales de acceso (APP ID y APP KEY) y cómo usarlas para hacer tu primera llamada a la API, tanto en el ambiente de testing como en el de producción.

A
Escrito por Axel Candia

🧠 Conceptos clave (leé esto primero)

Tres cosas para tener en cuenta antes de arrancar:

  1. Hay dos ambientes independientes: producción y testing. Cada uno tiene su propio dashboard, sus propias credenciales y su propia URL de API. Las credenciales no se comparten entre ambientes.

  2. El orden importa: primero producción, después testing. A diferencia de otras APIs, acá no podés usar el sandbox hasta tener el usuario de producción creado y aprobado.

  3. Toda llamada se autentica con dos credenciales: el appId (va en la URL) y el appKey (va en el header). Sin las dos, la API responde 401.

⚠️ Importante — el testing depende de producción No entregamos el usuario de testing hasta que tengas el usuario de producción creado y aprobado. Recién después podés habilitar el sandbox.

🔗 URLs y entornos — Evitá confusiones

Ambiente

Dashboard web (registro y credenciales)

Base URL de la API

Para qué sirve

Producción

https://dashboard.moova.io

https://api-prod.moova.io/b2b

Operación real: envíos, usuarios y datos productivos.

Testing / Sandbox

https://dev.moova.io

https://api-dev.moova.io/b2b

Crear usuarios y envíos de prueba. No tiene impacto real.

Simulador de courier

https://b2b-api-test.moova.io

—

Simular cambios de estado de envíos de prueba (para testear webhooks). No permite setear la URL del webhook.

El simulador de courier es una herramienta auxiliar del ambiente de testing: sirve para forzar cambios de estado y ver cómo responde tu integración a los webhooks. No es la API donde creás recursos.

📝 Paso a paso para obtener acceso

Etapa 1 — Producción

  1. Registrá tu usuario de producción en dashboard.moova.io/register.

  2. Comunicate primero con tu asesor de ventas para que valide tu alta. Sin este paso, el alta no se habilita. La aprobación demora hasta 72 horas hábiles.

  3. Una vez aprobado, generá tu APP ID y APP KEY de producción (ver más abajo).

Etapa 2 — Testing (solo después de tener producción aprobado)

  1. Replicá la creación del usuario en dev.moova.io/register.

  2. Enviá un mail a [email protected] con el asunto ALTA TESTING para que habiliten el usuario de testing.

  3. Una vez habilitado, generá tu APP ID y APP KEY de testing (ver más abajo).

🔑 Cómo obtener tu APP ID y APP KEY

Las credenciales se generan desde el dashboard del ambiente correspondiente, una vez logueado:

Pasos (idénticos en ambos dashboards):

  1. Ingresá y logueate con tu usuario aprobado.

  2. Andá a la sección Área de empresa.

  3. Dentro de API / Webhook vas a encontrar tu APP ID y tu APP KEY.

🔒 Cuidá tu APP KEY. Es un secreto: no la subas a repositorios públicos ni la expongas en código de frontend. Tratala como una contraseña.

⚙️ Cómo autenticar tus requests

Toda llamada a la API necesita las dos credenciales:

Credencial

Dónde va

Formato

APP ID

Query string de la URL

?appId=TU_APP_ID

APP KEY

Header HTTP Authorization

Authorization: TU_APP_KEY (valor crudo, sin Bearer)

🔔 Webhooks (resumen)

Un webhook es una URL tuya a la que Moova le avisa automáticamente cada vez que un envío cambia de estado, así no tenés que estar consultando la API.

  • La URL del webhook se configura en dev.moova.io → Área de empresa → API / Webhook (para el ambiente de pruebas).

  • Para simular cambios de estado y probar que tu webhook recibe bien las notificaciones, usá el simulador b2b-api-test.moova.io.
    ​
    ​
    ​

¿Ha quedado contestada tu pregunta?