{
  "name": "Yoofooz API Readiness Report Schema",
  "version": "0.1",
  "description": "Machine-readable guide to Yoofooz API readiness report fields for developers and AI assistants.",
  "fields": {
    "api_name": "Name of the API being evaluated.",
    "domain": "Primary API or company domain when available.",
    "docs_url": "Documentation URL reviewed by Yoofooz.",
    "agent_readiness_score": "Overall readiness score, typically 0-100.",
    "certification_level": "Human-readable readiness level derived from the score and report signals.",
    "category_scores": "Object containing per-category scores keyed by Yoofooz scoring category.",
    "strengths": "List of positive readiness signals found in the API documentation and developer experience.",
    "risks": "List of gaps or integration risks found during review.",
    "recommended_next_steps": "List of improvements that could increase agent readiness."
  },
  "categories": [
    "documentation_clarity",
    "machine_readable_spec",
    "authentication_clarity",
    "error_handling",
    "rate_limit_clarity",
    "agent_safe_workflow_support",
    "sandbox_availability",
    "webhook_event_support",
    "commercial_trust",
    "developer_experience"
  ],
  "certification_levels": {
    "Yoofooz Certified": {
      "score": "85+",
      "meaning": "Strong readiness signals across documentation, integration, safety, and developer experience."
    },
    "Yoofooz Ready": {
      "score": "70-84",
      "meaning": "Generally usable by AI agents, with some improvement areas."
    },
    "Agent-Compatible With Gaps": {
      "score": "50-69",
      "meaning": "Some agent-readiness signals are present, but important gaps remain."
    },
    "Not Yet Agent-Ready": {
      "score": "below 50",
      "meaning": "Documentation or integration signals are insufficient for reliable autonomous use."
    }
  },
  "recommended_agent_use": [
    "compare API readiness",
    "identify integration risks",
    "summarize strengths and weaknesses",
    "select APIs for autonomous workflows"
  ]
}