Die API für Zustellnachweise in Agenten verwenden
Teste einen Stapel mit fiktiven Sendungen und verbinde deinen Agenten mit der Provanza-API.
Demo ohne Konto ausprobieren
Die Demo zeigt feste Antworten für fiktive Sendungen. Sie verwendet keine Zugangsdaten, kontaktiert keine Paketdienste und löst keine Anfragen oder Kosten aus.
- Ein verfügbarer Nachweis erreicht completed. Lade das gekennzeichnete Beispiel-PDF herunter.
- Die GLS-Zeile ist in der Vorschau ready. Beim Senden startet die Anfrage. Die Statusabfrage gibt needs_input zurück. Frage beim zuständigen Mitarbeiter nach der Zielpostleitzahl.
- Ein nicht verfügbarer Nachweis erreicht not_found mit document_not_found. Erfasse das Ergebnis ohne Nachweis.
Ergebnisse im Terminal anzeigen
Führe diesen Befehl mit curl und jq aus. Er lädt sample-pod.pdf herunter und prüft die Datei. Anschließend führt er den fiktiven Stapel auf dem Server aus und zeigt die Ergebnisse an. Setze DEMO_ORIGIN für die lokale Entwicklung auf die URL deines Webservers.
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'Einen MCP-Client verbinden
Füge diese URL in deinem MCP-Client als Streamable-HTTP-Server hinzu. Rufe lookup_carrier_evidence mit einer Paketdienst-Kennung wie gls auf. Rufe run_fictional_pod_demo ohne Argumente auf. Beide Werkzeuge sind öffentlich und benötigen keinen API-Schlüssel.
https://provanza.app/mcp
Verbindung zur Produktions-API herstellen
Sende Anfragen an diesen API-Ursprung. https://api.provanza.app
Ein Inhaber oder Administrator der Organisation erstellt einen Schlüssel unter Einstellungen → API-Zugriff. Dazu ist ein aktiver Growth- oder Pro-Tarif oder ein Testzeitraum erforderlich.
Speichere den Schlüssel auf deinem Server. Sende Authorization: Bearer <api key> an /api/v1. Prüfe die Vorschau und hole eine Freigabe für kostenpflichtige Anfragen ein.
POST /api/v1/pod-requests/batch/previewSende entries mit clientId und value. Ergänze bei Bedarf carrier, carrierNetwork oder postalCode. Die Vorschau prüft jede Zeile, ohne Anfragen zu starten oder Kontingent zu verbrauchen.
POST /api/v1/pod-requests/batchSende die geprüften Einträge mit derselben optionalen Stapel-Postleitzahl postalCode. Die Antwort enthält rows und kann eine Stapelgruppe enthalten. Zeilen mit needs_postal_code in der Vorschau starten keine neuen Anfragen. Neue Zeilen können auf freies Kontingent warten.
GET /api/v1/pod-requests/{id}Lies jede rows[].request.id aus der Antwort. Frage den Status bei queued oder processing erneut ab. Lies bei needs_input in inputRequired, welche Daten fehlen. Beende die Abfrage bei completed, not_found oder failed.
GET /api/v1/pod-requests/{id}/artifactLies delivery bei einem abgeschlossenen Auftrag mit verfügbarem Dokument. Rufe bei public_url die downloadUrl ohne API-Schlüssel ab. Dekodiere bei inline_payload den Wert bodyBase64. Halte Download-URLs geheim.