NimbusNexus V1:account:region Requests API

openapi: 3.2.0
info:
  title: NimbusNexus API — External V1:account:region Requests API
  description: 'External (public) API intended for client-facing integrations and the web portal.


    Authentication:

    - This API uses JWT Bearer authentication.

    - In Swagger UI, click ''Authorize'' and sign in via the configured token endpoint.

    - Swagger will automatically attach the header: Authorization: Bearer .'
  version: test
servers:
- url: /
  description: Current host
- url: https://fastapi.dev.nimbusnexus.net
  description: Development
security:
- SwaggerLogin: []
- ApiKeyAuth: []
tags:
- name: v1:account:region-requests
paths:
  /api/v1/account/region-requests:
    post:
      tags:
      - v1:account:region-requests
      summary: Submit Region Request
      description: 'Records a region request. Idempotent in spirit — duplicate submissions

        from the same email + region are accepted as separate rows so analytics

        can see the strength of demand over time. Rate limiting on the proxy

        side keeps this from being abused. Originating IP is captured for

        fraud forensics; auto-purged after 365 days by the retention job.'
      operationId: submit_region_request_api_v1_account_region_requests_post
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RegionRequestIn'
        required: true
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RegionRequestSuccessOut'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseBaseErrorOut'
              example:
                success: false
                message: Bad Request
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseValidationErrorOut'
              example:
                success: false
                errors:
                  field:
                  - Invalid value
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ResponseBaseErrorOut'
              example:
                success: false
                message: Internal Server Error
      security:
      - SwaggerLogin: []
      - ApiKeyAuth: []
components:
  schemas:
    ResponseBaseErrorOut:
      properties:
        success:
          type: boolean
          title: Success
          default: false
        message:
          type: string
          title: Message
      type: object
      required:
      - message
      title: ResponseBaseErrorOut
    RegionRequestIn:
      properties:
        email:
          type: string
          format: email
          title: Email
        regionCode:
          type: string
          maxLength: 32
          minLength: 1
          title: Regioncode
        regionOtherText:
          anyOf:
          - type: string
            maxLength: 200
          - type: 'null'
          title: Regionothertext
        company:
          anyOf:
          - type: string
            maxLength: 200
          - type: 'null'
          title: Company
        note:
          anyOf:
          - type: string
            maxLength: 1000
          - type: 'null'
          title: Note
      type: object
      required:
      - email
      - regionCode
      title: RegionRequestIn
      description: 'Anonymous region-request submission. Field names use camelCase aliases

        to match what the marketing-site Next.js proxy posts; service code

        consumes the canonical snake_case names.'
    ResponseValidationErrorOut:
      properties:
        success:
          type: boolean
          title: Success
          default: false
        errors:
          additionalProperties:
            items:
              type: string
            type: array
          type: object
          title: Errors
      type: object
      required:
      - errors
      title: ResponseValidationErrorOut
    RegionRequestSuccessOut:
      properties:
        success:
          type: boolean
          title: Success
          default: true
      type: object
      title: RegionRequestSuccessOut
      description: 'Thin acknowledgement — intentionally does not echo the full row back

        over the public endpoint to avoid leaking IDs.'
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer
    APIKeyHeader:
      type: apiKey
      in: header
      name: X-API-Key
    SwaggerLogin:
      type: oauth2
      flows:
        password:
          tokenUrl: /api/v1/account/login_swagger
          scopes: {}
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: API Key format -  base64('<id>:<secret>')