Provanza

Utiliser l’API de preuve de livraison dans un agent

Essayez un lot fictif de preuves de livraison, puis connectez votre agent à l’API Provanza.

Essayer la démo sans compte

La démo rejoue des réponses fixes pour des envois fictifs. Elle n’utilise aucun identifiant, ne contacte aucun transporteur et ne crée aucune demande ni aucuns frais.

  • Une preuve disponible passe à completed. Téléchargez le PDF marqué comme exemple pour voir le résultat.
  • La ligne GLS est ready dans l’aperçu et démarre à l’envoi du lot. Le statut passe à needs_input. Demandez le code postal de destination à l’opérateur.
  • Une preuve indisponible passe à not_found avec document_not_found. Consignez le résultat sans joindre de preuve.
Télécharger le PDF fictifOuvrir les données de démo (JSON)

Lire les résultats dans un terminal

Exécutez cette commande avec curl et jq. Elle télécharge et vérifie sample-pod.pdf, exécute le lot fictif sur le serveur puis affiche les résultats. En développement local, attribuez l’URL de votre serveur web à DEMO_ORIGIN.

DEMO_ORIGIN="${DEMO_ORIGIN:-https://provanza.app}"
DEMO_ORIGIN="${DEMO_ORIGIN%/}"
curl -fsS -o sample-pod.pdf "$DEMO_ORIGIN/tools/sample-pod.pdf" &&
test "$(head -c 5 sample-pod.pdf)" = '%PDF-' &&
test "$(tail -n 1 sample-pod.pdf)" = '%%EOF' &&
result=$(curl -fsS -X POST "$DEMO_ORIGIN/tools/pod-demo/run") &&
printf '%s\n' "$result" |
  jq -e 'select(.fictional == true and .status == "completed") | .outcomes'

Connecter un client MCP

Ajoutez cette URL comme serveur Streamable HTTP dans votre client MCP. Appelez lookup_carrier_evidence avec un identifiant de transporteur, par exemple gls. Appelez run_fictional_pod_demo sans argument. Les deux outils sont publics et ne nécessitent aucune clé d’API.

https://provanza.app/mcp

Se connecter à l’API de production

Envoyez les requêtes à cette origine de l’API. https://api.provanza.app

Un propriétaire ou administrateur de l’organisation crée une clé dans Paramètres → Accès à l’API. Il faut un abonnement Growth ou Pro actif ou en période d’essai.

Conservez la clé sur votre serveur. Envoyez Authorization: Bearer <api key> à /api/v1. Vérifiez l’aperçu et obtenez un accord avant d’envoyer des demandes facturables.

  1. POST /api/v1/pod-requests/batch/preview

    Envoyez entries avec clientId et value. Ajoutez carrier, carrierNetwork ou postalCode si nécessaire. L’aperçu classe les lignes sans lancer de demandes ni consommer le quota.

  2. POST /api/v1/pod-requests/batch

    Envoyez les entrées vérifiées avec le même postalCode de lot facultatif. La réponse contient rows et peut contenir un groupe de lot. Une ligne marquée needs_postal_code dans l’aperçu ne lance aucune demande. De nouvelles lignes peuvent attendre du quota.

  3. GET /api/v1/pod-requests/{id}

    Lisez chaque rows[].request.id dans la réponse de soumission. Consultez le statut tant qu’il est queued ou processing. Pour needs_input, lisez inputRequired pour savoir quelle donnée demander. Arrêtez à completed, not_found ou failed.

  4. GET /api/v1/pod-requests/{id}/artifact

    Lisez delivery pour une demande terminée avec un document disponible. Pour public_url, récupérez downloadUrl sans transmettre la clé d’API. Pour inline_payload, décodez bodyBase64. Gardez les URL de téléchargement secrètes.