studiomeyer-io Services API

openapi: 3.2.0
info:
  title: StudioMeyer Public Services 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: Services
paths:
  /api/v1/services:
    get:
      summary: Full service catalog with capabilities and delivery models
      operationId: get_services
      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
                  website:
                    type: string
                    format: uri
                  language:
                    type: string
                    enum:
                    - de
                    - en
                    - es
                  languageNote:
                    type: string
                  positioning:
                    type: string
                  webdesign:
                    type: object
                    properties:
                      url:
                        type: string
                        format: uri
                      description:
                        type: string
                      packages:
                        type: array
                        items:
                          type: object
                          required:
                          - id
                          - name
                          - price
                          - priceType
                          - delivery
                          properties:
                            id:
                              type: string
                              enum:
                              - fundament
                              - wachstum
                              - individuell
                            name:
                              type: string
                            price:
                              type: string
                            priceType:
                              type: string
                              enum:
                              - fixed
                              - from
                            delivery:
                              type: string
                            fixedPrice:
                              type: string
                      payment:
                        type: string
                      scope:
                        type: string
                      care:
                        type: object
                        required:
                        - name
                        - terms
                        - covers
                        properties:
                          name:
                            type: string
                          terms:
                            type: string
                          covers:
                            type: string
                    required:
                    - url
                    - description
                    - packages
                    - payment
                    - scope
                    - care
                  growth:
                    type: object
                    properties:
                      url:
                        type: string
                        format: uri
                      description:
                        type: string
                      pricing:
                        type: string
                    required:
                    - url
                    - description
                    - pricing
                  aiConnector:
                    type: object
                    properties:
                      name:
                        type: string
                      url:
                        type: string
                        format: uri
                      description:
                        type: string
                      standard:
                        type: string
                      pro:
                        type: string
                      note:
                        type: string
                    required:
                    - name
                    - url
                    - description
                    - standard
                    - pro
                    - note
                  automationAndAgents:
                    type: object
                    properties:
                      url:
                        type: string
                        format: uri
                      description:
                        type: string
                      pricing:
                        type: string
                    required:
                    - url
                    - description
                    - pricing
                  localAiSystems:
                    type: object
                    properties:
                      url:
                        type: string
                        format: uri
                      description:
                        type: string
                      pricing:
                        type: string
                    required:
                    - url
                    - description
                    - pricing
                  mcpServers:
                    type: array
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                        url:
                          type: string
                          format: uri
                        plans:
                          type: string
                      required:
                      - name
                      - url
                      - plans
                  forAgencies:
                    type: object
                    properties:
                      whiteLabel:
                        type: boolean
                      description:
                        type: string
                      contact:
                        type: string
                    required:
                    - whiteLabel
                    - description
                    - contact
                  industries:
                    type: array
                    items:
                      type: string
                  contact:
                    type: object
                    properties:
                      email:
                        type: string
                        format: email
                      contactPage:
                        type: string
                        format: uri
                      introCall:
                        type: string
                      consultationApi:
                        type: string
                        format: uri
                    required:
                    - email
                    - contactPage
                    - introCall
                    - consultationApi
                required:
                - agency
                - website
                - language
                - languageNote
                - positioning
                - webdesign
                - growth
                - aiConnector
                - automationAndAgents
                - localAiSystems
                - mcpServers
                - forAgencies
                - industries
                - contact
        '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: lang
        in: query
        required: false
        description: de or es (case-insensitive prefix); otherwise en. Quote body lang takes precedence.
        schema:
          type: string
      tags:
      - Services
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