API Reference

Base URL: https://api.yourdomain.com/v1

All requests must include the Authorization: Bearer <token> header.

Authentication

POST /auth/token
Content-Type: application/json

{
  "email": "user@example.com",
  "password": "secret"
}

Response:

{
  "access_token": "eyJhbGciOiJIUzI1NiIsInR...",
  "expires_in": 3600
}

GET /documents?page=1&limit=20

GET /documents/:id

POST /documents
Content-Type: application/json

{
  "title": "My Document",
  "content": "<p>Hello world</p>",
  "category": "guides"
}

PATCH /documents/:id
Content-Type: application/json

{
  "title": "Updated Title"
}

DELETE /documents/:id

All errors follow this shape:

{
  "error": {
    "code": "NOT_FOUND",
    "message": "Document not found",
    "status": 404
  }
}