{"openapi":"3.1.0","info":{"title":"Kallipolis Proof API","version":"1.4.0","description":"Evidence resolution for public HTTPS domains and Base addresses, with x402 payment challenges and prepaid-credit support. End-to-end paid settlement has not been independently demonstrated.","contact":{"name":"Kallipolis Proof","email":"handongzhen101@126.com"},"x-guidance":"Use quick-resolve for a low-cost first check and deep-resolve for the full evidence report. Send a public HTTPS domain or Base address in query. Inspect payment terms before signing; a 402 challenge is not proof of working settlement. For API launch assistance visit /pilots; for report evidence checks, data-quality reviews and vendor comparisons visit /services. Service enquiries require no payment."},"servers":[{"url":"https://proof.platoskallipolis.com"}],"x-discovery":{"ownershipProofs":["0x3A24CC8394358B1e1b61900A73e27b1eA8482e48"]},"paths":{"/api/v1/resolve":{"post":{"summary":"Free curated reference lookup (not a live audit)","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string"}}}}}},"responses":{"200":{"description":"Resolution"}}}},"/api/v1/quick-resolve":{"post":{"summary":"Concise live evidence check","description":"Lowest-cost paid entry point. Returns a concise evidence report for one public HTTPS domain or Base address.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Public HTTPS domain or Base address","minLength":1,"maxLength":240}}}}}},"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.01"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Concise evidence report"},"402":{"description":"x402 Base USDC payment challenge"}}}},"/api/v1/deep-resolve":{"post":{"summary":"Full live evidence resolution","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["query"],"properties":{"query":{"type":"string","description":"Public HTTPS domain or Base address","minLength":1,"maxLength":240}}}}}},"parameters":[{"name":"PAYMENT-SIGNATURE","in":"header","schema":{"type":"string"}},{"name":"x-api-key","in":"header","schema":{"type":"string"}}],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.20"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"Full evidence report"},"402":{"description":"x402 Base USDC payment challenge"}}}},"/api/v1/purchase":{"post":{"summary":"Purchase a prepaid API pass","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["plan"],"properties":{"plan":{"type":"string","enum":["builder","growth","scale"]}}}}}},"x-payment-info":{"price":{"mode":"dynamic","currency":"USD","min":"19.00","max":"999.00"},"protocols":[{"x402":{}}]},"responses":{"200":{"description":"API key issued"},"402":{"description":"x402 Base USDC payment challenge"}}}},"/api/v1/stats":{"get":{"summary":"Recorded settlement and usage counters, not independently verified external revenue","security":[],"responses":{"200":{"description":"Ledger counters and reconciliation limitations"}}}},"/api/v1/bazaar-readiness":{"get":{"summary":"Validate Bazaar discovery metadata, not paid settlement","security":[],"responses":{"200":{"description":"Validation result"}}}},"/api/v1/pilot-requests":{"post":{"summary":"Submit a private pilot enquiry without payment","security":[],"description":"Stores an enquiry for scope review, not an order. Do not submit credentials, confidential data or third-party personal data. No automatic email is sent.","requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["submissionId","email","problem","offer","consent"],"allOf":[{"if":{"properties":{"offer":{"enum":["diagnostic","integration"]}},"required":["offer"]},"then":{"required":["projectUrl"],"properties":{"projectUrl":{"minLength":1}}}}],"properties":{"submissionId":{"type":"string","format":"uuid","description":"Reuse for retries of the same enquiry"},"email":{"type":"string","format":"email","maxLength":254},"projectUrl":{"anyOf":[{"type":"string","format":"uri","maxLength":500},{"const":""}],"default":"","description":"Public HTTPS URL without credentials, query or fragment. Required for diagnostic and integration; optional or empty for research/data services."},"problem":{"type":"string","minLength":20,"maxLength":2000},"offer":{"type":"string","enum":["diagnostic","integration","evidence_review","data_quality","vendor_review"]},"consent":{"type":"boolean","const":true,"description":"Consent to storage, AI-assisted scope review and project-related follow-up as described at /pilots#privacy or /services#privacy"}}}}}},"responses":{"202":{"description":"Enquiry reference saved; no payment or automatic email"},"400":{"description":"Invalid input or missing consent"},"403":{"description":"Cross-origin form submission rejected"},"413":{"description":"Body exceeds 8 KB"},"415":{"description":"JSON content type required"},"429":{"description":"Submission limit reached"},"503":{"description":"Storage unavailable"}}}}}}