{
  "openapi": "3.1.0",
  "info": {
    "title": "appscreenshotapi",
    "version": "0.1.0-prelaunch",
    "description": "API-first generation for App Store and Google Play screenshot assets. Public render endpoints are planned; access requests are available now."
  },
  "servers": [
    {
      "url": "https://api.appscreenshotapi.com",
      "description": "Planned production API"
    },
    {
      "url": "https://appscreenshotapi.com",
      "description": "Prelaunch signup and documentation"
    }
  ],
  "paths": {
    "/api/access-request": {
      "post": {
        "summary": "Request account access",
        "description": "Submit a prelaunch account request. This endpoint captures signup details and queues API key activation.",
        "operationId": "createAccessRequest",
        "requestBody": {
          "required": true,
          "content": {
            "application/x-www-form-urlencoded": {
              "schema": {
                "type": "object",
                "required": ["email"],
                "properties": {
                  "name": { "type": "string" },
                  "email": { "type": "string", "format": "email" },
                  "company": { "type": "string" },
                  "intent": { "type": "string" },
                  "source": { "type": "string", "default": "register" },
                  "utm_source": { "type": "string" },
                  "utm_medium": { "type": "string" },
                  "utm_campaign": { "type": "string" }
                }
              }
            }
          }
        },
        "responses": {
          "303": {
            "description": "Redirects to account activation status page."
          }
        }
      }
    },
    "/v1/render-jobs": {
      "post": {
        "summary": "Create screenshot render job",
        "description": "Planned endpoint for authenticated screenshot rendering.",
        "security": [{ "bearerAuth": [] }],
        "responses": {
          "202": {
            "description": "Render job accepted."
          }
        }
      }
    },
    "/v1/jobs/{job_id}": {
      "get": {
        "summary": "Get job status",
        "description": "Planned endpoint for polling render status and signed outputs.",
        "security": [{ "bearerAuth": [] }],
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": {
            "description": "Render job status."
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  }
}