REST & GraphQL API (v2) v26.7+

Base URL: https://your-domain.com/api Entry Point: public/rest.php (bootstraps Maho + Symfony API Platform)

Maho's v2 API is built on API Platform and exposes the storefront and admin domains over both REST and GraphQL. The pages below cover authentication, request conventions, the full endpoint catalogue, error handling, and how to extend the API from third-party modules.

Contents

• Authentication
• Conventions — request headers, pagination, HTTP caching, idempotency keys
• GraphQL
• Endpoints
• Error Responses
• CAPTCHA
• Architecture — base classes, opt-in traits, shared services
• API Documentation (Swagger UI / OpenAPI)
• Web Server Configuration
• Extending & Deployment — adding resources, third-party modules, deployment notes