Cernion Willi-Mako Marktkommunikation API

openapi: 3.2.0
info:
  title: Cernion Energy Tools Willi-Mako Marktkommunikation API
  version: 0.99.22
  description: 'MicroService Agent System for Energy Markets - REST API with AI integration.


    CERNION_TOKEN: request at https://cernion.de/ or by email: dev@stromdao.com.


    For the public instance at https://api.cernion.de/, create your token at https://cernion.de/cet-token/.'
servers:
- url: https://api.cernion.de
  description: API Server
tags:
- name: Willi-Mako Marktkommunikation
paths:
  /api/willi-mako/search:
    post:
      summary: Willi-Mako Marktkommunikation knowledge search (read-only)
      tags:
      - Willi-Mako Marktkommunikation
      operationId: willi_mako_search
      parameters:
      - $ref: '#/components/parameters/TokenQuery'
      responses:
        '200':
          description: Read-only Willi-Mako search result
          content:
            application/json:
              example:
                success: true
                data:
                  source: willi-mako-service
                  returned: 3
                  results:
                  - id: wm-1
                    slug: aperak-frist-effizienz
                    title: 'APERAK-Frist: Effizienz in der Marktkommunikation steigern'
                    score: 32
                    category: edifact
                    tags:
                    - APERAK
                    - Frist
                    excerpt: Kurzfassung des Artikels...
                    url: https://stromhaltig.de/wissen/aperak-frist-effizienz
      description: Read-only search over Willi-Mako / Marktkommunikation articles via the internal MCP tool `cernion_willi_mako_search`. Returns article/context evidence for validation logic, structural hints and explanation context; it does not send, validate or dispatch any MaKo message.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - query
              properties:
                query:
                  type: string
                  example: APERAK Fehlercode Frist Marktkommunikation
                limit:
                  type: number
                  minimum: 1
                  maximum: 20
                  default: 5
                  example: 3
                tag:
                  type: string
                  example: APERAK
                category:
                  type: string
                  example: edifact
                includeContent:
                  type: boolean
                  default: false
                  example: false
                token:
                  type: string
                  description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
            examples:
              default:
                value:
                  query: APERAK Fehlercode Frist Marktkommunikation
                  limit: 3
  /api/willi-mako/resolve-structure:
    post:
      summary: Willi-Mako structure-oriented validation-planning view (read-only, advisory)
      tags:
      - Willi-Mako Marktkommunikation
      operationId: willi_mako_resolveStructure
      parameters:
      - $ref: '#/components/parameters/TokenQuery'
      responses:
        '200':
          description: Read-only structure-oriented validation-planning view
      description: Calls `willi-mako.search` internally and returns a conservative, structure-oriented view (sources, structural hints, validation candidates, no-call boundaries, confidence) useful for MaKo validation planning. Never autonomously executes, validates, or dispatches a MaKo message.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - query
              properties:
                query:
                  type: string
                  example: APERAK Fehlercode Frist Marktkommunikation
                limit:
                  type: number
                  minimum: 1
                  maximum: 20
                  default: 5
                  example: 5
                tag:
                  type: string
                  example: APERAK
                category:
                  type: string
                  example: edifact
                token:
                  type: string
                  description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
            examples:
              default:
                value:
                  query: APERAK Fehlercode Frist Marktkommunikation
components:
  parameters:
    TokenQuery:
      name: token
      in: query
      required: false
      schema:
        type: string
      description: Optional Cernion MCP token as URL query parameter. If provided, it overrides CERNION_TOKEN for this request. Prefer Authorization Bearer header in production to reduce token exposure in URLs/logs.
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: 'Optional Cernion MCP token. If not provided, falls back to CERNION_TOKEN from environment. Request token at https://cernion.de/ or by email: dev@stromdao.com.'