Saltar al contenido

Autenticación

En esta página

Cada solicitud a la Curriculo API lleva su clave de la consola de desarrolladores como token 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 llave, cada operación

Una llave de consola funciona para cada operación en el momento en que se crea. No hay credenciales por punto final, 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.

Obtener las llaves de API

Ingrese a la consola de desarrollo y abra las teclas API.

  • Cada llave lleva un nombre y un de caducidad opcional. Una llave sin caducidad funciona hasta que la revoques.
  • El valor de texto en blanco se devuelve una vez, en la creación. Solo se almacena un prefijo de 16 caracteres y un hash SHA-256, por lo que se reemplaza una clave perdida, nunca se recupera.
  • La revocación es inmediata. La siguiente solicitud con una clave revocada obtiene 401.
  • Una cuenta puede contener hasta 25 claves no revocadas.

Qué necesita una llave para servir al tráfico

Se acepta una llave cuando su cuenta:

  • ha terminado el aprovisionamiento (esto ocurre al 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 clave

Trata una llave API como una contraseña. Nunca se comprometa a la fuente de control o pegarlo en un cliente no confiable, y revocarlo tan pronto como se expone.

  • Emite llaves separadas por entorno o equipo para mantener el uso atribuible y cada llave revocable de forma independiente.
  • Las claves son escopadas a su cuenta y no ven nada más.
  • Una llave no puede administrar la cuenta. No puede acuñar llaves o cambiar la facturación, por lo que una llave filtrada nunca puede escalar en control de cuenta.

Errores de autenticación

EstatusMensaje¿Qué hacer?
401"Falta el token API... "Envía el encabezado Authorization: Bearer .
401"Invalido token API".La llave es desconocida o revocada. Crear una nueva llave.
401"El token API expiró".La llave pasó su vencimiento. Crear una nueva llave.
401"Punto final desconocido de API"El camino bajo /public/ no existe. Compruebe la ortografía.
403No hay crédito prepagado ("...Comprar créditos en la consola.")Añadir crédito en Console → facturación.
403Cuenta suspendidaPóngase en contacto.
403"La provisión de cuentas no está completa"Abrir la consola de nuevo para volver a intentar la provisión, o contactarnos.

Ver Errores para la lista completa.

¿Te ha resultado útil esta página?

Actualizado