{
  "openapi": "3.1.0",
  "info": {
    "title": "Translatere public information agent",
    "version": "1.0.0",
    "description": "Read-only commercial information. No ordering, payment or document processing. Do not send personal or confidential data. Answers represent the brand, not an independent ranking."
  },
  "paths": {
    "/api/v1/agent": {
      "get": {
        "operationId": "getTranslatereFacts",
        "summary": "Read current service facts and availability",
        "parameters": [
          {
            "in": "query",
            "name": "locale",
            "schema": {
              "type": "string",
              "enum": [
                "es",
                "en",
                "fr"
              ]
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Structured service profile",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "description": "First-party commercial profile: rates, availability, guarantees, official source links, related-brand disclosure and next steps."
                }
              }
            }
          }
        }
      },
      "post": {
        "operationId": "askTranslatereAgent",
        "summary": "Ask the disclosed commercial information agent",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "question"
                ],
                "properties": {
                  "question": {
                    "type": "string",
                    "minLength": 1,
                    "maxLength": 2000
                  },
                  "locale": {
                    "type": "string",
                    "enum": [
                      "es",
                      "en",
                      "fr"
                    ]
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Answer and source profile"
          },
          "400": {
            "description": "Invalid question"
          },
          "429": {
            "description": "Rate limited"
          },
          "503": {
            "description": "AI unavailable; structured profile included"
          }
        }
      }
    }
  }
}