Autenticación de la API
Autentícate con la API de Spark!
Última actualización: 2026-01-19
La API de Spark! utiliza claves de API para autenticar las solicitudes. Incluye tu clave en el encabezado Authorization de cada solicitud.
Obtén tu clave de API
- Ve a Settings → API → API Keys
- Haz clic en "Create API Key"
- Pon nombre a tu clave (p. ej., "Production", "Staging")
- Define los permisos (solo lectura o lectura y escritura)
- Copia y guarda la clave de forma segura
Mantén las claves en secreto
Las claves de API dan acceso completo a tus datos de Spark!. Nunca las expongas en código del cliente, repositorios públicos ni registros.
Usa tu clave de API
Incluye la clave de API en el encabezado Authorization:
Authorization: Bearer YOUR_API_KEY
Límites de solicitudes
Las solicitudes de la API tienen estos límites:
- Estándar: 100 solicitudes por minuto
- Operaciones masivas: 10 solicitudes por minuto
- Webhooks: sin límite (salientes)
Cada respuesta incluye encabezados de límites:
X-RateLimit-Limit: máximo de solicitudes permitidasX-RateLimit-Remaining: solicitudes restantesX-RateLimit-Reset: marca de tiempo Unix del reinicio del límite
Gestión de errores
Los errores de la API devuelven códigos de estado HTTP estándar:
- 400: solicitud incorrecta (parámetros no válidos)
- 401: no autorizado (clave de API no válida o ausente)
- 403: prohibido (permisos insuficientes)
- 404: no encontrado
- 429: demasiadas solicitudes (límite alcanzado)
- 500: error del servidor
Entornos
- Producción:
https://api.chargezen.com/spark/v1 - Pruebas:
https://sandbox.chargezen.com/spark/v1
Pruebas en el entorno aislado
Usa el entorno de pruebas para probar. Reproduce producción, pero no afecta a datos reales ni inicia pagos reales.
Próximos pasos
Artículos relacionados
¿Te resultó útil esta página?
¿Necesitas más ayuda? Contactar con soporte