API ERP MarketUP

Production

MarketUP.WebApi 1.0.0+a2df650693eaeb712105464d44e37c4c29868293 · no ar desde 2026-10-13 19:29:24 (UTC) · agora 2026-10-14 19:00:27 (UTC)

Interface OpenAPIexplore e chame os endpoints Documento v2REST, camelCase, problem+json Documento v1legado POST-RPC Health checkusado pelo balanceador; não testa o banco

Versões da API

/v2/...Toda API nova é REST e vive na versão 2: recursos no plural, verbos HTTP, JSON em camelCase, erros em application/problem+json com o campo estável code.
/v1/...Endpoints legados no estilo POST-RPC (v1/Entidade/Acao, envelope success/message). Só manutenção; endpoint novo nasce na v2.
Header de respostaToda resposta que chega ao endpoint traz api-supported-versions com a versão que ele implementa.
URLs antigas/swagger/... redireciona para /openapi/....

Autenticação

Authorization: Bearer <token>Token de sessão emitido pela API de autorização (login do usuário). Obrigatório em todo endpoint autenticado; a sessão expirada responde 401.
x-auth-tokenNão é autenticação: é a prova de que a requisição vem do domínio do tenant da sessão. Como funciona:
  1. A API resolve o install (tenant) a partir do token Bearer e conhece o domínio dele, por exemplo sample.
  2. Se o header Referer aponta para https://sample.marketup.com/..., a requisição passa sem o x-auth-token — é o caso do navegador na própria aplicação.
  3. Sem esse Referer (Postman, integrações, apps), envie x-auth-token com o domínio em Base64: para sample, c2FtcGxl. A API decodifica e compara com o domínio do install; se não bater, responde 401.
  4. Em downloads e exportações o valor pode ir na query string: ?x-auth-token=c2FtcGxl.

Os dois headers vão juntos em toda chamada autenticada; a interface OpenAPI pede os dois no cadeado.