IFW Public Integration Hub

Documentação de integração para fornecedores externos.

Como funciona

Sua API key fixa é usada uma única vez para obter um par de tokens de curta duração. Todas as chamadas de negócio utilizam o JWT — a API key nunca precisa trafegar em cada requisição.

Endpoints disponíveis

POST  /api/external-auth/token                              → trocar a API key por um JWT + refresh token
POST  /api/external-auth/refresh                            → renovar o JWT quando expirar
POST  /api/external-auth/revoke                             → encerrar a sessão
GET   /api/external/ping                                    → verificar se o token está válido
POST  /api/material-requests                                → criar solicitação de material
PATCH /api/material-requests/{id}/selected-estimate         → enviar estimativa escolhida
POST  /api/products/sync                                    → sincronizar produto (upsert / desativar)
POST  /ipulse/scoreboard                                    → placar do dia (autenticação por API key fixa)