Saltearse al contenido
ALTCHA ALTCHA ALTCHA

Claves de API

Las claves de API autorizan el acceso a la API y deben incluirse en cada solicitud. Hay dos tipos:

  • Claves de API de pago (que comienzan con key_...)
  • Claves de API gratuitas (que comienzan con ckey_..., donde c significa criptográfico)

Crear una nueva clave de API

Para obtener una Clave de API de pago, siga estos pasos:

  1. Regístrese para obtener una cuenta en la aplicación ALTCHA en eu.altcha.org para los clientes de la UE, o en us.altcha.org para los clientes de EE. UU.

  2. Después del registro, cree un nuevo proyecto.

  3. Abra el proyecto recién creado y vaya a la configuración del proyecto:

  4. Haga clic en “Crear clave de API”, establezca un nombre y haga clic en “Guardar”.

Configurar claves de API

Al crear una nueva clave de API, verá varias opciones de configuración:

  • Nombre: Un nombre personalizado para ayudar a identificar la clave.
  • Secreto: Un secreto de clave para verificación criptográfica, generado aleatoriamente de forma predeterminada.
  • Límite de tasa: Un límite de tasa opcional aplicado a todas las solicitudes autenticadas con esta clave.
  • Dominios de referencia: Una lista opcional de nombres de dominio permitidos. Ingrese un dominio por línea. Para puertos no estándar, formatee como <dominio>:8080.
  • Funcionalidades: Habilitar funcionalidades específicas para esta clave de API.

Límites de tasa

Puede configurar límites de tasa personalizados para cada clave de API, expresados como solicitudes por intervalo (<solicitudes>/<intervalo>). Por ejemplo:

  • 100/120s: Limita a 100 solicitudes por 120 segundos.
  • 100/10m: Limita a 100 solicitudes por 10 minutos.
  • 10/1h: Limita a 10 solicitudes por 1 hora.
  • 10/1d: Limita a 10 solicitudes por día.

Dejar el campo Límite de tasa vacío permitirá solicitudes ilimitadas, pero aún se aplicarán los límites de tasa globales.

Funcionalidades

Cada clave de API debe tener al menos una funcionalidad seleccionada. Solo las funcionalidades seleccionadas estarán accesibles con la clave.