---
title: "Autenticación de la API: documentación de Spark! | Chargezen"
description: "Autentícate con la API de Spark!. De la sección “Referencia de API” de la documentación de Chargezen Spark!."
url: "https://chargezen.com/es/docs/spark/api/authentication"
lang: "es"
updated: "2026-01-19"
---

Canonical URL: https://chargezen.com/es/docs/spark/api/authentication

# 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

1.  Ve a Settings → API → API Keys
2.  Haz clic en "Create API Key"
3.  Pon nombre a tu clave (p. ej., "Production", "Staging")
4.  Define los permisos (solo lectura o lectura y escritura)
5.  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 permitidas
*   `X-RateLimit-Remaining`: solicitudes restantes
*   `X-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

[

### Endpoints REST

Referencia completa de endpoints

Más información



](https://chargezen.com/es/docs/spark/api/endpoints)[

### Webhooks

Notificaciones de eventos

Más información



](https://chargezen.com/es/docs/spark/api/webhooks)

### Artículos relacionados

[

#### Endpoints REST

Referencia de endpoints de la API



](https://chargezen.com/es/docs/spark/api/endpoints)[

#### Webhooks

Notificaciones de eventos



](https://chargezen.com/es/docs/spark/api/webhooks)

¿Te resultó útil esta página?

¿Necesitas más ayuda? [Contactar con soporte](https://chargezen.com/es/docs/checkoutos/troubleshooting/support)