{"openapi":"3.1.0","info":{"title":"gutendex-books","version":"0.1.0","description":"listed:true — OpenAPI pre-register shape. Discovery submit HOLD until Board origin list.","x-guidance":"POST /v1/gutendex-books with application/json per requestBody schema. Unauthenticated probes receive HTTP 402 (x402 exact USDC on Base / eip155:8453). After payment settles, empty or invalid bodies return 400 with charged:false. Free health: GET /healthz and GET /readyz. Contact nicsins@gmail.com.","contact":{"email":"nicsins@gmail.com"}},"paths":{"/v1/gutendex-books":{"post":{"operationId":"gutendex_books","summary":"Project Gutenberg books via Gutendex (keyless). search/topic/ids/author_year → trimmed book list.","x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"properties":{"search":{"type":"string","maxLength":200},"q":{"type":"string","maxLength":200},"topic":{"type":"string","maxLength":100},"ids":{"type":"string","maxLength":200,"description":"Comma-separated Gutenberg IDs"},"author_year_start":{"type":"integer","minimum":-2000,"maximum":2100},"author_year_end":{"type":"integer","minimum":-2000,"maximum":2100},"languages":{"type":"string","maxLength":64,"description":"Comma-separated language codes"},"copyright":{"type":"boolean"},"mime_type":{"type":"string","maxLength":64},"sort":{"type":"string","maxLength":32},"limit":{"type":"integer","minimum":1,"maximum":32,"default":10},"request_id":{"type":"string"}}}}}},"responses":{"200":{"description":"ok envelope","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"},"skill":{"type":"string"},"charged":{"type":"boolean"},"summary":{"type":"string"},"data":{},"request_id":{"type":"string"}},"required":["ok"]}}}},"400":{"description":"empty/invalid after settle — charged:false"},"402":{"description":"payment required"},"503":{"description":"service disabled (kill-switch)"}}}},"/healthz":{"get":{"operationId":"healthz","security":[],"summary":"Liveness","responses":{"200":{"description":"ok","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}}}}},"/readyz":{"get":{"operationId":"readyz","security":[],"summary":"Readiness","responses":{"200":{"description":"ready","content":{"application/json":{"schema":{"type":"object","properties":{"ok":{"type":"boolean"}},"required":["ok"]}}}},"503":{"description":"not ready"}}}}}}