Autenticación

Cada solicitud al Curriculo API lleva su clave de Consola de Desarrollador como token de portador:

Authorization: Bearer key_<id>_<secret>

curl -X POST https://api.curriculo.me/public/detect-language/ \
  -H 'Authorization: Bearer key_abc123_yoursecret' \
  -H 'Content-Type: application/json' \
  -d '{"text": "Ingeniera de software con diez años de experiencia"}'

Una clave, cada operación

Una clave de consola funciona para cada operación en el momento de su creación. No hay credenciales por endpoint, no hay ámbitos y no hay solicitudes por capacidad. No hay inicio de sesión ATS, no hay cookie de sesión y no hay encabezado de organización involucrado.

Obtención de claves API

Inicie sesión en la consola de desarrollador y abra API claves.

• Cada clave puede llevar un nombre y una caducidad opcional. Una clave sin caducidad funciona hasta que la revoca.
• El valor de texto plano se devuelve una vez, en el momento de la creación. Solo se almacena un prefijo de 16 caracteres y un hash de SHA-256, por lo que una clave perdida se reemplaza, nunca se recupera.
• La revocación es inmediata. La próxima solicitud con una clave revocada obtiene 401.
• Una cuenta puede tener hasta 25 claves activas.

Lo que una clave necesita para servir tráfico

Una clave es aceptada cuando su cuenta:

• ha terminado de provisionarse (esto sucede en el primer inicio de sesión);
• tiene un saldo de crédito prepagado superior a cero (las nuevas cuentas comienzan con un crédito gratuito de $5.00);
• no está suspendida.

Higiene de clave

Tratar una clave API como una contraseña. Nunca comprometerla en el control de versiones ni pegarla en un cliente no confiable, y revocarla tan pronto como se exponga.

• Emisión de claves separadas por entorno o equipo para mantener el uso atribuible y cada clave revocable de forma independiente.
• Las claves están limitadas a su organización y no ven nada más.
• Una clave no puede gestionar la cuenta. No puede acuñar claves ni cambiar la facturación, por lo que una clave filtrada nunca puede escalar a control de cuenta.

Errores de autenticación

Vea Errores para la lista completa.