Cernion Willi Regulatorik API

openapi: 3.2.0
info:
  title: Cernion Energy Tools Willi Regulatorik 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-Regulatorik
paths:
  /api/willi-regulatorik/search:
    post:
      summary: Willi-Regulatorik regulatory knowledge search (read-only)
      tags:
      - Willi-Regulatorik
      operationId: willi_regulatorik_search
      parameters:
      - $ref: '#/components/parameters/TokenQuery'
      responses:
        '200':
          description: Read-only Willi-Regulatorik search result
          content:
            application/json:
              example:
                success: true
                data:
                  source: willi-regulatorik-service
                  returned: 3
                  results:
                  - id: wr-1
                    slug: bk6-festlegung-netzanschluss-fristen
                    title: 'BK6-Festlegung: Fristen für Netzanschlussprüfung'
                    score: 32
                    category: regulatory
                    tags:
                    - BNetzA
                    - Festlegung
                    excerpt: Kurzfassung des Artikels...
                    url: https://stromhaltig.de/wissen/bk6-festlegung-netzanschluss-fristen
      description: Read-only search over regulatory (BNetzA/EnWG/EEG) articles via the internal MCP tool `cernion_willi_regulatorik_search`. Returns article/context evidence for validation logic, structural hints and explanation context; it 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: BNetzA Festlegung Netzanschluss Fristen
                limit:
                  type: number
                  minimum: 1
                  maximum: 20
                  default: 5
                  example: 3
                tag:
                  type: string
                  example: Festlegung
                category:
                  type: string
                  example: regulatory
                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: BNetzA Festlegung Netzanschluss Fristen
                  limit: 3
  /api/willi-regulatorik/resolve-structure:
    post:
      summary: Willi-Regulatorik structure-oriented validation-planning view (read-only…
      tags:
      - Willi-Regulatorik
      operationId: willi_regulatorik_resolveStructure
      parameters:
      - $ref: '#/components/parameters/TokenQuery'
      responses:
        '200':
          description: Read-only structure-oriented validation-planning view
      description: Calls `willi-regulatorik.search` internally and returns a conservative, structure-oriented view (sources, structural hints, validation candidates, no-call boundaries, confidence) useful for regulatory validation planning. Never autonomously executes, validates, or dispatches any regulatory filing.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - query
              properties:
                query:
                  type: string
                  example: BNetzA Festlegung Netzanschluss Fristen
                limit:
                  type: number
                  minimum: 1
                  maximum: 20
                  default: 5
                  example: 5
                tag:
                  type: string
                  example: Festlegung
                category:
                  type: string
                  example: regulatory
                token:
                  type: string
                  description: Optional Cernion MCP token for this request. Overrides CERNION_TOKEN when provided.
            examples:
              default:
                value:
                  query: BNetzA Festlegung Netzanschluss Fristen
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.'