As chaves de API deixam scripts, integrações e agentes de IA falar com a tua conta Caliu através da API REST em https://api.caliuapp.com.
Criar uma chave
- Na aplicação web: abre o menu de utilizador no fundo da barra lateral, escolhe Chaves de API e depois Nova chave de API. Dá-lhe um nome que te diga para que serve (por exemplo "O Meu Script").
- Na aplicação para iPhone e iPad e na aplicação para Mac: abre as Definições, depois Conta e depois Chaves de API.
Todas as chaves começam por caliu_. Copia-a logo: por segurança, o Caliu guarda apenas um hash da tua chave, por isso ela é mostrada exatamente uma vez. A lista mostra depois apenas um prefixo curto, mais quando cada chave foi criada e usada pela última vez.
Usá-la
Envia a chave como token Bearer no cabeçalho Authorization:
curl https://api.caliuapp.com/notes \
-H "Authorization: Bearer caliu_your_key_here"
Toda a superfície da API está documentada na documentação interativa. Consulta o artigo sobre documentação da API.
Revogar uma chave
Revoga qualquer chave a partir do mesmo ecrã onde a criaste. A revogação é imediata: qualquer aplicação que ainda use essa chave perde o acesso no pedido seguinte. Trata as chaves como palavras-passe e nunca as coloques em código submetido.