Docs

Referência da API REST e do servidor MCP para usuários cadastrados.

API

Crie uma chave em Conexões, envie uma tarefa, leia o status e baixe o resultado.

Descrição OpenAPI (YAML)

Chaves de API →

MCP

Adicione o servidor do Orisigil a um cliente MCP e autorize-o com sua conta.

Endereço do servidor MCP: https://orisigil.com/mcp

Aplicativos MCP →

Autenticação

Envie uma chave de API no cabeçalho Authorization: Bearer <key>. Crie as chaves em Conexões. Cada chave tem as permissões sign, read e download.

Assinar um arquivo em três solicitações

# 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

Erros

Os erros têm um error_code estável. Um arquivo acima do limite retorna 413 file_too_large com max_size_bytes. Uma Idempotency-Key repetida com outra solicitação retorna 409 idempotency_conflict.