Wilkommen Guide

Willkommen im Velten Developer Portal! 🚀 Dieses kurze Onboarding zeigt dir, wie du Zugangsdaten erhältst, die wichtigsten APIs testest und dein Team auf den Produktivbetrieb vorbereitest.

Was dich erwartet

• 🔐 IAM API – Authentifizierung, Rollen und Token-Erstellung
• 🎨 Eco Badge API – Verwaltung der Umweltplaketten und Bestellprozesse
• 📁 Document API – Uploads, Freigaben und Dokument-Links

1. Zugang anfordern

1. ✉️ Schreibe an developer@velten.cloud und fordere Sandbox-Zugang an.
2. Du erhältst:
   • 🆔 Mandanten-ID und Basis-URLs
   • 🔑 Client-ID/Secret oder Benutzer-Credentials
   • 📬 Einen Verweis auf die aktuellen Postman-Collections

2. Token generieren

Verwende die IAM API, um dein erstes Token zu erzeugen. Beispiel (cURL):

curl -X POST https://api.dev.velten.cloud/iam/api/v1/auth/jwt \
  -H "Content-Type: application/json" \
  -d '{ "username": "sandbox-user", "password": "••••••" }'

Speichere das access_token 🔐 und nutze es als Authorization: Bearer <token> für alle weiteren Requests.

3. Badge Order anlegen

1. 📦 Prüfe bestehende Stocks: GET /badge/v2/api/v1/stocks
2. 📝 Lege eine Bestellung an: POST /badge/v2/api/v1/orders
3. ✍️ Notiere dir die Order-ID – sie verknüpft später Dokumente und Statusmeldungen.

Tipp: Nutze die generierten Seiten unter APIs → Eco Badge in der Navigation, um jeden Endpunkt inkl. Rapidoc-UI zu testen.

4. Dokumente hochladen

📁 Lade Bilder oder Formulare hoch und verbinde sie mit der Order:

POST /document/api/v1/documents
document_type = badge
document_type_id = <Order-ID>

Die Antwort enthält Direktlinks (Original, Thumbnail, signierter Download), die du im Kundenportal anzeigen kannst. 🔗

Support

Thema	Kontakt
🛠️ Technische Fragen & Bugs	developer@velten.cloud
📣 Produkt & Roadmap	Dein Velten Account Team
🔐 Sicherheit / Compliance	security@velten.cloud

Viel Erfolg beim Bauen! ✨ Wir freuen uns über Feedback zu diesem Guide und zu deinen Integrationen.