Changelog
Mudanças na API e nos webhooks. Mudanças compatíveis entram sem nova versão; incompatíveis só numa nova versão, com 12 meses de aviso.
v1.1.0
Conector MCP e OAuth 2.1
- Servidor MCP do lojista em
https://tfshopcloud.com.br/mcp: 23 ferramentas, 5 recursos e 4 prompts que empacotam a API/v1(mesmos escopos, limites, idempotência e auditoria). Guia em Assistentes de IA (MCP). - Servidor de autorização OAuth 2.1 no mesmo host:
/oauth/authorize,/oauth/token,/oauth/register(DCR),/oauth/revokee os metadados/.well-known/oauth-protected-resourcee/.well-known/oauth-authorization-server. PKCES256, CIMD,issnas respostas, refresh token com rotação. Apps parceiros usam o mesmo fluxo. - Novo endpoint
GET /storee escopostore:read: perfil da loja (CNPJ, domínio, emissor da NF-e, limites do plano, moeda e fuso). - MCP anônimo por loja em
/s/{slug}/mcp(e no domínio próprio da loja): 13 ferramentas de descoberta, carrinho e encaminhamento ao checkout. Pedido e pagamento continuam na página da loja. - Painel: aba Assistentes de IA em Aplicativos e API, para ver e desconectar assistentes.
v1.0.0
Primeira versão pública
- 23 endpoints REST em
/v1: produtos e variantes, preços e estoque por SKU, pedidos, NF-e emitida pelo ERP, envios, webhooks e eventos. - 14 tipos de evento por webhook, assinados no padrão Standard Webhooks, com novas tentativas, reenvio e 30 dias de histórico em
/events. - Tokens da loja (
tfs_live_etfs_test_) e apps parceiros com OAuth 2.0 + PKCE, analisados pela TF. - 11 escopos, com os dados pessoais isolados em
orders.pii:read. - Erros RFC 9457,
Idempotency-Key, paginação por cursor e limite de 5 requisições por segundo por token (picos de 50). - Documento OpenAPI 3.1 em /developers/openapi.json.