API-Referenz

Python- + HTTP-API

Dasselbe Vokabular auf beiden Seiten. Pydantic-Modelle auf der Leitung; FullOutput-Pydantic in Python. OpenAPI-Spezifikation automatisch generiert unter /openapi.json.

Python (in-process)

# Submit a SMILES, get a signed .mfsig.json
curl -X POST https://api.mfsig.com/v1/sigma_profile \
  -H "Authorization: Bearer $MFSIG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "smiles":  "CC(=O)Oc1ccccc1C(=O)O",
    "tier":    "pro",
    "solvent": "water"
  }'

# → 202 Accepted
#   { "job_id":"job_8K2…", "status":"queued",
#     "eta_s": 22 }

HTTP (FastAPI-Service)

# Poll, or supply a webhook_url and we POST on completion.
curl https://api.mfsig.com/v1/jobs/job_8K2... \
  -H "Authorization: Bearer $MFSIG_API_KEY"

# → 200 OK
#   { "status":   "done",
#     "mfsig_url":"https://mfsig.com/d/aspirin.mfsig.json",
#     "sha256":   "e3b0c44298fc1c14...",
#     "gates":    {"scf":true,"sigma":true,"audit":true,
#                  "geometry":true} }

Routen

GET/healthzops

Liveness-Probe. Gibt immer 200 zurück, wenn der Prozess läuft. Als Kubernetes-livenessProbe verwenden.

GET/readyzops

Readiness-Probe. 503, wenn kein Backend importierbar ist.

GET/methodsinfo

Verfügbarkeitsmatrix der Stufen: Pro / Platinum / Reference + Versionen + Presets.

POST/sigma_profilecompute

Die Hauptroute – σ-Profil für ein SMILES. Pro- / Platinum- / Reference-Stufen mit vollem Optionsvokabular.

POST/conformer_funnelcompute

Konformer-Ensemble-σ-Profil für flexible Gerüste. Boltzmann-gewichtete Ausgabe. Derselbe .mfsig-Audit-Trail pro Molekül.

POST/convert/from_legacyconvert

Vendor-.cosmo → MolForge-FullOutput-JSON. Inhalt inline oder über server_path übergeben. Vendor automatisch erkennen oder explizit angeben.

POST/convert/to_legacyconvert

MolForge-JSON → Vendor-Textformat. Turbomole / COSMOtherm σ / JSON / CSV.

POST/convert/databaseconvert

Serverseitige Batch-Verzeichnismigration. Idempotent, fortsetzbar, Diagnostik pro Datei im ConversionReport.

POST/mfsig/writeapex

Verpackt ein σ-Profil-Ergebnis in .mfsig.json v2.0-apex – SHA-256-Audit + Reproduzierbarkeit + optionaler legacy_vault.

POST/mfsig/verifyapex

Verifiziert den SHA-256-Trust-Hash. Manipulationssicher.

GET/openapi.jsondocs

Maschinenlesbare OpenAPI-3.x-Spezifikation.

GET/docsdocs

Swagger-UI für interaktive Erkundung.

GET/redocdocs

Redoc-UI für lesefreundliches Durchstöbern.

Authentifizierung + Sicherheit

Der Service wird ohne Authentifizierung ausgeliefert – gedacht für vertrauenswürdige interne Bereitstellung hinter einem Reverse-Proxy oder VPN. Exponieren Sie /convert/database nicht direkt ins Internet – es akzeptiert serverseitige Pfade. CORS ist standardmäßig permissiv; einschränken über die Umgebungsvariable ALLOWED_ORIGINS.

Observability

Beispiel-Logzeilejson

{
  "ts": "2026-05-12T01:24:01Z",
  "level": "INFO",
  "logger": "molforge_sigma.api",
  "msg": "sigma_profile smiles='O' method='dft' wall=12.4s n_atoms=3 n_segments=1432"
}