Uma chave de API parece uma cadeia aleatória, mas a do Qomni conta uma
história: sk_agents_live_co1_8fK2…Qa91Zx. Cada parte está ali por uma razão
concreta, e as razões são o tema desta nota.
O produto, na chave
Cada produto do Qomni tem sua API, seu consumo e sua fatura. Uma chave vale
para um único produto. Com uma chave do Agents você pode chamar
api.qomni.ai/agents/v1 e nada mais; em outra API falha com
401 api_key_wrong_product.
É uma decisão de superfície de ataque. Um sistema que cria chamadas recebe uma chave do Agents e, se essa chave vazar, o atacante não entra no app web nem na conta. E revogar uma chave não toca nas demais.
O modo, na chave
live ou test não é uma configuração da conta: quem decide é a chave. Uma chave
de teste trabalha sobre dados separados, não disca nenhum número e não fatura.
O código é o mesmo; muda uma variável de ambiente. Assim, o que você testa
é exatamente o que vai rodar em produção.
A célula, para não consultar nada
co1 diz onde vivem os dados do workspace. O edge lê esse prefixo e
envia a requisição à célula correta sem buscar em nenhum banco de dados.
É a razão pela qual a URL da API nunca carrega região.
O checksum, para falhar cedo
Os últimos seis caracteres são um CRC32 do restante, em base62. Uma chave mal
copiada é rejeitada no edge, com 401 api_key_malformed, antes de chegar a
qualquer servidor. O suporte reconhece esse erro sem olhar mais nada.
O que não está na chave
O Qomni guarda só o hash SHA-256 de cada chave. Por isso a chave completa é mostrada uma única vez, ao criá-la, e depois só se veem seu prefixo e seus últimos quatro caracteres. Uma chave perdida não se recupera: cria-se outra e revoga-se a anterior.
E os limites
Cada chave tem seu próprio orçamento: 120 requisições por minuto. As
requisições rejeitadas com 401 são contadas à parte, por endereço IP, para que
um cliente mal configurado não esgote o orçamento das chaves válidas da
mesma rede.
A anatomia completa está em Chaves de API e autenticação.
Receba um aviso a cada artigo novo
Uma nota de engenharia a cada publicação; nada mais.