API REST

• Base: https://app.oficina.protoncode.com.br/api/v1
• Autenticação: Authorization: Bearer pk_live_... (criar chave)
• Formato: JSON (UTF-8). Datas em milissegundos desde 1970 (UTC).
• Referência completa: Referência da API

Exemplo

curl https://app.oficina.protoncode.com.br/api/v1/service-orders?open=true \
  -H "Authorization: Bearer pk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: pedido-123" \
  -d '{"name": "Meu item"}'

Paginação

Listas devolvem { "data": [...], "next_cursor": "..." }. Para a próxima página, envie ?cursor=<next_cursor>. limit vai de 1 a 100 (padrão 50).

Erros

Erros seguem a RFC 9457 (application/problem+json):

{ "type": "about:blank", "title": "Bad Request", "status": 400, "detail": "name é obrigatório", "request_id": "3f9c2a..." }

Status	Significado
400	Dados inválidos — veja detail
401	Chave ausente, inválida ou revogada
403	A chave não tem a permissão necessária
404	Não encontrado (ou pertence a outra conta)
429	Muitas requisições — aguarde Retry-After segundos

Repetir com segurança (idempotência)

Envie Idempotency-Key nos POST. Repetir a mesma chamada com a mesma chave em até 24 h devolve a resposta original, sem duplicar.

Rastreamento

Envie o header traceparent se o seu sistema já usa tracing; nós continuamos o mesmo trace e devolvemos X-Trace-Id. Os webhooks gerados pela sua chamada levam o mesmo trace.