Doku

Referenz der REST-API und des MCP-Servers für registrierte Nutzer.

API

Schlüssel unter Verbindungen erstellen, Auftrag senden, Status lesen, Ergebnis herunterladen.

OpenAPI-Beschreibung (YAML)

API-Schlüssel →

MCP

Fügen Sie den Orisigil-Server einem MCP-Client hinzu und autorisieren Sie ihn mit Ihrem Konto.

Adresse des MCP-Servers: https://orisigil.com/mcp

MCP-Anwendungen →

Authentifizierung

Senden Sie einen API-Schlüssel im Header Authorization: Bearer <key>. Schlüssel erstellen Sie unter Verbindungen. Jeder Schlüssel hat die Berechtigungen sign, read und download.

Eine Datei in drei Anfragen signieren

# 1. Upload one file (multipart field "file")
curl -H "Authorization: Bearer $ORISIGIL_API_KEY" \
  -F file=@image.jpg https://orisigil.com/api/v1/assets

# 2. Create a batch of signing jobs (202 Accepted)
curl -H "Authorization: Bearer $ORISIGIL_API_KEY" \
  -H "Idempotency-Key: 7d1c3f62-run-42" -H "Content-Type: application/json" \
  -d '{"asset_ids":["<asset id>"],"options":{"creation_method":"ai_generated","tool":"Model X"}}' \
  https://orisigil.com/api/v1/signing-batches

# 3. Read the job; download the result when it is completed
curl -H "Authorization: Bearer $ORISIGIL_API_KEY" https://orisigil.com/api/v1/signing-jobs/<job id>
curl -H "Authorization: Bearer $ORISIGIL_API_KEY" -o signed.jpg \
  https://orisigil.com/api/v1/signing-jobs/<job id>/result

Fehler

Fehler haben einen stabilen error_code. Eine Datei über dem Limit ergibt 413 file_too_large mit max_size_bytes. Ein wiederholter Idempotency-Key mit anderer Anfrage ergibt 409 idempotency_conflict.