Shop / Developers
Surface contract
The BFF this storefront already runs. Not a partner platform.
Rolera's browser-facing API is /api/rolera/v1. It belongs to this storefront. There is no public partner program, no partner keys, and no outbound partner webhooks in G1.
What this is
Signed-in owner routes use a session cookie. Guests use Mini App pages under /r/, not a third-party integration.
Do not use /api/rolera/v1/health as a public contract. It is an internal probe. Public status is /api/rolera/v1/status.
Unauthenticated reads
GET /api/rolera/v1/statusCoarse public status. No adapter inventory.GET /api/rolera/v1/catalogG1 sellable role catalog.GET /.well-known/rolera-ai.jsonMachine-readable product facts.GET /llms.txtCrawler brief.
Inbound provider webhooks
These URLs receive events from billing and email providers. They are not for partners to call as customers. Production billing requires a valid signature.
Billing provider to Rolera
POST /api/rolera/v1/webhooks/billinghttps://www.rolera.net/api/rolera/v1/webhooks/billing
Email provider to Rolera
POST /api/rolera/v1/webhooks/emailhttps://www.rolera.net/api/rolera/v1/webhooks/email
Session routes
Checkout, roles, cockpit, export, delete, and usage sit behind a member session. They are not a documented partner integration in G1. This page is the public truth.
Errors
Failed calls return JSON with a code and a trace_id. That envelope is the public error shape.
{ "code": "PERMISSION", "trace_id": "…" }Named contact
Partner desk: Rolera partner desk · admin@rolera.net. Legal: legal@rolera.net. Operator: Smartedtech S.L., Barcelona.