{
  "openapi": "3.1.0",
  "info": {
    "title": "Robo9D Foundation API",
    "version": "0.1.0",
    "description": "AI Serving AI. Foundation release with an intentionally empty publication set. All exact fault queries return unknown; no actual diagnoses, providers or official routes are published. No private database access or bulk export is offered. Identity, distributed quotas, audit and real evidence publication are not activated. Do not send sensitive information."
  },
  "servers": [
    {
      "url": "/"
    }
  ],
  "security": [],
  "paths": {
    "/api/v1/faults/lookup": {
      "get": {
        "operationId": "lookupFault",
        "summary": "Return explicit unknown; no verified fault records published.",
        "parameters": [
          {
            "name": "brand",
            "in": "query",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160
            },
            "required": true
          },
          {
            "name": "model",
            "in": "query",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160
            },
            "required": true
          },
          {
            "name": "fault_code",
            "in": "query",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160
            },
            "required": true
          },
          {
            "name": "hardware_version",
            "in": "query",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160
            },
            "required": false
          },
          {
            "name": "software_version",
            "in": "query",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160
            },
            "required": false
          },
          {
            "name": "context",
            "in": "query",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160
            },
            "description": "Non-confidential operating context only; no personal data or private logs.",
            "required": false
          }
        ],
        "responses": {
          "200": {
            "description": "Foundation response, never a diagnosis.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/FaultResult"
                }
              }
            }
          },
          "400": {
            "description": "Invalid or bulk query.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "405": {
            "description": "GET only."
          }
        }
      }
    },
    "/api/v1/providers/search": {
      "get": {
        "operationId": "searchProviders",
        "summary": "Return no verified providers; no service availability is claimed.",
        "parameters": [
          {
            "name": "brand",
            "in": "query",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160
            },
            "required": true
          },
          {
            "name": "model",
            "in": "query",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160
            },
            "required": true
          },
          {
            "name": "country",
            "in": "query",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z]{2}$"
            },
            "description": "Two-letter ISO country code. CN provider-network operations excluded.",
            "required": true
          },
          {
            "name": "city",
            "in": "query",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160
            },
            "required": true
          },
          {
            "name": "category",
            "in": "query",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160
            },
            "required": false
          }
        ],
        "responses": {
          "200": {
            "description": "Foundation response, never a diagnosis.",
            "content": {
              "application/json": {
                "schema": {
                  "oneOf": [
                    {
                      "$ref": "#/components/schemas/ProviderResult"
                    },
                    {
                      "$ref": "#/components/schemas/OutsideScope"
                    }
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Invalid or bulk query.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "405": {
            "description": "GET only."
          }
        }
      }
    },
    "/api/v1/support/official": {
      "get": {
        "operationId": "findOfficialSupport",
        "summary": "Return no verified official channel; never guess manufacturer support URLs.",
        "parameters": [
          {
            "name": "brand",
            "in": "query",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160
            },
            "required": true
          },
          {
            "name": "model",
            "in": "query",
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 160
            },
            "required": true
          },
          {
            "name": "country",
            "in": "query",
            "schema": {
              "type": "string",
              "pattern": "^[A-Za-z]{2}$"
            },
            "description": "Two-letter ISO country code. CN provider-network operations excluded.",
            "required": false
          }
        ],
        "responses": {
          "200": {
            "description": "Foundation response, never a diagnosis.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SupportResult"
                }
              }
            }
          },
          "400": {
            "description": "Invalid or bulk query.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "405": {
            "description": "GET only."
          }
        }
      }
    },
    "/api/v1/repairs": {
      "post": {
        "operationId": "createRepairUnavailable",
        "summary": "Disabled: authorized repair intake is not enabled. Do not send private data.",
        "responses": {
          "503": {
            "description": "Not enabled; no request is stored.",
            "headers": {
              "Retry-After": {
                "schema": {
                  "type": "integer"
                },
                "description": "86400 seconds; availability is not guaranteed."
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Error": {
        "type": "object",
        "required": [
          "api_version",
          "error"
        ],
        "properties": {
          "api_version": {
            "const": "1"
          },
          "request_id": {
            "type": "string"
          },
          "data_version": {
            "type": "string"
          },
          "error": {
            "type": "object",
            "required": [
              "code",
              "message",
              "retryable"
            ],
            "properties": {
              "code": {
                "type": "string"
              },
              "message": {
                "type": "string"
              },
              "retryable": {
                "type": "boolean"
              }
            }
          }
        }
      },
      "FaultResult": {
        "type": "object",
        "required": [
          "api_version",
          "data_version",
          "request_id",
          "status",
          "reason",
          "provenance",
          "professional_diagnosis_required",
          "device",
          "fault_code",
          "meaning",
          "possible_causes",
          "safety_notice",
          "next",
          "publication_status"
        ],
        "properties": {
          "api_version": {
            "const": "1"
          },
          "data_version": {
            "type": "string"
          },
          "request_id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "enum": [
              "unknown"
            ]
          },
          "reason": {
            "type": "string"
          },
          "provenance": {
            "type": "array",
            "maxItems": 0
          },
          "professional_diagnosis_required": {
            "const": true
          },
          "device": {
            "type": "object",
            "properties": {
              "brand": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              },
              "model": {
                "type": "string",
                "minLength": 1,
                "maxLength": 160
              },
              "hardware_version": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "software_version": {
                "type": [
                  "string",
                  "null"
                ]
              }
            }
          },
          "fault_code": {
            "type": "string",
            "minLength": 1,
            "maxLength": 160
          },
          "meaning": {
            "type": "null"
          },
          "possible_causes": {
            "type": "array",
            "maxItems": 0
          },
          "safety_notice": {
            "type": "string"
          },
          "next": {
            "type": "string"
          },
          "publication_status": {
            "const": "empty_catalog"
          }
        }
      },
      "ProviderResult": {
        "type": "object",
        "required": [
          "api_version",
          "data_version",
          "request_id",
          "status",
          "reason",
          "provenance",
          "professional_diagnosis_required",
          "providers",
          "coverage_status"
        ],
        "properties": {
          "api_version": {
            "const": "1"
          },
          "data_version": {
            "type": "string"
          },
          "request_id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "enum": [
              "unknown"
            ]
          },
          "reason": {
            "type": "string"
          },
          "provenance": {
            "type": "array",
            "maxItems": 0
          },
          "professional_diagnosis_required": {
            "const": true
          },
          "providers": {
            "type": "array",
            "maxItems": 0
          },
          "coverage_status": {
            "const": "no_verified_providers"
          }
        }
      },
      "SupportResult": {
        "type": "object",
        "required": [
          "api_version",
          "data_version",
          "request_id",
          "status",
          "reason",
          "provenance",
          "professional_diagnosis_required",
          "channels",
          "safety_notice",
          "next_action"
        ],
        "properties": {
          "api_version": {
            "const": "1"
          },
          "data_version": {
            "type": "string"
          },
          "request_id": {
            "type": "string",
            "format": "uuid"
          },
          "status": {
            "enum": [
              "unknown"
            ]
          },
          "reason": {
            "type": "string"
          },
          "provenance": {
            "type": "array",
            "maxItems": 0
          },
          "professional_diagnosis_required": {
            "const": true
          },
          "channels": {
            "type": "array",
            "maxItems": 0
          },
          "safety_notice": {
            "type": "string"
          },
          "next_action": {
            "type": "string"
          }
        }
      },
      "OutsideScope": {
        "type": "object",
        "required": [
          "status",
          "providers"
        ],
        "properties": {
          "status": {
            "const": "outside_operating_scope"
          },
          "providers": {
            "type": "array",
            "maxItems": 0
          },
          "reason": {
            "type": "string"
          }
        }
      }
    }
  }
}