🚀 Willkommen zur ZB REST API

Kurzanleitung

1. Aktionsbeginn
   Bitte setzten Sie sich mit uns in Verbindung, um den Start der Aktion zu initieren
   Anruf +49 89 327290-32
   Mail [email protected]
2. Authentifizierung:
   POST /api/Auth/login

   {
     "aktion": "SENDUNG_ERZEUGEN",
     "kundenPasswort": "IhrKundenPasswort",
     "aktionsPasswort": "IhrAktionsPasswort"
   }

   Sie erhalten ein JSON Web Token (JWT) für nachfolgende Anfragen.
3. Adressen übertragen:
   POST /api/SkybillAktionenAdressen

   [
     {
       "aktion": "SENDUNG_ERZEUGEN",
       "name1": "Max Mustermann",
       "strasse": "Musterstraße",
       "hausNr": "1",
       "plz": "12345",
       "ort": "Musterstadt",
       "land": "DEU"
     }
   ]

4. Adressen abrufen (CSV):
   GET /api/aktionen/{aktionName}/adressen.csv?aktionsPasswort=IhrAktionsPasswort
5. Länder abrufen:
   GET /api/Laender
6. Freigabe durch Zollblitz
   Anruf +49 89 327290-32
   Mail [email protected]
7. PDF-Etiketten (Oktoberfest):
   GET /api/SkybillEtikett?aktion=AKTION_NAME[&skybnr=ZBL ... ......]
8. PDF-Frachtbriefe (Oktoberfest):
   GET /api/OktoberfestFrachtbrief?aktion=AKTION_NAME[&skybnr=ZBL ... ......]

Interaktive Dokumentation (Swagger UI)

Für detaillierte Informationen und Tests nutzen Sie unsere Swagger-Oberfläche:

Zur Swagger UI

Beispielhafte Request-Übersicht

# Login
authToken=$(curl -s -X POST https://api.zollblitz.de/api/Auth/login \
  -H "Content-Type: application/json" \
  -d '{"aktion":"SENDUNG_ERZEUGEN","kundenPasswort":"geheim","aktionsPasswort":"akt123"}')

# Adressen posten
curl -X POST https://api.zollblitz.de/api/SkybillAktionenAdressen \
  -H "Authorization: Bearer $authToken" \
  -H "Content-Type: application/json" \
  -d '@adressen.json'

# CSV herunterladen
curl -X GET "https://api.zollblitz.de/api/aktionen/SENDUNG_ERZEUGEN/adressen.csv?aktionsPasswort=akt123" \
  -H "Authorization: Bearer $authToken" -o adressen.csv

# Länder abrufen
curl -X GET https://api.zollblitz.de/api/Laender \
  -H "Authorization: Bearer $authToken"