Autenticación y modos
Conceptos
Autenticación y modos
Llaves de API con Bearer, modo prueba y modo live, prefijos de llave y buenas prácticas para guardarlas.
La llave en cada petición
Manda tu llave en el encabezado Authorization de cada petición. Sin llave, o con una que no sirve, la respuesta es 401.
http
GET /api/v1/ping HTTP/1.1
Host: api.muvon.mx
Authorization: Bearer mvn_test_…Prueba y live
| Modo | Prefijo | Qué pasa |
|---|---|---|
| Prueba | mvn_test_ | Precios reales, pero las reservas no llegan a operación ni a ningún piloto. Códigos TEST-000001. Pagos con Stripe en prueba. Disponible al aprobar tu cuenta. |
| Live | mvn_live_ | Reservas reales con código MVN-000123, que Muvon opera y cobra. Solo después de que Muvon activa live en tu cuenta. |
El modo sale solo de la llave, nunca de la petición. Los datos no se cruzan: con una llave de prueba no ves reservas live, y al revés. Cada respuesta trae el encabezado Muvon-Mode: test o Muvon-Mode: live, y los objetos traen livemode.
Cuidar tus llaves
- Una llave se muestra completa solo al crearla. Muvon guarda una huella, no la llave: si la pierdes, crea otra.
- Puedes tener hasta 5 llaves activas por modo. Para rotar, crea la nueva, cámbiala en tu servidor y revoca la vieja.
- Úsala solo en tu servidor. La API no acepta llamadas desde navegadores (no hay CORS).
- Si una llave se filtra, revócala en el portal: deja de funcionar al momento.
Id de la petición
Cada respuesta trae Muvon-Request-Id: req_…. Guárdalo en tus logs y compártelo con soporte si algo falla.