GET /api/external/ping

Endpoint de liveness para verificar se o access token é válido e obter a identidade do fornecedor autenticado.

Autenticação

Requer header Authorization: Bearer <access_token> emitido pelo endpoint POST /api/external-auth/token.

Request

curl -s https://servicos.ifollowtech.com.br/api/external/ping \
  -H "Authorization: Bearer SEU_ACCESS_TOKEN"

Response

200 OK

{
  "message": "pong",
  "supplierId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "supplierName": "Acme Supplier",
  "now": "2026-04-23T14:05:32.123Z"
}

Campo	Tipo	Descrição
message	string	Sempre "pong"
supplierId	string	UUID do fornecedor extraído do claim supplier_id do JWT
supplierName	string	Nome do fornecedor extraído do claim supplier_name do JWT
now	datetime	Timestamp UTC do servidor no momento da requisição

401 Unauthorized

{
  "message": "Invalid token."
}

Retornado quando:

• O header Authorization está ausente.
• O token está expirado.
• O token foi assinado com uma chave diferente.
• O token é de um usuário interno (esquema JWT isolado — tokens internos não são aceitos aqui).

Uso típico

Use este endpoint para:

1. Verificar a conectividade antes de enviar chamadas de negócio.
2. Confirmar que o token ainda é válido antes de um fluxo crítico.
3. Smoke test após rotacionar o refresh token.