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.

1. Crie uma API key

Acesse clipping.cc/account, vá em API keys e clique em criar key. O segredo (ck_live_…) é mostrado uma única vez — copie e guarde num lugar seguro. Se perder, revogue e crie outra.
A key carrega acesso à sua conta e consome do seu saldo. Trate como senha: nunca exponha em código de frontend ou repositórios públicos.

2. Garanta saldo na conta

Cada chamada consome do saldo da conta dona da key. Sem saldo, a API responde 402 Payment Required. Adicione coins em clipping.cc/balance. Veja cobrança pra entender os preços.

3. Faça a primeira chamada

Confirme a key chamando /v1/me:
curl https://api.clipping.cc/v1/me \
  -H "Authorization: Bearer ck_live_SEU_SEGREDO"
Resposta:
{
  "user_id": "…",
  "key_id": "…",
  "balance_microcoins": 1000000,
  "balance_coins": 1.0
}

4. Explore

# seus items
curl https://api.clipping.cc/v1/items \
  -H "Authorization: Bearer ck_live_SEU_SEGREDO"

# busca semântica no seu acervo
curl "https://api.clipping.cc/v1/search?q=inteligencia%20artificial" \
  -H "Authorization: Bearer ck_live_SEU_SEGREDO"
Veja todos os endpoints na aba Referência da API (menu superior).