# Quickshops developer resources

Machine-readable and human docs for integrating with Quickshops: Headless REST API, OpenAPI, MCP, SDK, auth, and webhooks.

## API

- Base URL: `https://api.quickshops.app/v1`
- OpenAPI JSON: https://quickshops.app/openapi.json
- API docs: https://docs.quickshops.app/api/overview
- Auth docs: https://docs.quickshops.app/api/authentication

Authenticated routes use `Authorization: Bearer qk_...` (Pro plan). Versioning is in the URL path (`/v1/`). Errors are JSON `{ "error", "code" }`. Rate-limit headers follow IETF RateLimit plus `Retry-After` on 429.

## MCP

- Manifest: https://quickshops.app/mcp.json
- Streamable HTTP: https://mcp.quickshops.app/mcp
- Setup: https://docs.quickshops.app/mcp/connecting

## SDK

- TypeScript SDK: `npm install @quickshops/sdk`