La API se publica en dos entornos independientes. Cada uno tiene su propia URL, su propia base de datos y sus propias credenciales: una API Key creada en sandbox no funciona en producción y viceversa.
URLs base
| Entorno | URL base | Cuándo usarlo |
|---|---|---|
| Sandbox | https://www.facturator.xyz/api | Desarrollo, pruebas de integración, demos. |
| Producción | https://www.factura-tor.com/api | Tráfico real, comprobantes con validez fiscal. |
Cómo construir tus llamadas
Todas las rutas documentadas aquí se anteponen a la URL base del entorno:
bash
# Sandbox
curl https://www.facturator.xyz/api/customers?businessId=1 \
-H "X-API-Key: $SANDBOX_API_KEY"
# Producción
curl https://www.factura-tor.com/api/customers?businessId=1 \
-H "X-API-Key: $PROD_API_KEY"Recomendaciones
- Mantén una API Key por entorno. Nunca compartas la clave de producción con tu equipo de desarrollo.
- Usa variables de entorno (
API_BASE_URL,API_KEY) en tu código en lugar de hardcodear el dominio. - Antes de pasar a producción, ejecuta tu flujo completo en sandbox: crear negocio, subir firma, emitir factura de prueba, descargar PDF.
- El comportamiento del API es idéntico en ambos entornos: mismos campos, mismos códigos de respuesta, mismos errores.