studiomeyer-io Portfolio API

openapi: 3.2.0
info:
  title: StudioMeyer Public Portfolio API
  version: 1.0.0
  description: Public website endpoints, no API key required. JSON bodies required for POST; quote accepts an empty object. Major versions use /api/v{major}; breaking changes receive a new major-version URL. Deprecations announce the replacement in documentation and response headers; a sunset date is published only when scheduled. The separate authenticated API Platform is documented at /api/openapi.
  contact:
    email: hello@studiomeyer.io
servers:
- url: https://studiomeyer.io
security: []
tags:
- name: Portfolio
paths:
  /api/v1/portfolio:
    get:
      summary: Browse the three demo sites (fictional showcase businesses, not customers)…
      operationId: get_portfolio
      responses:
        '200':
          description: JSON response
          headers:
            RateLimit:
              description: Remaining requests and seconds to reset for the named policy (HTTP RateLimit draft).
              schema:
                type: string
            RateLimit-Policy:
              description: Named policy, request quota and window in seconds (HTTP RateLimit draft).
              schema:
                type: string
            X-RateLimit-Limit:
              description: Request quota for the policy.
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Requests remaining in the current window.
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Reset time as Unix epoch seconds.
              schema:
                type: integer
          content:
            application/json:
              schema:
                type: object
                properties:
                  agency:
                    type: string
                  total:
                    type: integer
                  demos:
                    type: integer
                  filters:
                    type: object
                    properties:
                      industry:
                        type: string
                      style:
                        type: string
                    required:
                    - industry
                    - style
                  projects:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                        slug:
                          type: string
                        type:
                          const: demo
                        category:
                          type: string
                        url:
                          type: string
                          format: uri
                        heroImage:
                          type: string
                          format: uri
                        mobileImage:
                          type: string
                          format: uri
                        tech:
                          type: array
                          items:
                            type: string
                      required:
                      - name
                      - slug
                      - type
                      - category
                      - url
                      - heroImage
                      - mobileImage
                      - tech
                  next_cursor:
                    anyOf:
                    - type: string
                    - type: 'null'
                    description: Cursor for the next page, or null when this is the final page.
                  _note:
                    type: string
                required:
                - agency
                - total
                - demos
                - filters
                - projects
                - next_cursor
                - _note
        '400':
          description: Invalid request or validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '405':
          description: HTTP method not supported by this endpoint
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          headers:
            Allow:
              description: Supported HTTP methods.
              schema:
                type: string
        '429':
          description: Rate limit exceeded; observe Retry-After and rate-limit headers
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          headers:
            RateLimit:
              description: Remaining requests and seconds to reset for the named policy (HTTP RateLimit draft).
              schema:
                type: string
            RateLimit-Policy:
              description: Named policy, request quota and window in seconds (HTTP RateLimit draft).
              schema:
                type: string
            X-RateLimit-Limit:
              description: Request quota for the policy.
              schema:
                type: integer
            X-RateLimit-Remaining:
              description: Requests remaining in the current window.
              schema:
                type: integer
            X-RateLimit-Reset:
              description: Reset time as Unix epoch seconds.
              schema:
                type: integer
            Retry-After:
              description: Seconds to wait before retrying.
              schema:
                type: integer
                minimum: 1
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      parameters:
      - name: industry
        in: query
        required: false
        schema:
          type: string
          enum:
          - immobilien
          - gastronomie
          - hotellerie
          - alle
      - name: style
        in: query
        required: false
        schema:
          type: string
          enum:
          - premium
          - modern
          - alle
      - name: cursor
        in: query
        required: false
        schema:
          type: string
          description: Opaque cursor from the previous response's next_cursor. Omit for the first page.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          minimum: 1
          maximum: 100
          description: Page size from 1 to 100.
          default: 20
      tags:
      - Portfolio
components:
  schemas:
    ErrorResponse:
      type: object
      properties:
        success:
          const: false
        code:
          type: string
        message:
          type: string
        resolution:
          type: string
        error:
          type: string
        details:
          type: array
          items:
            type: object
            properties:
              field:
                type: string
              message:
                type: string
            required:
            - field
            - message
        retryAfterMs:
          type: number
        availableIndustries:
          type: array
          items:
            type: string
        example:
          type: string
          format: uri
      required:
      - success
      - code
      - message
      - resolution
      - error