Autenticação
Como autenticar suas requisições e selecionar o workspace
Toda requisição à API precisa de uma chave de API.
Gerando sua chave
Acesse Chaves de API nas configurações da sua conta e clique em Nova chave. Guarde a chave em local seguro: ela não é exibida de novo depois de criada.
A chave dá acesso aos créditos e às contas conectadas do workspace. Mantenha-a no servidor, em variável de ambiente, nunca no código do navegador ou do app.
Enviando a chave
Envie a chave em todas as requisições, de uma das duas formas:
curl https://api.cut.pro/api/v1/workspace \
-H "X-Api-Key: $CUTPRO_API_KEY"curl https://api.cut.pro/api/v1/workspace \
-H "Authorization: Bearer $CUTPRO_API_KEY"O limite de requisições é por chave, e toda resposta traz quanto sobrou dele nos headers X-RateLimit-Remaining e X-RateLimit-Reset. Veja Erros e limites.
Chave ausente, revogada ou inválida volta assim:
{ "code": "UNAUTHORIZED" }Workspaces
Uma chave de API é vinculada a um ou mais workspaces (tokens com escopo, no estilo Cloudflare). Créditos, submissões, clipes e renders sempre pertencem ao workspace que a requisição resolver.
Toda requisição opera nesse workspace automaticamente. Nenhum header extra é necessário.
Chame GET /workspace para inspecionar qual workspace a requisição atual resolveu, junto com o plano e o seu papel nele.
Conexões sociais
As contas sociais conectadas (TikTok, Instagram, YouTube e as demais) são os IDs que você passa como connection_id ao criar um post. O ciclo de vida das conexões não é exposto pela API: para conectar uma nova conta, entre em cut.pro e use o fluxo de OAuth dentro do app.