Explorar documentación
Autenticación mediante claves de API Bearer
Las solicitudes de desarrollo utilizan claves de API generadas desde la consola de control de TurnitPass.
Auth console
Mantén las claves API fuera del navegador.
Las llamadas a la API de TurnitPass usan una clave Bearer del espacio de trabajo. La clave pertenece al código solo de servidor; el panel sigue siendo el lugar para crear, rotar, revocar e inspeccionar el uso.
Protecciones de clave
Cómo mantener el acceso seguro
Solo servidor
Envía las claves desde rutas de backend, workers, jobs o server actions seguras.
Se muestra una vez
Copia la clave generada de inmediato y guárdala en tu gestor de secretos.
Rota con seguridad
Despliega la clave de reemplazo antes de revocar la clave de producción anterior.
Ámbito de cuenta
El uso se agrega al saldo de palabras y a los controles de facturación del espacio de trabajo.
Solicitud Bearer
Contrato de encabezado
fetch('https://turnitpass.com/api/v1/humanize', {
method: 'POST',
headers: {
Authorization: 'Bearer tp_live_your_api_key',
'Content-Type': 'application/json'
},
body: JSON.stringify({ text: draft, language: 'en' })
})
{
"error": "Invalid or revoked API key.",
"code": "invalid_api_key"
}
Claves API
Envía `Authorization: Bearer tp_your_api_key` con cada solicitud. Las claves se muestran una sola vez, se almacenan de forma segura y pueden revocarse desde la consola.
Authorization: Bearer tp_live_your_api_key
Content-Type: application/json
POST /api/v1/humanize
Managing keys
Crear
Genera una clave con nombre desde el espacio de trabajo y cópiala de inmediato.
Revocar
Desactiva una clave al instante. Las claves revocadas no pueden usarse en solicitudes nuevas.
Límites de ritmo
Cada clave puede limitarse de forma independiente mientras el uso se agrega a la cuenta.
Facturación
Todas las claves comparten el saldo de palabras y los límites de suscripción de la cuenta.
Propiedad del espacio de trabajo
Key lifecycle
Crea una clave con nombre
Usa un nombre que describa el entorno o la superficie, como Production backend, Staging worker o Internal QA.
Cópiala una vez en un almacén de secretos
TurnitPass muestra la clave solo en la creación. Guárdala en tu proveedor de despliegue, gestor de secretos de CI o archivo .env local.
Observa el uso con status y facturación
Todas las claves comparten el saldo de palabras; los nombres de clave facilitan identificar qué integración está activa.
Rota antes de revocar
Crea una clave de reemplazo, despliégala, confirma que el tráfico es saludable y luego revoca la clave anterior desde el espacio de trabajo.
Environment setup
Guarda las claves de TurnitPass como secretos solo de servidor. Los ejemplos siguientes usan nombres genéricos para encajar en Next.js, Workers, jobs de servidor o cualquier runtime de backend.
TURNITPASS_API_KEY=tp_live_your_api_key
TURNITPASS_API_BASE_URL=https://turnitpass.com/api/v1
Security best practices
Authentication errors
{
"error": "Invalid or revoked API key.",
"code": "invalid_api_key"
}