Cernion Willi Federated API

openapi: 3.2.0
info:
  title: Cernion Energy Tools Willi Federated 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-Federated
paths:
  /api/willi-federated/search:
    post:
      summary: Willi-Federated Marktkommunikation/regulatory knowledge search (read-only)
      tags:
      - Willi-Federated
      operationId: willi_federated_search
      parameters:
      - $ref: '#/components/parameters/TokenQuery'
      responses:
        '200':
          description: Read-only Willi-Federated search result
          content:
            application/json:
              example:
                success: true
                data:
                  source: willi-federated-service
                  returned: 3
                  results:
                  - id: wf-1
                    slug: gpke-lieferantenwechsel-fristen
                    title: 'GPKE: Fristen beim Lieferantenwechsel'
                    score: 32
                    category: edifact
                    tags:
                    - GPKE
                    - Frist
                    excerpt: Kurzfassung des Artikels...
                    url: https://stromhaltig.de/wissen/gpke-lieferantenwechsel-fristen
      description: Read-only federated search in parallel across Marktkommunikation/EDIFACT and regulatory (BNetzA/EnWG/EEG) collections via the internal MCP tool `cernion_willi_federated_search`. Returns article/context evidence for validation logic, structural hints and explanation context; it does not send, validate or dispatch any MaKo message and does not file, submit or act on any regulatory process step.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - query
              properties:
                query:
                  type: string
                  example: Welche Fristen gelten für den Lieferantenwechsel nach GPKE?
                limit:
                  type: number
                  minimum: 1
                  maximum: 20
                  default: 5
                  example: 3
                tag:
                  type: string
                  example: GPKE
                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: Welche Fristen gelten für den Lieferantenwechsel nach GPKE?
                  limit: 3
  /api/willi-federated/resolve-structure:
    post:
      summary: Willi-Federated structure-oriented validation-planning view (read-only…
      tags:
      - Willi-Federated
      operationId: willi_federated_resolveStructure
      parameters:
      - $ref: '#/components/parameters/TokenQuery'
      responses:
        '200':
          description: Read-only structure-oriented validation-planning view
      description: Calls `willi-federated.search` internally and returns a conservative, structure-oriented view (sources, structural hints, validation candidates, no-call boundaries, confidence) useful for MaKo/regulatory validation planning. Never autonomously executes, validates, or dispatches a MaKo message or regulatory filing.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - query
              properties:
                query:
                  type: string
                  example: Welche Fristen gelten für den Lieferantenwechsel nach GPKE?
                limit:
                  type: number
                  minimum: 1
                  maximum: 20
                  default: 5
                  example: 5
                tag:
                  type: string
                  example: GPKE
                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: Welche Fristen gelten für den Lieferantenwechsel nach GPKE?
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.'