Skip to main content

Visão Geral

A Hub API fornece acesso programático ao Marketplace Hub — a exchange de conteúdo B2B onde workspaces publicam e descobrem catálogos de produtos. A API suporta tanto operações de consumidor (navegar, visualizar, clonar, assinar) quanto operações de publisher (analytics, despublicar).

URL Base

Todos os endpoints da Hub API utilizam a seguinte base:

Grupos de endpoints

Navegar Catálogos

GET /hub/catalogs — pesquisar e filtrar o feed público do Hub

Visualizar

GET /hub/catalogs/{id}/preview — primeiros 10 produtos + estatísticas, sem necessidade de clonar

Clonar e Assinar

POST /hub/catalogs/{id}/clone e /subscribe — adquirir acesso ao catálogo

Sync e Conflitos

Gerenciamento de sincronização de assinaturas e resolução de conflitos

Analytics do Publisher

GET /hub/catalogs/{id}/analytics — visualizações, clones, assinantes, receita

Autenticação

Endpoints públicos (sem autenticação)

Os seguintes endpoints são acessíveis publicamente sem autenticação:

Endpoints autenticados

Todos os outros endpoints requerem um Bearer token:
Operações de escrita (clonar, assinar, analytics) requerem que a chave API pertença a um workspace com plano ativo.

Rate limits

Headers de rate limit são incluídos em cada resposta:
Quando o limite é excedido, uma resposta 429 é retornada com o header Retry-After.

Objeto HubCatalog

O objeto principal retornado pelos endpoints de navegação e visualização do Hub:

Respostas de erro

Todos os endpoints do Hub retornam formatos de erro padrão:
Códigos de erro comuns:
Última modificação em 18 de março de 2026