Pular para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.clipping.cc/llms.txt

Use this file to discover all available pages before exploring further.

A API usa API keys no header Authorization, no esquema Bearer: 
Authorization: Bearer ck_live_SEU_SEGREDO

​
Gerenciando keys

As keys são criadas e revogadas pelo painel em clipping.cc/account:
  • Criar: o segredo completo (ck_live_…) aparece uma vez. O servidor guarda só um hash — não há como recuperá-lo depois.
  • Revogar: imediato. Requests com a key revogada passam a falhar com 401.
  • Você pode ter várias keys (ex.: uma por ambiente/integração).
Use uma key por integração e dê nomes descritivos. Assim, se uma vazar, você revoga só ela sem derrubar as outras.

​
Erros de autenticação

StatusSignificado
401Key ausente, inválida ou revogada.
402Key válida, mas a conta está sem saldo. Veja cobrança.
Exemplo de corpo de erro: 
{ "erro": "API key inválida ou ausente — use Authorization: Bearer ck_live_…" }

​
Escopo de acesso

A key herda o acesso da sua conta: você lê os seus items, coleções e reporters, além do que for público via discover. Não há (ainda) escopos por permissão — uma key tem o mesmo alcance de leitura que você.