Autenticación con API Keys
Genera y gestiona API keys para acceder a la API de LectorAI de forma programática.
Formato de API Key
Las API keys de LectorAI tienen el siguiente formato:
El prefijo lector_ te permite identificar fácilmente las keys de LectorAI en tu código y logs.
Crear una API Key
- Ve a Configuración
- Busca la sección "API Keys"
- Click en "Crear nueva API Key"
- Dale un nombre descriptivo (ej: "Bot de Telegram", "CI/CD")
- Copia la key inmediatamente - solo se muestra una vez
La API key completa solo se muestra una vez al crearla. Si la pierdes, deberás crear una nueva.
Usar la API Key
curl -X GET "https://lectorai.curetcore.com/api/books" \ -H "Authorization: Bearer lector_tu_api_key_aqui"
import { LectorAI } from '@lectorai/sdk';
const client = new LectorAI({
apiKey: process.env.LECTORAI_API_KEY
});
const books = await client.books.list();const response = await fetch(
'https://lectorai.curetcore.com/api/books',
{
headers: {
'Authorization': `Bearer ${apiKey}`
}
}
);
const data = await response.json();Mejores Prácticas de Seguridad
Usa variables de entorno
Nunca incluyas API keys directamente en tu código. Usa variables de entorno como LECTORAI_API_KEY.
Una key por aplicación
Crea una API key diferente para cada aplicación o servicio. Así puedes revocar acceso individualmente si es necesario.
Rota keys periódicamente
Considera rotar tus API keys cada 90 días. Crea una nueva, actualiza tu aplicación, y luego revoca la antigua.
No compartas keys
Nunca compartas API keys en chats, emails, o repositorios públicos. Si una key se expone, revócala inmediatamente.
Gestionar API Keys
// Listar todas tus API keys
GET /api/keys
Authorization: Bearer lector_xxx
// Respuesta
{
"keys": [
{
"id": "key_abc123",
"name": "Bot de Telegram",
"prefix": "lector_abc1", // Solo el prefijo
"createdAt": "2024-01-15T10:00:00Z",
"lastUsedAt": "2024-01-15T15:30:00Z"
}
]
}
// Revocar una API key
DELETE /api/keys/key_abc123
Authorization: Bearer lector_xxxLímites de Uso
| Plan | Requests/min | API Keys |
|---|---|---|
| Free | 60 | 2 |
| Pro | 300 | 10 |
| Business | 1000 | 50 |
| DEV | Sin límite | Sin límite |
Headers de rate limit incluidos en cada respuesta:
X-RateLimit-Limit: 300 X-RateLimit-Remaining: 295 X-RateLimit-Reset: 1705320000
¿Eres Developer?
Los usuarios con rol DEVpueden configurar sus propias API keys de OpenAI y Anthropic para traducir sin límites.
Ver cómo configurar API keys personales →