> ## Documentation Index
> Fetch the complete documentation index at: https://docs.doglytdc.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# API do Scripts

> Endereço, autenticação, escopos, limites e webhooks da API do Scripts.

A **API do Scripts** dá acesso aos seus scripts por HTTP: código, branches, commits, funções do backend, coleções, webhooks, IA e o Studio (versões, usuários, configuração).

## Endereço

```text theme={null}
https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-scripts-api
```

O índice completo, legível por máquina, fica em [`/scripts.json`](https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-scripts-api/scripts.json) (sem autenticação).

## Autenticação

Envie `Authorization: Bearer <token>` em todo pedido.

| Credencial | Prefixo | Como obter |
| - | - | - |
| `script_token` | `dts_…` | Painel Dev › API › Gerar token. Vale só para aquele script, com todos os escopos. |
| `oauth2` | — | Hub OAuth2 com PKCE: [https://doglytdc.dev/oauth2/authorize](https://doglytdc.dev/oauth2/authorize) (mesmo fluxo de /v1/hub). Peça os escopos abaixo. |
| `session` | — | Sessão do DoglyTdc (usada pelo painel). Rotas marcadas como session aceitam só esta. |

> [!WARNING]
>
> Nunca coloque o token dentro do script que vai para os usuários. Ele dá acesso ao código e ao backend do script.

## Escopos

| Escopo | O que libera |
| - | - |
| `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 |

Faltando o escopo, a resposta é `403 MISSING_SCOPE`.

## Formato

* Pedidos e respostas em JSON (`Content-Type: application/json`).
* Erros: `{ "code": "…", "message": "…", "errors": { … } }`. `errors` aparece quando um campo está errado. Veja a [lista de erros](https://docs.doglytdc.dev/pt-BR/scripts/errors.md).
* Datas em ISO 8601 (UTC).
* Contas aparecem sempre como `@username`.

## Limites

| O quê | Limite |
| - | - |
| Chamadas autenticadas | 300 por minuto (por script com token de script, por conta nos demais) |
| Rotas públicas (sem login) | 120 por minuto por endereço |
| Commits | 30 por minuto por pessoa e script |
| Chamar função | 120 por minuto por pessoa e script |
| IA | 20 mensagens por minuto por pessoa e script |
| MCP | 120 mensagens por minuto por conta |

Ao passar, a resposta é `429 RATE_LIMITED` com `Retry-After: 60`.

## Webhooks

| Item | Valor |
| - | - |
| Eventos | `repo.commit`, `functions.deploy`, `access.granted`, `ping` |
| Cabeçalhos | `X-DoglyTdc-Signature`, `X-DoglyTdc-Timestamp`, `X-DoglyTdc-Event`, `X-DoglyTdc-Delivery` |
| Corpo | `{ id, event, script_id, created_at, data }` |
| Assinatura | `sha256=hex(HMAC_SHA256(chave, timestamp + "." + corpo_bruto))`; rejeite timestamps com mais de 5 minutos |
| Tentativas | 3 (na hora, depois de 1 s e de 3 s); o webhook é desativado depois de 10 falhas seguidas |

Conferir a assinatura (Node.js):

```js theme={null}
import crypto from "node:crypto";

function assinaturaValida(req, corpoBruto, chave) {
  const ts = req.headers["x-doglytdc-timestamp"];
  const sig = req.headers["x-doglytdc-signature"];
  if (Math.abs(Date.now() / 1000 - Number(ts)) > 300) return false;
  const esperado = "sha256=" + crypto.createHmac("sha256", chave).update(ts + "." + corpoBruto).digest("hex");
  return crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(esperado));
}
```

## Exemplos

### Ler um arquivo

```bash theme={null}
curl -H "Authorization: Bearer dts_…" https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-scripts-api/scripts/{script_id}/repo/files/src/script.js?raw=1
```

### Commit com proteção de corrida

```bash theme={null}
curl -X POST -H "Authorization: Bearer dts_…" -H "Content-Type: application/json" https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-scripts-api/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)"}]}'
```

### IA

```bash theme={null}
curl -X POST -H "Authorization: Bearer dts_…" -H "Content-Type: application/json" https://ucsyxzpdbnuyehizezvb.supabase.co/functions/v1/doglytdc-scripts-api/ai/chat -d '{"messages":[{"role":"user","content":"Oi"}]}'
```

## Rotas

> [card] [Scripts](https://docs.doglytdc.dev/pt-BR/scripts/api-reference/scripts.md)
>
> 6 rota(s)

> [card] [Token do script](https://docs.doglytdc.dev/pt-BR/scripts/api-reference/token.md)
>
> 3 rota(s)

> [card] [Repositório](https://docs.doglytdc.dev/pt-BR/scripts/api-reference/repository.md)
>
> 7 rota(s)

> [card] [Funções e publicação do backend](https://docs.doglytdc.dev/pt-BR/scripts/api-reference/backend.md)
>
> 3 rota(s)

> [card] [Coleções e documentos](https://docs.doglytdc.dev/pt-BR/scripts/api-reference/collections.md)
>
> 6 rota(s)

> [card] [Webhooks](https://docs.doglytdc.dev/pt-BR/scripts/api-reference/webhooks.md)
>
> 6 rota(s)

> [card] [IA e registros](https://docs.doglytdc.dev/pt-BR/scripts/api-reference/ai-and-logs.md)
>
> 2 rota(s)

> [card] [Apps autorizados](https://docs.doglytdc.dev/pt-BR/scripts/api-reference/authorizations.md)
>
> 2 rota(s)

> [card] [Studio](https://docs.doglytdc.dev/pt-BR/scripts/api-reference/studio.md)
>
> Versões, usuários, configuração


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.