SAC/Support API

​

Visão Geral

​

Base URL

https://sac-waffle-v2.theo-110.workers.dev

​

Autenticação

​

Headers Obrigatórios

Authorization: Bearer {token}
Content-Type: application/json

​

Recursos Principais

​

1. Tickets de Suporte

• Criar e gerenciar tickets
• Upload de anexos
• Sistema de mensagens
• Tags e categorização
• Status e priorização

​

2. Respostas Rápidas

• Templates predefinidos
• Categorias organizadas
• Contador de uso
• Gestão de conteúdo

​

3. Relatórios e Métricas

• Exportação de dados
• Análise de desempenho
• Resumos estatísticos

​

4. Operações em Lote

• Atualização múltipla de status
• Exclusão em massa
• Mensagens em lote

​

Status de Tickets

​

Limites e Restrições

​

Anexos

• Tamanho máximo: 10MB por arquivo
• Tipos permitidos:
  • Imagens: image/jpeg, image/png, image/gif, image/webp
  • Documentos: application/pdf, text/plain
  • Planilhas: text/csv, application/vnd.ms-excel, application/vnd.openxmlformats-officedocument.spreadsheetml.sheet

​

Paginação

• Limite padrão: 10 itens por página
• Limite máximo: 100 itens por página

​

Tratamento de Erros

{
  "success": false,
  "message": "Descrição do erro",
  "error": "Código do erro (opcional)"
}

​

Códigos de Status HTTP

​

Rate Limiting

• Limite: 100 requisições por minuto por IP
• Headers de resposta: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset

​

Exemplos de Uso

​

Criar um Ticket

curl -X POST https://sac-waffle-v2.theo-110.workers.dev/support \
  -H "Content-Type: application/json" \
  -d '{
    "main": "Técnico",
    "issue": "Bug no sistema",
    "description": "Descrição detalhada do problema",
    "email": "[email protected]"
  }'

​

Listar Tickets

curl -X GET "https://sac-waffle-v2.theo-110.workers.dev/support?status=open&page=1&limit=10" \
  -H "Authorization: Bearer {token}"

​

Suporte

• Email: [email protected]
• Documentação: https://docs.waffle.com.br