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.

Uma coleção pode ser paga: o dono (creator) define um preço, e fãs pagam pra liberar o conteúdo. O pagamento vai pros earnings do creator, menos a taxa de plataforma.

Defina um preço (creator)

A coleção precisa ser pública, aí defina price_coins e um billing_period:
curl -X PATCH https://api.clipping.cc/v1/collections/col_123 \
  -H "Authorization: Bearer ck_live_…" -H "Content-Type: application/json" \
  -d '{ "visibility": "public", "price_coins": 20, "billing_period": "monthly" }'
billing_periodAcesso
oncevitalício — paga uma vez, mantém o acesso
monthlyrenova a cada 30 dias (cobrança automática)
price_coins: 0 deixa grátis de novo (uma coleção pública volta ao normal, gated só pelas flags expose_* de Coleções).

Assine (fã)

Um fã assina — isso cobra o preço na hora e libera o acesso:
curl -X POST https://api.clipping.cc/v1/collections/col_123/subscribe \
  -H "Authorization: Bearer ck_live_…"
{ "subscription": { "subscription_id": "sub_…", "status": "active",
                    "billing_period": "monthly", "price_coins": 20,
                    "expires_at": 1719500000 } }
Erros possíveis:
StatusQuando
400coleção não é paga, não é pública, ou você é o dono
402saldo insuficiente pra pagar o preço
409você já assina

Veja suas assinaturas

curl https://api.clipping.cc/v1/collections/subscriptions \
  -H "Authorization: Bearer ck_live_…"
Numa assinatura once o expires_at é null (vitalícia); numa monthly é a data de renovação. Acesso ao conteúdo gated é: dono, ou coleção grátis, ou uma assinatura ativa.