{"rule_id":"AB-004","category":"documentation","icon":"📋","title":"API Specification","short_description":"Your site has a machine-readable API specification that agents can parse.","user_value":"An API spec is how agents understand what your API does, what parameters it accepts, and what it returns.","wrong_example":"No API specification. Agents can't use your API without guessing.","right_example":"A complete API specification tells agents exactly how to use your service.","effort_hint":"complex","estimated_cost":"$100+","severity":"high","pillar":"understandability","version":"1.0.0","counted_in_score":true,"check":{"type":"http_fetch","target":"/openapi.json"},"fix":{"eligible":false,"type":"none","note":"Cannot safely generate an OpenAPI spec for an API AgentBadge doesn't own"},"checklist_anchor":"#AB-004","checklist_url":"/agent-readiness-checklist#AB-004","html_url":"/rules/AB-004","json_url":"/rules/AB-004.json","related_rules":[{"rule_id":"AB-005","title":"Agent Guide Schema Validation","category":"documentation"},{"rule_id":"AB-006","title":"MCP Server Descriptor","category":"documentation"},{"rule_id":"AB-024","title":"Detailed LLMs File","category":"documentation"},{"rule_id":"AB-025","title":"LLMs File Linked from HTML","category":"documentation"},{"rule_id":"AB-049","title":"RSS or Atom Feed","category":"documentation"},{"rule_id":"AB-052","title":"Social Preview Image","category":"documentation"},{"rule_id":"AB-053","title":"SVG Favicon","category":"documentation"},{"rule_id":"AB-054","title":"Canonical URL","category":"documentation"},{"rule_id":"AB-055","title":"RSS Feed Linked from HTML","category":"documentation"},{"rule_id":"AB-064","title":"Agent Registration Instructions","category":"documentation"}]}