Antes de poder integrar con nuestra API, es fundamental que comprendas cómo se gestionan los ambientes (testing y producción) y los pasos para obtener tus usuarios y tokens de acceso.
⚠️ Importante: Usuario de testing solo tras usuario producción
No podemos darte acceso al usuario de testing hasta que tengas creado y aprobado el usuario en producción. Para esto:
Debés crear un usuario en producción a través del formulario en dashboard.moova.io.
Contactar a nuestro equipo de ventas para validar y aprobar tu alta en producción.
Solo después de eso, podrás solicitar el usuario de testing para hacer pruebas.
🔗 URLs y entornos — Evitá confusiones
URL | Descripción | Uso principal |
dashboard.moova.io | Plataforma web oficial para clientes en producción | Registro y gestión real de envíos y usuarios |
dev.moova.io | Plataforma idéntica a dashboard pero para testing/sandbox | Crear usuarios y envíos de prueba; no tiene impacto real |
b2b-api-test.moova.io | Simulador de courier para probar webhooks | Cambiar estados de envíos de prueba mediante webhooks; no permite setear URL de hooks |
📝 Proceso para obtener usuario de testing
Crear usuario en producción en dashboard.moova.io
Contactar al equipo de ventas para validar el alta
Replicar la creación de usuario en dev.moova.io (ambiente de pruebas)
Enviar un email a [email protected] con asunto: ALTA TESTING para que habiliten el usuario de testing
Generar appId y appKey en el ambiente de pruebas
🔐 Cómo obtener el APP ID y APP KEY
Para poder realizar llamadas a la API (tanto en testing como en producción) necesitás dos credenciales clave:
APP ID
APP KEY
Estas credenciales se obtienen en el panel de usuario, una vez que estés dado de alta y logueado en:
https://dev.moova.io/ (para testing)
https://dashboard.moova.io/ (para producción)
Pasos para obtener APP ID y APP KEY en testing:
Ingresar a dev.moova.io y loguearte con el usuario de testing aprobado.
Ir a la sección de Area de empresa.
Ahí encontrarás el APP ID y la APP KEY dentro de API/WEBHOOK
Desde aqui podras setear la URL para recibir notificaciones de cambio de estado (webhook) se configura únicamente en dev.moova.io para el ambiente de pruebas.
En b2b-api-test.moova.io solo podés simular cambios de estado de envíos de prueba (para pruebas de webhook), pero no podés setear la URL del webhook.
⚙️ Uso en la API
El APP ID debe enviarse en todas las solicitudes en el query string:
?appId=TU_APP_ID
El APP KEY se envía en el header HTTP
Authorization
:
Authorization:TU_APP_KEY
Estas dos credenciales autentican y autorizan tu integración para poder hacer llamadas válidas a todos los endpoints.