{"name":"DoglyTdc Scripts API","version":1,"base_url":"https://api.doglytdc.dev/v1","index_url":"https://api.doglytdc.dev/scripts.json","authentication":{"header":"Authorization: Bearer <token>","credentials":[{"type":"script_token","prefix":"dts_","how":"Painel Dev › API › Gerar token. Vale só para aquele script, com todos os escopos."},{"type":"oauth2","how":"Hub OAuth2 com PKCE: https://doglytdc.dev/oauth2/authorize (mesmo fluxo de /v1/hub). Peça os escopos abaixo."},{"type":"session","how":"Sessão do DoglyTdc (usada pelo painel). Rotas marcadas como session aceitam só esta."}]},"scopes":{"scripts.read":"Ver seus scripts, código, commits, funções e coleções","scripts.write":"Criar e editar scripts, fazer commits e gerenciar webhooks","functions.deploy":"Publicar o backend (funções e coleções) dos scripts","ai":"Usar a IA DoglyTdc com os créditos do dono do script","scripts.publish":"Publicar versões protegidas e voltar para versões anteriores","users.manage":"Ver quem usa seus scripts e banir, desativar ou reativar"},"errors":{"format":"{ code, message, errors? }","codes":["UNAUTHORIZED","MISSING_ACCESS","MISSING_SCOPE","UNKNOWN_SCRIPT","UNKNOWN_BRANCH","UNKNOWN_COMMIT","UNKNOWN_FILE","UNKNOWN_FUNCTION","UNKNOWN_COLLECTION","UNKNOWN_DOCUMENT","UNKNOWN_WEBHOOK","INVALID_FORM_BODY","HEAD_MOVED","NOTHING_TO_COMMIT","PAYLOAD_TOO_LARGE","RATE_LIMITED","INSUFFICIENT_CREDITS","AI_FAILED","INTERNAL"]},"webhooks":{"events":["repo.commit","functions.deploy","access.granted","ping"],"headers":["X-DoglyTdc-Signature","X-DoglyTdc-Timestamp","X-DoglyTdc-Event","X-DoglyTdc-Delivery"],"signature":"sha256=hex(HMAC_SHA256(secret, timestamp + \".\" + raw_body)); rejeite timestamps com mais de 5 minutos","body":"{ id, event, script_id, created_at, data }","retries":"3 tentativas (0s, 1s, 3s); desativa após 10 falhas seguidas"},"endpoints":[{"method":"GET","path":"/scripts/@me","auth":{"scopes":["scripts.read"]},"summary":"Lista seus scripts (dono ou colaborador). Com token de script, só o próprio.","response":"Script[]"},{"method":"POST","path":"/scripts","auth":{"scopes":["scripts.write"]},"summary":"Cria um script na sua conta (repositório privado).","body":"{ title, description?, type?, category? }","response":"Script"},{"method":"GET","path":"/scripts/{script_id}","auth":{"scopes":["scripts.read"]},"summary":"Dados do script.","response":"Script"},{"method":"PATCH","path":"/scripts/{script_id}","auth":{"scopes":["scripts.write"]},"summary":"Edita título, descrição, categoria e tags.","body":"{ title?, description?, category?, tags? }","response":"Script"},{"method":"DELETE","path":"/scripts/{script_id}","auth":"session","summary":"Apaga o script. Só o dono, só pelo painel.","response":"204"},{"method":"GET","path":"/scripts/{script_id}/public","auth":"none","summary":"Perfil público do script (sem código privado). Sem autenticação.","response":"Script"},{"method":"GET","path":"/scripts/{script_id}/token","auth":"session","summary":"Diz se existe token e o prefixo. Nunca devolve o valor.","response":"{ exists, prefix, created_at, last_used_at }"},{"method":"POST","path":"/scripts/{script_id}/token/reset","auth":"session","summary":"Gera um token novo (dts_…). Mostrado uma vez; o anterior deixa de valer. Só o dono.","response":"{ token, prefix }"},{"method":"DELETE","path":"/scripts/{script_id}/token","auth":"session","summary":"Revoga o token do script. Só o dono.","response":"204"},{"method":"GET","path":"/scripts/{script_id}/repo/branches","auth":{"scopes":["scripts.read"]},"summary":"Branches do repositório.","response":"{ name, head_sha, is_default, created_by, updated_at }[]"},{"method":"POST","path":"/scripts/{script_id}/repo/branches","auth":{"scopes":["scripts.write"]},"summary":"Cria uma branch a partir de um commit (padrão: head da main).","body":"{ name, from? }","response":"{ name, head_sha }"},{"method":"GET","path":"/scripts/{script_id}/repo/tree","auth":{"scopes":["scripts.read"]},"summary":"Lista de arquivos de um ref.","query":"ref? (branch ou sha)","response":"{ ref, sha, files: { path, hash, size }[] }"},{"method":"GET","path":"/scripts/{script_id}/repo/files/{path*}","auth":{"scopes":["scripts.read"]},"summary":"Conteúdo de um arquivo. ?raw=1 devolve texto puro.","query":"ref?, raw?","response":"{ ref, sha, path, hash, content }"},{"method":"GET","path":"/scripts/{script_id}/repo/commits","auth":{"scopes":["scripts.read"]},"summary":"Histórico (primeiro pai), opcionalmente filtrado por arquivo.","query":"ref?, path?, limit? (1-100, padrão 30)","response":"Commit[]"},{"method":"GET","path":"/scripts/{script_id}/repo/commits/{sha}","auth":{"scopes":["scripts.read"]},"summary":"Um commit com a lista de arquivos alterados.","response":"Commit & { files: { path, status }[] }"},{"method":"POST","path":"/scripts/{script_id}/repo/commits","auth":{"scopes":["scripts.write"]},"summary":"Grava arquivos num commit. content:null apaga. expected_head evita sobrescrever trabalho alheio (409 HEAD_MOVED). Na branch padrão publica o backend; mexer em supabase/ exige functions.deploy.","body":"{ branch?, expected_head, message, description?, changes: { path, content|null }[] }","response":"{ commit, branch, deploy? }"},{"method":"GET","path":"/scripts/{script_id}/functions","auth":{"scopes":["scripts.read"]},"summary":"Funções publicadas de supabase/functions/.","response":"{ name, status, error, live_sha, updated_at, last_run_at, url }[]"},{"method":"POST","path":"/scripts/{script_id}/deploy","auth":{"scopes":["functions.deploy"]},"summary":"Publica de novo o backend a partir da branch padrão.","response":"{ sha, functions, removed, collections, error }"},{"method":"POST","path":"/scripts/{script_id}/functions/{name}","auth":{"scopes":["scripts.read"]},"summary":"Chama uma função como o usuário do token (request.user = @username). Corpo vira request.body.","query":"repassada em request.query","body":"qualquer JSON","response":"o que a função responder"},{"method":"GET","path":"/scripts/{script_id}/collections","auth":{"scopes":["scripts.read"]},"summary":"Coleções de supabase/collections.json e suas regras.","response":"{ name, read_rule, write_rule }[]"},{"method":"GET","path":"/scripts/{script_id}/collections/{collection}/documents","auth":{"scopes":["scripts.read"]},"summary":"Lista documentos (regras do collections.json valem).","query":"limit?, offset?, order?","response":"Document[]"},{"method":"POST","path":"/scripts/{script_id}/collections/{collection}/documents","auth":{"scopes":["scripts.write"]},"summary":"Cria um documento.","body":"{ data: object }","response":"Document"},{"method":"GET","path":"/scripts/{script_id}/collections/{collection}/documents/{doc_id}","auth":{"scopes":["scripts.read"]},"summary":"Um documento.","response":"Document"},{"method":"PATCH","path":"/scripts/{script_id}/collections/{collection}/documents/{doc_id}","auth":{"scopes":["scripts.write"]},"summary":"Substitui os dados do documento.","body":"{ data: object }","response":"Document"},{"method":"DELETE","path":"/scripts/{script_id}/collections/{collection}/documents/{doc_id}","auth":{"scopes":["scripts.write"]},"summary":"Apaga o documento.","response":"204"},{"method":"GET","path":"/scripts/{script_id}/webhooks","auth":{"scopes":["scripts.read"]},"summary":"Webhooks de eventos do script.","response":"Webhook[]"},{"method":"POST","path":"/scripts/{script_id}/webhooks","auth":{"scopes":["scripts.write"]},"summary":"Cria um webhook (máx. 5). A chave de assinatura (whsec_…) aparece só nesta resposta. Assinatura: X-DoglyTdc-Signature = sha256=HMAC_SHA256(chave, \"X-DoglyTdc-Timestamp.corpo\").","body":"{ url (https público), events?: (repo.commit | functions.deploy | access.granted)[] }","response":"{ webhook, secret }"},{"method":"PATCH","path":"/scripts/{script_id}/webhooks/{webhook_id}","auth":{"scopes":["scripts.write"]},"summary":"Muda URL, eventos ou ativa/desativa.","body":"{ url?, events?, active? }","response":"Webhook"},{"method":"DELETE","path":"/scripts/{script_id}/webhooks/{webhook_id}","auth":{"scopes":["scripts.write"]},"summary":"Apaga o webhook.","response":"204"},{"method":"POST","path":"/scripts/{script_id}/webhooks/{webhook_id}/test","auth":{"scopes":["scripts.write"]},"summary":"Envia um evento \"ping\" agora.","response":"Delivery"},{"method":"GET","path":"/scripts/{script_id}/webhooks/{webhook_id}/deliveries","auth":{"scopes":["scripts.read"]},"summary":"Últimas 50 entregas.","response":"Delivery[]"},{"method":"GET","path":"/scripts/{script_id}/logs","auth":{"scopes":["scripts.read"]},"summary":"Últimas 100 chamadas desta API para o script (sem corpo nem token).","response":"{ method, route, status, ms, credential, created_at }[]"},{"method":"POST","path":"/ai/chat","auth":{"scopes":["ai"]},"summary":"IA DoglyTdc (openai/gpt-6-astra, sem troca de modelo). Cobra créditos reais do dono do script. stream:true devolve SSE no formato OpenAI.","body":"{ script_id? (obrigatório fora do token de script), messages: { role, content }[], max_tokens?, stream? }","response":"{ model, content, usage, credits } | text/event-stream"},{"method":"GET","path":"/oauth2/@me/authorizations","auth":"session","summary":"Apps autorizados na sua conta (mesmas autorizações do Hub OAuth).","response":"{ id, application: { id, name, icon_url }, scopes, created_at }[]"},{"method":"DELETE","path":"/oauth2/@me/authorizations/{authorization_id}","auth":"session","summary":"Revoga um app autorizado e todos os tokens dele.","response":"204"}],"examples":[{"title":"Ler um arquivo","request":"curl -H \"Authorization: Bearer dts_…\" https://api.doglytdc.dev/v1/scripts/{script_id}/repo/files/src/script.js?raw=1"},{"title":"Commit com proteção de corrida","request":"curl -X POST -H \"Authorization: Bearer dts_…\" -H \"Content-Type: application/json\" https://api.doglytdc.dev/v1/scripts/{script_id}/repo/commits -d '{\"expected_head\":\"<head_sha de GET /repo/branches>\",\"message\":\"Atualiza script\",\"changes\":[{\"path\":\"src/script.js\",\"content\":\"console.log(1)\"}]}'"},{"title":"IA","request":"curl -X POST -H \"Authorization: Bearer dts_…\" -H \"Content-Type: application/json\" https://api.doglytdc.dev/v1/ai/chat -d '{\"messages\":[{\"role\":\"user\",\"content\":\"Oi\"}]}'"}]}