{ "openapi": "3.1.0", "info": { "title": "Paul Haedo author catalogue", "version": "1.2.0", "description": "Read-only static exports of first-party, author-approved book information and AI-prepared editorial guides. No authentication, live language model, or write operations." }, "servers": [ { "url": "https://paulhaedo.steepknot1.chatgpt.site/" } ], "security": [], "paths": { "/community.json": { "get": { "operationId": "getDiscussionAndThemeGuides", "summary": "Read original spoiler-light discussion and thematic guides with canonical source links", "responses": { "200": { "description": "Community guides", "content": { "application/json": { "schema": { "type": "object", "required": [ "schemaVersion", "language", "scope", "discussions", "themes" ] } } } } } } }, "/{language}/community.json": { "get": { "operationId": "getLocalizedDiscussionAndThemeGuides", "summary": "Read complete translated discussion and thematic guides", "parameters": [ { "name": "language", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "ar", "bn", "de", "es", "fa", "fr", "hi", "id", "it", "ja", "ko", "nl", "pl", "pt", "ru", "sw", "ta", "te", "th", "tr", "ur", "vi", "zh" ] } } ], "responses": { "200": { "description": "Translated community guides", "content": { "application/json": { "schema": { "type": "object", "required": [ "schemaVersion", "language", "scope", "discussions", "themes" ] } } } } } } }, "/editorial.json": { "get": { "operationId": "getEditorialLibrary", "summary": "Read original introductory editorial guidance and source book references", "responses": { "200": { "description": "Editorial records", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/{language}/editorial.json": { "get": { "operationId": "getLocalizedEditorialLibrary", "summary": "Read translated introductory editorial guidance", "parameters": [ { "name": "language", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "ar", "bn", "de", "es", "fa", "fr", "hi", "id", "it", "ja", "ko", "nl", "pl", "pt", "ru", "sw", "ta", "te", "th", "tr", "ur", "vi", "zh" ] } } ], "responses": { "200": { "description": "Translated editorial records", "content": { "application/json": { "schema": { "type": "object" } } } } } } }, "/edition-register.json": { "get": { "operationId": "getEditionEvidence", "summary": "Read edition evidence and explicit verification limits", "responses": { "200": { "description": "Edition register", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/reader-guidance.json": { "get": { "operationId": "getReaderGuidance", "summary": "Read selected source-backed FAQs and reading questions", "responses": { "200": { "description": "Reader guidance", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/{language}/catalogue.json": { "get": { "operationId": "getLocalizedCatalogue", "summary": "Read translated website book guidance and regional edition searches; not translated book editions", "parameters": [ { "name": "language", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Localized catalogue", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/{language}/books/{slug}.json": { "get": { "operationId": "getLocalizedBook", "summary": "Read one translated book introduction, canonical identity and regional retailer searches", "parameters": [ { "name": "language", "in": "path", "required": true, "schema": { "type": "string" } }, { "name": "slug", "in": "path", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "description": "Localized book", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/languages.json": { "get": { "operationId": "getLanguages", "summary": "Read language editions and regional store defaults", "responses": { "200": { "description": "Translated website catalogue", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/search-index.json": { "get": { "operationId": "getDiscoveryIndex", "summary": "Read the unified spoiler-light search index", "responses": { "200": { "description": "Search records", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/reading-paths.json": { "get": { "operationId": "getReadingPaths", "summary": "Read six spoiler-light thematic reading paths", "responses": { "200": { "description": "First-party editorial reading routes", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/research.json": { "get": { "operationId": "getManuscriptResearch", "summary": "Read spoiler-light companions and source locators without reproduced passage text", "responses": { "200": { "description": "Source-referenced editorial research", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/reader-catalogue.json": { "get": { "operationId": "getReaderCatalogue", "summary": "Read thematic connections, explicit collection contents and reader attributes", "responses": { "200": { "description": "Reader catalogue", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true } } } } } } }, "/author-facts.json": { "get": { "operationId": "getAuthorFacts", "summary": "Read first-party biography, current catalogue scope and verified public author identities", "responses": { "200": { "description": "Author facts", "content": { "application/json": { "schema": { "type": "object", "required": [ "provenance", "scope", "author", "catalogue" ], "additionalProperties": true } } } } } } }, "/lore-entities.json": { "get": { "operationId": "getLoreEntities", "summary": "Read named fictional references with source-book and world context", "responses": { "200": { "description": "Named lore references", "content": { "application/json": { "schema": { "type": "object", "required": [ "provenance", "scope", "entities" ], "additionalProperties": true } } } } } } }, "/worlds.json": { "get": { "operationId": "getWorldGuides", "summary": "Read first-party introductory world and lore guides with source books", "responses": { "200": { "description": "World guide data", "content": { "application/json": { "schema": { "type": "object", "required": [ "provenance", "scope", "url", "worlds" ], "properties": { "provenance": { "const": "first-party" }, "scope": { "type": "string" }, "url": { "type": "string" }, "worlds": { "type": "array", "items": { "type": "object" } } } } } } } } } }, "/author-knowledge.json": { "get": { "operationId": "getAuthorKnowledge", "summary": "Read subject guides to the author-approved nonfiction catalogue", "responses": { "200": { "description": "Nonfiction subject guides", "content": { "application/json": { "schema": { "type": "object", "required": [ "provenance", "scope", "url", "themes" ], "properties": { "provenance": { "const": "first-party" }, "scope": { "type": "string" }, "url": { "type": "string" }, "themes": { "type": "array", "items": { "type": "object" } } } } } } } } } }, "/catalogue.json": { "get": { "operationId": "getCatalogue", "summary": "Read the current author-approved catalogue", "responses": { "200": { "description": "Current catalogue", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Catalogue" } } } } } } }, "/author.json": { "get": { "operationId": "getAuthor", "summary": "Read author information and provenance", "responses": { "200": { "description": "Author information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Author" } } } } } } }, "/books/{slug}.json": { "get": { "operationId": "getBook", "summary": "Read one current book and its approved edition listings", "parameters": [ { "name": "slug", "in": "path", "required": true, "schema": { "type": "string", "enum": [ "peacekeeper-prequel", "peace-keeper", "rising-tide", "star-rising", "star-destroyer", "world-engine", "pulses", "futures-guardian", "a-chance-encounter", "scandinavian-tequila", "moments-are-butterflies", "haedian-sci-fi-short-stories-volume-one", "haedian-sci-fi-short-stories-volume-two", "stack-it-tall", "proletarian-hearts-part-one", "proletarian-hearts-part-two", "spliced", "journey-home", "emily-reed-and-the-humans", "peacekeeper-the-complete-series", "romance-novel-mega-pack", "the-director", "sci-fi-novel-mega-pack", "beauty-unexpected", "peaceful-resistance", "the-designer", "the-mycelial-invasion", "a-mans-guide-to-surviving-marriage", "debt-buster", "a-dalliance-across-thought", "white-assimilation", "haedian-poetry-volume-one", "the-reality", "the-word-of-era", "the-communist-republic", "marxist-haedoism", "aliens-and-humans" ] } } ], "responses": { "200": { "description": "Book information", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BookRecord" } } } }, "404": { "description": "No published, approved book has this slug. The static host serves its not-found response." } } } } }, "components": { "schemas": { "Provenance": { "type": "object", "required": [ "type", "scope", "sourceUrls" ], "properties": { "type": { "const": "first-party" }, "scope": { "type": "string" }, "sourceUrls": { "type": "array", "items": { "type": "string" } }, "verifiedDate": { "type": "string", "format": "date" } } }, "Book": { "type": "object", "required": [ "@type", "name", "url", "author", "sameAs", "workExample" ], "properties": { "@type": { "const": "Book" }, "name": { "type": "string" }, "url": { "type": "string" }, "author": { "type": "object" }, "sameAs": { "type": "array", "items": { "type": "string" } }, "workExample": { "type": "array", "items": { "type": "object" } } }, "additionalProperties": true }, "Author": { "type": "object", "required": [ "schemaVersion", "provenance", "canonicalUrl", "author", "catalogueUrl", "workCount" ], "properties": { "schemaVersion": { "const": "1.0" }, "provenance": { "$ref": "#/components/schemas/Provenance" }, "canonicalUrl": { "type": "string" }, "author": { "type": "object", "required": [ "@type", "name", "url" ], "properties": { "@type": { "const": "Person" }, "name": { "type": "string" }, "url": { "type": "string" }, "description": { "type": "string" }, "sameAs": { "type": "array", "items": { "type": "string" } } }, "additionalProperties": true }, "catalogueUrl": { "type": "string" }, "workCount": { "type": "integer", "minimum": 0 } } }, "BookRecord": { "allOf": [ { "$ref": "#/components/schemas/Book" }, { "type": "object", "required": [ "schemaVersion", "provenance", "canonicalUrl", "workId", "slug", "kind", "form", "summary", "collection", "editions", "editionAvailability" ], "properties": { "schemaVersion": { "const": "1.0" }, "provenance": { "$ref": "#/components/schemas/Provenance" }, "canonicalUrl": { "type": "string" }, "workId": { "type": "string" }, "slug": { "type": "string" }, "kind": { "enum": [ "fiction", "poetry", "nonfiction" ] }, "form": { "type": "string" }, "summary": { "type": [ "string", "null" ] }, "collection": { "type": [ "object", "null" ], "properties": { "title": { "type": "string" }, "url": { "type": "string" }, "readingOrderConfirmed": { "type": "boolean" }, "position": { "type": [ "integer", "null" ], "minimum": 1 } } }, "editions": { "type": "array", "items": { "type": "object", "required": [ "id", "format", "url" ], "properties": { "id": { "type": "string" }, "format": { "type": "string" }, "url": { "type": "string" } } } }, "editionAvailability": { "type": "string" } } } ] }, "Catalogue": { "type": "object", "required": [ "@context", "author", "authorProfile", "status", "url", "editionAvailability", "genreGuides", "works", "collections" ], "properties": { "@context": { "const": "https://schema.org" }, "author": { "type": "string" }, "authorProfile": { "type": "object" }, "status": { "type": "string" }, "url": { "type": "string" }, "editionAvailability": { "type": "string" }, "genreGuides": { "type": "array", "items": { "type": "object", "required": [ "name", "url", "description" ], "properties": { "name": { "type": "string" }, "url": { "type": "string" }, "description": { "type": "string" } } } }, "works": { "type": "array", "items": { "$ref": "#/components/schemas/Book" } }, "collections": { "type": "array", "items": { "type": "object", "required": [ "title", "url", "readingOrderConfirmed", "works" ], "properties": { "title": { "type": "string" }, "url": { "type": "string" }, "readingOrderConfirmed": { "type": "boolean" }, "works": { "type": "array", "items": { "type": "string" } } } } } } } } } }