# Saeroon API

> Saeroon Platform API - 크리에이터 프로필, 호스팅, 결제, 커뮤니티

## Quick Reference

- Base URL: https://api.saeroon.com
- Auth: JWT Bearer token in `Authorization: Bearer {token}` header
- Format: JSON (application/json)
- Errors: RFC 7807 (application/problem+json)

## Authentication Flow

1. Login: `POST /api/v1/auth/login` with email/password
2. Receive: `{ accessToken, refreshToken }`
3. Use: `Authorization: Bearer {accessToken}`
4. Refresh: `POST /api/v1/auth/refresh` when expired

## Core Endpoints (Most Used)

### Authentication
- `POST /api/v1/auth/login` - Email/password login
- `POST /api/v1/auth/google` - Google OAuth login
- `POST /api/v1/auth/refresh` - Refresh access token
- `POST /api/v1/auth/logout` - Logout (clear cookies)

### Hosting - Sites
- `GET /api/v1/hosting/sites` - List my sites
- `POST /api/v1/hosting/sites` - Create new site
- `GET /api/v1/hosting/sites/{id}` - Get site details
- `PUT /api/v1/hosting/sites/{id}` - Update site
- `DELETE /api/v1/hosting/sites/{id}` - Delete site
- `POST /api/v1/hosting/sites/{id}/publish` - Publish site

### Hosting - Templates
- `GET /api/v1/hosting/templates` - List available templates
- `GET /api/v1/hosting/templates/{id}` - Get template details

### Creator Profile (ReadMe)
- `GET /api/v1/roots` - Get my root pages
- `POST /api/v1/roots` - Create root page
- `GET /api/v1/root-blocks` - Get page blocks
- `POST /api/v1/root-blocks` - Create block

## Category Documentation (Detailed)

For detailed endpoints by category, fetch:

- [https://api.saeroon.com/llms-auth.txt](/llms-auth.txt) - Authentication & Users (15 endpoints)
- [https://api.saeroon.com/llms-hosting.txt](/llms-hosting.txt) - Hosting, Sites, Templates, Shop, Booking (120 endpoints)
- [https://api.saeroon.com/llms-moajack.txt](/llms-moajack.txt) - Community, Posts, Events (50 endpoints)
- [https://api.saeroon.com/llms-payments.txt](/llms-payments.txt) - Payments, Earnings, Settlements (40 endpoints)
- [https://api.saeroon.com/llms-readme.txt](/llms-readme.txt) - Creator Profiles, Themes (30 endpoints)
- [https://api.saeroon.com/llms-admin.txt](/llms-admin.txt) - Admin Functions (25 endpoints)

## Complete Reference

- [https://api.saeroon.com/llms-full.txt](/llms-full.txt) - All 562 endpoints (for RAG systems)
- [https://api.saeroon.com/openapi/v1.json](/openapi/v1.json) - OpenAPI 3.1 specification
- [https://api.saeroon.com/agents.json](/agents.json) - Structured agent actions
- [https://api.saeroon.com/scalar](/scalar) - Interactive API documentation

## Common Response Formats

### Success Response
```json
{
  "id": "uuid",
  "createdAt": "2025-01-01T00:00:00Z",
  ...
}
```

### Error Response (RFC 7807)
```json
{
  "type": "https://api.saeroon.com/errors/validation-error",
  "title": "Validation Error",
  "status": 400,
  "detail": "The request body is invalid",
  "instance": "/api/v1/hosting/sites",
  "traceId": "abc123"
}
```

## Rate Limits

- General: 100 requests/minute
- Auth endpoints: 10 requests/minute
- File uploads: 20 requests/minute