Docs

Référence de l’API REST et du serveur MCP pour les utilisateurs inscrits.

API

Créez une clé dans Connexions, envoyez une tâche, lisez son statut, téléchargez le résultat.

Description OpenAPI (YAML)

Clés API →

MCP

Ajoutez le serveur Orisigil à un client MCP et autorisez-le avec votre compte.

Adresse du serveur MCP: https://orisigil.com/mcp

Applications MCP →

Authentification

Envoyez une clé API dans l’en-tête Authorization: Bearer <key>. Créez les clés dans Connexions. Chaque clé a les autorisations sign, read et download.

Signer un fichier en trois requêtes

# 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

Erreurs

Les erreurs ont un error_code stable. Un fichier au-delà de la limite renvoie 413 file_too_large avec max_size_bytes. Une Idempotency-Key réutilisée pour une autre requête renvoie 409 idempotency_conflict.