Developer Platform

Ritsbo API Documentation

Build integrations with Ritsbo's API-first architecture. RESTful endpoints, scoped API keys, webhooks, and rate limiting — designed so new integrations plug in without redesigning the platform.

v1 Stable
RESTful
Webhooks
Rate Limited
Three-Tier Access

Public, Partner, and Internal APIs with scoped permissions — each tier has different rate limits and capabilities.

API Key Authentication

Scoped API keys with per-minute and per-hour rate limits. Keys can be rotated and revoked at any time.

Event-Driven Webhooks

Subscribe to 30+ event types including orders, inventory changes, payments, and store lifecycle events.

Versioned API

All endpoints are versioned under /v1/. Breaking changes ship under new versions — v1 will always remain stable.

Rate Limiting

Automatic rate limiting with X-RateLimit headers and 429 responses with Retry-After guidance.

Built for Integrations

Designed for Sellvia, Printful, Klaviyo, Amazon, Walmart, TikTok Shop, and more — add new integrations without redesigning.

Quick Start

1Request an API key from the admin dashboard (Partner tier for integrations)
2Make your first API call using your key in the request payload
3Register webhooks to receive real-time event notifications
POST /api/functions/apiGateway
{
  "path": "/v1/public/products/list",
  "api_key": "rk_live_...",
  "payload": { "limit": 10 }
}