{
  "info": {
    "title": "Bergholt.net API",
    "version": "1.0.0",
    "description": "API flows for Kasper Bergholt's photography and art portfolio site"
  },
  "flows": {
    "search_and_read": {
      "title": "Search and Read Content",
      "description": "Search for articles or portfolio pages by keyword, then retrieve the full content of a result",
      "steps": [
        {
          "endpoint": "/wp-json/wp/v2/search",
          "method": "GET",
          "parameters": {
            "search": "{query}",
            "per_page": 10
          },
          "description": "Search all published content"
        },
        {
          "endpoint": "/wp-json/wp/v2/posts/{id}",
          "method": "GET",
          "description": "Retrieve full post content by ID from search results"
        }
      ]
    },
    "browse_pages": {
      "title": "Browse Portfolio Pages",
      "description": "List all portfolio and series pages, then read a specific page",
      "steps": [
        {
          "endpoint": "/wp-json/wp/v2/pages",
          "method": "GET",
          "parameters": {
            "per_page": 50
          },
          "description": "List all published pages"
        },
        {
          "endpoint": "/wp-json/wp/v2/pages/{id}",
          "method": "GET",
          "description": "Retrieve full page content by ID"
        }
      ]
    },
    "list_categories": {
      "title": "Browse by Category",
      "description": "List content categories, then retrieve posts in a specific category",
      "steps": [
        {
          "endpoint": "/wp-json/wp/v2/categories",
          "method": "GET",
          "description": "List all categories"
        },
        {
          "endpoint": "/wp-json/wp/v2/posts",
          "method": "GET",
          "parameters": {
            "categories": "{category_id}"
          },
          "description": "List posts in a specific category"
        }
      ]
    }
  }
}