Autenticación
Autenticación Bearer con Secret Keys (sk_proj_/sk_live_/sk_test_) en el header Authorization — endpoints cubiertos (envío, dominios, activity, leads, eventos), dónde obtener la key y errores 401.
Todos los endpoints de la API de ReallyQuickEmails usan el mismo método de autenticación: Bearer Token con tu Secret Key.
Bearer Token
Envía tu Secret Key (sk_proj_...) en el header Authorization:
Authorization: Bearer sk_proj_tu_secret_keyEste patrón funciona para todos los endpoints:
- Envío:
POST /v1/send-email,POST /v1/send-template-email,POST /v1/send-batch,POST /send-email - Dominios:
POST /domains/register,GET /domains/:domain/dns-records,POST /domains/:domain/verify,GET /domains/:domain/status,GET /domains?domain=,POST /domains/:domain/recreate,DELETE /domains/:domain,PUT /domains/:domain/sender,POST /domains/verify-email,GET /domains/verify-email/status - Activity:
GET /v1/activity,GET /v1/activity/:id - Datos:
POST /v1/leads,POST /v1/events(y el resto de la API de leads y eventos)
Ejemplo
curl -X POST https://api.reallyquickemails.com/v1/send-email \
-H "Authorization: Bearer sk_proj_tu_secret_key" \
-H "Content-Type: application/json" \
-d '{
"recipient_email": "cliente@ejemplo.com",
"sender_email": "ventas@tudominio.com",
"subject": "Confirmación de pedido",
"html_body": "<h1>Pedido confirmado</h1>"
}'Como funciona
- El servidor extrae la Secret Key del header
Authorization - Valida la key y resuelve el proyecto asociado
- Si la key es válida, el
projectIdse deriva automáticamente — no necesitas enviarlo
Donde encontrar tu Secret Key
- Ingresa al dashboard de RQE.
- Selecciona tu proyecto.
- En el menú lateral, abre Integraciones → API Keys.
- Copia tu Secret Key (comienza con
sk_proj_).
Ahí también encuentras la Test key (sk_test_*). Ver API Keys para las diferencias entre modo Live y Test.
Respuestas de error
Key faltante o formato incorrecto (401):
{
"error": "Missing or invalid API key. Use: Authorization: Bearer sk_proj_..."
}Key inválida (401):
{
"error": "Invalid API key"
}Errores comunes
| Código | Causa | Solución |
|---|---|---|
401 | Falta el header Authorization | Agrega Authorization: Bearer sk_proj_... |
401 | Formato incorrecto (sin "Bearer " o sin prefijo sk_) | Asegúrate de usar Bearer sk_proj_... con espacio |
401 | Key inválida o revocada | Regenérala desde Integraciones → API Keys en el dashboard |