Crear Personal Access Token
POST/tokens
Genera un nuevo Personal Access Token para el usuario autenticado. El valor (data.token) solo se expone en esta respuesta: guárdelo de inmediato. Límite: 10 intentos por usuario (por defecto) en una ventana de 24 horas contada desde el primero; cuentan todas las peticiones autenticadas a este endpoint, incluidas las rechazadas con 422 o 500, no solo las creaciones exitosas. Al superarlo responde 429. Aplica además el límite general de la API (60 peticiones por minuto).
Request
Responses
- 200
- 401
- 422
- 429
- 500
Token creado
No autenticado: token Bearer ausente, inválido, expirado o revocado. El mensaje es siempre No autenticado.
Validación fallida. Mensajes: El nombre del token es requerido., El nombre debe tener al menos 3 caracteres., El nombre no puede exceder los 255 caracteres., La duración debe ser un número entero de días., La duración mínima es 1 día., La duración máxima es 365 días., El campo name debe ser una cadena de caracteres., El campo abilities debe ser un array., El campo abilities.N debe ser una cadena de caracteres. (N es la posición del elemento). expires_in_days no admite null (ni cadena vacía): enviarlo así responde en errors.expires_in_days los mensajes La duración debe ser un número entero de días. y La duración mínima es 1 día.; omítalo para usar el valor por defecto.
Límite de creación de tokens alcanzado (10 intentos en 24 horas por defecto). Esta respuesta no incluye la cabecera Retry-After. También puede responder 429 por el límite general de la API (60 peticiones por minuto); en ese caso el cuerpo es ThrottleErrorResponse ({"message": "Too Many Attempts."}, sin success) e incluye las cabeceras Retry-After, X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset (marca de tiempo Unix del momento en que se libera el límite).
Error interno al emitir el token (p. ej. abilities con un valor distinto de *). Lo responde el manejador de errores estándar: en producción, con Accept: application/json, el cuerpo es solo {"message": "Server Error"} (sin success).