feat: schema_version 3 with DE/EN field descriptions

Signed-off-by: flemming-it <sf@flemming.it>
This commit is contained in:
flemming-it 2026-06-01 22:46:14 +02:00
parent 6c4c60004a
commit c54786b950

View file

@ -1,46 +1,94 @@
schema_version: 2 schema_version: 3
provider: fai provider: fai
name: http-request name: http-request
version: 0.1.0 version: 0.1.0
# Capability provided by this module.
provides: provides:
- capability: http.request - capability: http.request
version: 0.1.0 version: 0.1.0
# Inputs the invoke function accepts.
inputs: inputs:
# HTTP method as uppercase string. Supported: GET, POST, method:
# PUT, PATCH, DELETE, HEAD, OPTIONS. type: text
method: text description:
# Full URL including scheme. Must be https:// for production en: |
# use; http:// is permitted so loopback and air-gapped HTTP method as uppercase string. Supported: GET, POST,
# internal services work, but operator policy can clamp it. PUT, PATCH, DELETE, HEAD, OPTIONS.
url: text de: |
# Optional headers as JSON object string, e.g. HTTP-Methode in Großbuchstaben. Unterstützt: GET, POST,
# '{"Accept":"application/json","X-Tenant":"acme"}'. Empty PUT, PATCH, DELETE, HEAD, OPTIONS.
# string means no extra headers (Content-Type is auto-set url:
# when `body` is non-empty and the input is not already a type: text
# JSON-shaped string). description:
headers: text en: |
# Optional request body. Treated as UTF-8 text — binary Full URL including scheme. Use https:// for production;
# payloads should use a future `http.request-bytes` variant. http:// is permitted so loopback and air-gapped internal
body: text services work, but operator policy can clamp it.
de: |
Vollständige URL inkl. Schema. https:// für Produktion;
http:// erlaubt für Loopback / interne Services, kann
per Operator-Policy eingeschränkt werden.
headers:
type: text
description:
en: |
Optional headers as JSON object string, e.g.
'{"Accept":"application/json","X-Tenant":"acme"}'.
Empty = no extra headers (Content-Type is auto-set when
body is non-empty and not already JSON-shaped).
de: |
Optionale Header als JSON-Objekt-String, z. B.
'{"Accept":"application/json","X-Tenant":"acme"}'.
Leer = keine zusätzlichen Header (Content-Type wird
automatisch gesetzt, wenn body nicht-leer und nicht
bereits JSON-geformt ist).
body:
type: text
description:
en: |
Optional request body. Treated as UTF-8 text — binary
payloads should use a future `http.request-bytes`
variant.
de: |
Optionaler Request-Body. UTF-8-Text — binäre Payloads
sollen eine künftige `http.request-bytes`-Variante
nutzen.
# Outputs produced.
outputs: outputs:
# HTTP status code as decimal text (e.g. "200", "404"). status:
# Text rather than number so the audit-log entry stays type: text
# operator-readable without JSON re-parsing. description:
status: text en: |
# Response headers serialised as a JSON object (same shape HTTP status code as decimal text (e.g. "200", "404").
# as the input format) so downstream flow steps can pluck Text rather than number so the audit-log entry stays
# values like Content-Type or rate-limit headers. operator-readable without JSON re-parsing.
headers: text de: |
# Response body as UTF-8 text. Non-UTF-8 responses come HTTP-Statuscode als Dezimal-Text (z. B. "200", "404").
# through with replacement characters; that's acceptable Text statt Zahl, damit der Audit-Log-Eintrag ohne
# for v0.1.0 since the bytes-shaped variant covers binary. JSON-Re-Parsing operator-lesbar bleibt.
body: text headers:
type: text
description:
en: |
Response headers serialised as a JSON object (same shape
as the input format) so downstream flow steps can pluck
values like Content-Type or rate-limit headers.
de: |
Response-Header als JSON-Objekt serialisiert (gleiche
Form wie das Input-Format), damit nachgelagerte Schritte
Werte wie Content-Type oder Rate-Limit-Header abgreifen
können.
body:
type: text
description:
en: |
Response body as UTF-8 text. Non-UTF-8 responses come
through with replacement characters; binary uses the
bytes-shaped variant (future).
de: |
Response-Body als UTF-8-Text. Nicht-UTF-8-Antworten
kommen mit Replacement-Zeichen durch; binär verwendet
die bytes-Variante (zukünftig).
# Permissions required. # Permissions required.
# #