API Reference

Interactive Documentation (Recommended)

Detailed API Documentation

For comprehensive guides with code examples and detailed explanations, see our detailed API documentation:

• Authentication API - User registration, login, JWT tokens, and session management
• Products API - Browse marketplace, purchase products, and manage licenses
• Cart API - Shopping cart management and checkout flow
• Orders API - Order creation, tracking, and fulfillment
• Payments API - Payment processing, webhooks, and refunds

Interactive Documentation

The complete API documentation is available via:

• Scalar (Core API): http://localhost:3001/docs
• Swagger UI (Legacy): http://localhost:3001/swagger
• Docs Service (OpenAPI Explorer): /docs/api-reference

Base URL

https://api.yourdomain.com/api

Authentication

Most endpoints require JWT Bearer token:

Authorization: Bearer <jwt-token>

Quick Reference

Authentication

View detailed Authentication API documentation →

Products

View detailed Products API documentation →

Cart

See OpenAPI Explorer for the complete and up-to-date list. View detailed Cart API documentation →

Orders

View detailed Orders API documentation →

Payments

View detailed Payments API documentation →

Response Format

Success Response

{
  "success": true,
  "data": { "..." : "..." },
  "message": "optional"
}

Error Response

{
  "success": false,
  "error": {
    "code": "ERROR_CODE",
    "message": "Human readable error",
    "details": { "optional": "any JSON" }
  }
}

Error Codes

Rate Limiting

API requests are rate limited:

• Anonymous: 100 requests/minute
• Authenticated: 1000 requests/minute
• Admin: 5000 requests/minute

OpenAPI Specification

Download the OpenAPI spec:

• JSON: /openapi.json