Saltearse al contenido

Claves API gratuitas

Las Claves API gratuitas están disponibles sin costo alguno, ofreciendo acceso limitado a la API AntiSpam.

Condiciones para las Claves API gratuitas:

Acceso gratuito vs. de pago

Al actualizar a Claves API pagas, desbloquearás funciones adicionales como Analíticas de API y Registros, lo que te permitirá monitorear el uso de la API para tus sitios web y aplicaciones.

FunciónGratisPagado
Límite de solicitudes50 solicitudes/díaBasado en el volumen comprado
Restricciones de referentesUn referente por claveAjustable
Analíticas de APINo
Registros de solicitudes de APINo
Atribución requeridaNo

Generando una Clave API gratuita

Las Claves API gratuitas están vinculadas a un nombre de dominio específico y solo funcionan en sitios web alojados en el nombre de dominio proporcionado.

Generar una Clave API gratuita
Si estás utilizando un número de puerto no estándar, introduce el nombre de dominio y el puerto en este formato: ejemplo.com:3000.

El servidor generará una nueva Clave API gratuita y un secreto:

{
"hostname": "ejemplo.com",
"apiKey": "ckey_49960de...",
"secret": "csec_55de16dde79f94...",
"licencia": "...",
"verificación": {
"DNS": {
"nombre": "@",
"tipo": "TXT",
"valor": "altcha-verification=..."
}
}
}

El secreto csec_... se utiliza para la verificación del payload (como secreto HMAC) y debe permanecer confidencial, nunca expuesto públicamente.

Consulta la documentación para aprender cómo generar una nueva Clave API utilizando la API.

Verificación de Dominio

Aunque es opcional, se recomienda encarecidamente la verificación del dominio. Verificar la propiedad de tu nombre de dominio a través del registro TXT de DNS configurado con el valor proporcionado altcha-verification=... agrega una capa adicional de seguridad.

La verificación del dominio asegura que tu Clave API esté asociada adecuadamente con el nombre de dominio con el que se pretende funcionar.

Para verificar tu nombre de dominio, sigue estos pasos:

  1. Accede a tu panel de gestión de registros DNS.
  2. Agrega un registro TXT con los siguientes detalles:
    • Tipo de registro: TXT
    • Host/Nombre: @ (o tu nombre de dominio)
    • Valor/Texto: altcha-verification=abc... (sustituye abc... con tu token de verificación único obtenido al generar la Clave API)
  3. Guarda los cambios.

Una vez que el registro de DNS se haya agregado y propagado con éxito, la propiedad del dominio se verificará. Esto asegura el uso seguro de tu Clave API con el nombre de dominio especificado.

Atribución para las Claves API gratuitas

Al usar la Clave API gratuita, DEBES mostrar “Protegido por ALTCHA” junto con el logotipo en el widget (es decir, no uses hidelogo o hidefooter). Si no estás utilizando el widget, DEBES incluir una atribución en el pie de página de tu sitio web, al menos en la página de inicio:

<a href="https://altcha.org">Protegido por ALTCHA</a>

Puedes traducir o modificar el texto, pero debe transmitir un significado similar a “Protegido por ALTCHA”. El enlace debe dirigir a https://altcha.org y no debe incluir rel="nofollow".

Atribución de Clave API gratuita

No ocultes el logotipo y el pie de página con Claves API gratuitas