Pular para o conteúdo

Chaves de API Gratuitas

Chaves de API Gratuitas estão disponíveis sem custo algum, oferecendo acesso limitado à API AntiSpam.

Condições para Chaves de API Gratuitas:

Acesso Gratuito vs Acesso Pago

Atualizar para Chaves de API pagas desbloqueia recursos adicionais como Análises de API e Logs, permitindo que você monitore o uso da API para seus sites e aplicativos.

RecursoGratuitoPago
Limite de solicitações50 solicitações/diaBaseado no volume adquirido
Restrições de referênciaUma referência por chaveAjustáveis
Análises de APINãoSim
Logs de solicitação de APINãoSim
Atribuição necessáriaSimNão

Gerando uma Chave de API Gratuita

Chaves de API Gratuitas estão vinculadas a um nome de domínio específico e funcionam apenas em sites hospedados no nome de domínio fornecido.

Gerar uma Chave de API Gratuita
Se você estiver usando um número de porta não padrão, insira o nome de domínio e a porta nesse formato: exemplo.com:3000.

O servidor irá gerar uma nova Chave de API Gratuita e um segredo:

{
"hostname": "exemplo.com",
"apiKey": "ckey_49960de...",
"secret": "csec_55de16dde79f94...",
"license": "...",
"verification": {
"DNS": {
"name": "@",
"type": "TXT",
"value": "altcha-verification=..."
}
}
}

O segredo csec_... é usado para verificação de carga (como segredo HMAC) e deve permanecer confidencial, nunca exposto publicamente.

Consulte a documentação para aprender como gerar uma nova Chave de API usando a API.

Verificação de Domínio

Embora seja opcional, a verificação do domínio é altamente recomendada. Verificar a propriedade do seu nome de domínio via o registro DNS TXT configurado com o valor fornecido altcha-verification=... adiciona uma camada extra de segurança.

A verificação de domínio garante que sua Chave de API esteja apropriadamente associada ao nome de domínio com o qual se destina a funcionar.

Para verificar seu nome de domínio, siga estes passos:

  1. Acesse o painel de gerenciamento de registros DNS.
  2. Adicione um registro TXT com os seguintes detalhes:
    • Tipo de Registro: TXT
    • Host/Nome: @ (ou seu nome de domínio)
    • Valor/Texto: altcha-verification=abc... (substitua abc... pelo seu token único de verificação obtido ao gerar a Chave de API)
  3. Salve as alterações.

Depois que o registro DNS for adicionado com sucesso e propagado, a propriedade do domínio será verificada. Isso garante o uso seguro de sua Chave de API com o nome de domínio especificado.

Atribuição para Chaves de API Gratuitas

Ao usar a Chave de API Gratuita, VOCÊ DEVE exibir “Protegido por ALTCHA”, juntamente com o logotipo no widget (ou seja, não use hidelogo ou hidefooter). Se você não estiver usando o widget, DEVE incluir uma atribuição no rodapé do seu site, pelo menos na página inicial:

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

Você pode traduzir ou modificar o texto, mas ele deve transmitir um significado semelhante a “Protegido por ALTCHA”. O link deve direcionar para https://altcha.org e não deve incluir rel="nofollow".

Atribuição da Chave de API Gratuita

Não oculte o logo e o rodapé com as Chaves de API Gratuitas