Loja / Programadores
Contrato de superfície
O BFF que esta loja já executa. Não é uma plataforma de parceiros.
A API no browser da Rolera é /api/rolera/v1. Pertence a esta loja. Em G1 não há programa público de parceiros, nem chaves de parceiro, nem webhooks de saída para parceiros.
O que é isto
As rotas do dono com sessão usam um cookie. Os convidados usam as páginas Mini App em /r/, não uma integração de terceiros.
Não uses /api/rolera/v1/health como contrato público. É uma sonda interna. O estado público é /api/rolera/v1/status.
Leituras sem autenticação
GET /api/rolera/v1/statusEstado público resumido. Sem inventário de adaptadores.GET /api/rolera/v1/catalogCatálogo de funções vendáveis em G1.GET /.well-known/rolera-ai.jsonFactos de produto legíveis por máquina.GET /llms.txtNota para crawlers.
Webhooks de entrada do fornecedor
Estes URL recebem eventos dos fornecedores de faturação e email. Não são para um parceiro chamar como cliente. A faturação em produção exige uma assinatura válida.
Fornecedor de faturação para a Rolera
POST /api/rolera/v1/webhooks/billinghttps://www.rolera.net/api/rolera/v1/webhooks/billing
Fornecedor de email para a Rolera
POST /api/rolera/v1/webhooks/emailhttps://www.rolera.net/api/rolera/v1/webhooks/email
Rotas de sessão
Checkout, funções, cockpit, exportação, apagar e uso ficam atrás de uma sessão de membro. Não é uma integração de parceiro documentada em G1. Esta página é a verdade pública.
Erros
Chamadas falhadas devolvem JSON com um code e um trace_id. Esse envelope é a forma pública de erro.
{ "code": "PERMISSION", "trace_id": "…" }Contacto nomeado
Mesa de parceiros: Rolera partner desk · admin@rolera.net. Jurídico: legal@rolera.net. Operador: Smartedtech S.L., Barcelona.