API Reference

Complete documentation for the Size Charts v1 API.

Authentication

All API requests require authentication via API key. Include the key in request headers:

# Option 1: X-API-Key header
curl -H "X-API-Key: sc_live_xxxxxxxxxxxx" ...

# Option 2: Authorization header
curl -H "Authorization: Bearer sc_live_xxxxxxxxxxxx" ...

Generate API keys in the admin panel under API Keys.

Base URL

https://your-domain.com/api/v1

Size Charts

Categories

Labels

Error Handling

StatusDescription
200Success
400Bad request - invalid parameters
401Unauthorized - API key required
403Forbidden - insufficient permissions
404Not found
429Rate limit exceeded (100 req/min)
500Server error

Rate Limiting

API requests are rate limited per API key:

  • Read operations: 100 requests per minute
  • Write operations: 30 requests per minute

Rate limit headers are included in all responses:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 95
X-RateLimit-Reset: 1702407600