Pour les développeurs

Imprimez depuis le code en un appel.

Une API REST, une ligne de commande, des webhooks signés et un serveur MCP. Commencez avec une clé de test : rien à imprimer, rien à installer.

Commencer

API REST

Un appel envoie un document à une imprimante nommée. Ajoutez une clé d’idempotence : une nouvelle tentative n’imprime jamais deux fois.

curl, tiré du guide de démarrage

KEY="quickstart-$(date +%s)"
printf '{"printerId":"%s","fileName":"report.pdf","contentBase64":"%s","externalReference":"quickstart-1"}' \
  "$PRINTER_ID" "$(base64 < report.pdf | tr -d '\n')" > job.json
JOB=$(curl -fsS "$SPOOLSTREAM_URL/v1/print-jobs" -H "Authorization: Bearer $SPOOLSTREAM_API_KEY" \
  -H "Idempotency-Key: $KEY" -H "Content-Type: application/json" -d @job.json)

Ligne de commande

Conçue pour les scripts : sortie JSON, codes de sortie documentés, jamais une question posée. Attendez le résultat avec une seule option.

spoolstream, tiré de la référence de la ligne de commande

export SPOOLSTREAM_URL="https://app.spoolstream.ca"
export SPOOLSTREAM_API_KEY="..."        # from your secret store; never on the command line
spoolstream login
spoolstream printers list --search lab3
spoolstream jobs submit report.pdf --printer Lab3 --copies 2 --wait

Webhooks signés

Sachez quand une tâche se termine. Les avis signés viennent avec nouvelles tentatives, renvoi et journal des envois.

MCP pour agents d’IA

Un agent peut lister les imprimantes et suivre les tâches. Il ne fait que lire, sauf si vous le démarrez avec l’accès en écriture.

Claude Code, tiré du guide MCP

claude mcp add spoolstream \
  --env SPOOLSTREAM_URL=https://app.spoolstream.ca \
  --env SPOOLSTREAM_API_KEY="$SPOOLSTREAM_API_KEY" \
  -- spoolstream mcp

Essayer d’abord

Une clé de test imprime sur une imprimante virtuelle. Mettez test-error ou test-uncertain dans une référence pour essayer votre gestion d’erreurs.

Client .NET

Une bibliothèque cliente envoie une tâche et attend son état final en quelques lignes.