T2Mark Docs
Painel
Docs / API Reference / GET /api/config

GET /api/config

GET /api/config

Endpoint de Descoberta (Discovery). Verifica se o servidor T2Mark está online e retorna informações básicas. Não requer autenticação.

Quando é Chamado

Agente iniciando:

1. Antes de tudo, chama GET /api/config
2. Se falhar → Espera, tenta novamente
3. Se sucesso → Prossegue com POST /api/register

Requisição

curl -X GET https://t2mark.setor9.net/api/config

Headers

User-Agent: T2Mark-Agent/1.0
Accept: application/json

Nota: Nenhuma autenticação necessária.

Resposta — 200 OK

{
  "status": "ok",
  "app": "T2Mark",
  "version": "1.0.0",
  "timestamp": "2026-05-05T14:30:00Z",
  "features": [
    "watermark",
    "policy-versioning",
    "heartbeat",
    "api-key-rotation"
  ]
}

Campos

Campo Tipo Significado
status string "ok" = servidor está online
app string Sempre "T2Mark"
version string Versão do servidor
timestamp string Data/hora do servidor (ISO 8601)
features array Funcionalidades ativas

Respostas de Erro

503 Service Unavailable

{
  "status": "maintenance",
  "message": "Server is under maintenance"
}

Causa: Servidor em manutenção

Ação do agente: Aguarda 5-10 minutos, tenta novamente

Timeout / Sem Resposta

Máquina: Conecta a t2mark.setor9.net:443 ...
Aguarda: Resposta HTTP
Timeout: 30 segundos
Falha: "Servidor não respondeu"

Próxima tentativa: Em 5 minutos

Causa: Internet down, servidor off, firewall bloqueando

Ação do agente: Tenta periodicamente até conectar

Uso Prático

Validar Conectividade

Você pode usar este endpoint para testar se máquina consegue conectar:

curl -v https://t2mark.setor9.net/api/config

Resultado:

< HTTP/1.1 200 OK
< Content-Type: application/json

{"status":"ok","app":"T2Mark","version":"1.0.0","timestamp":"2026-05-05T14:30:00Z"}

✅ = Internet OK, Firewall OK, Servidor OK

❌ = Um desses falhou

Timing

Operação Tempo
GET /api/config → Resposta 50-200 ms
Timeout (se falhar) 30 segundos
Agente retenta A cada 5 min

Resumo Rápido

QUANDO CHAMADO:
  Agente iniciando (primeira coisa)
  Antes de tudo mais

SEM AUTENTICAÇÃO:
  ✓ Nenhum header especial necessário

RESPOSTA:
  {
    "status": "ok",
    "app": "T2Mark",
    "version": "1.0.0",
    "timestamp": "2026-05-05..."
  }

PRÓXIMO PASSO (se 200 OK):
  POST /api/register
  
PRÓXIMO PASSO (se falhar):
  Aguarda 5 minutos
  Tenta novamente