--- title: "Erste Schritte" description: "Leitfaden für externe Kunden zum Zugriff auf das API-Portal, zur Erstellung von Anwendungen, zur API-Anmeldung und zum API-Verbrauch." url: "https://api-portal-suitelogi-quaext.stef.com/de/getting-started" image: "https://api-portal-suitelogi-quaext.stef.com/_og/d/c_Ocean.takumi,title_Erste+Schritte,description_~TGVpdGZhZGVuIGbDvHIgZXh0ZXJuZSBLdW5kZW4genVtIFp1Z3JpZmYgYXVmIGRhcyBBUEktUG9ydGFsLCB6dXIgRXJzdGVsbHVuZyB2b24gQW53ZW5kdW5nZW4sIHp1ciBBUEktQW5tZWxkdW5nIHVuZCB6dW0gQVBJLVZlcmJyYXVjaC4,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiM1NTk2ZTYifX19,p_Ii9kZS9nZXR0aW5nLXN0YXJ0ZWQi,s_oyAFo7wxvJ6uiLfI.png" --- **Entwicklerportal** - [APIs](https://api-portal-suitelogi-quaext.stef.com/de/apis) - [Erste Schritte](https://api-portal-suitelogi-quaext.stef.com/de/getting-started) - [Anleitungen](https://api-portal-suitelogi-quaext.stef.com/de/guides) - [Support](https://api-portal-suitelogi-quaext.stef.com/de/support) [FR](https://api-portal-suitelogi-quaext.stef.com/)|[EN](https://api-portal-suitelogi-quaext.stef.com/en)|[ES](https://api-portal-suitelogi-quaext.stef.com/es)|[IT](https://api-portal-suitelogi-quaext.stef.com/it)|[PT](https://api-portal-suitelogi-quaext.stef.com/pt)|[NL](https://api-portal-suitelogi-quaext.stef.com/nl)|**[DE](https://api-portal-suitelogi-quaext.stef.com/de)** ## Erste Schritte mit den STEF-APIs Folgen Sie dieser Anleitung, um Ihr Konto zu aktivieren, Ihre Anwendung zu erstellen, APIs zu abonnieren und sie sicher aufzurufen. ## [1\. Anmeldung im API-Portal](#_1-anmeldung-im-api-portal) Mit dem STEF API-Portal können Sie STEF-APIs über persönliche Consumer-Anwendungen oder über teamübergreifend geteilte Anwendungen abonnieren. - Für den Zugriff auf das Portal müssen Sie die Erstellung eines Kundenkontos anfordern. - Wenden Sie sich hierzu an Ihren STEF-IT-Ansprechpartner, der die notwendigen Schritte einleitet. - Sie erhalten eine Einladung, mit der Sie Ihr Konto erstellen und sich auf den STEF-Portalen für Qualifikation und Produktion anmelden können. Das Passwort muss alle 200 Tage erneuert werden. Beim Anmelden im Portal werden Sie auf die erforderliche Aktualisierung hingewiesen. ### [Zugang zu den API-Portalen](#zugang-zu-den-api-portalen) - Produktion: [https://api-portal-ext.stef.com/](https://api-portal-ext.stef.com/) - Qualifikation: [https://api-portal-quaext.stef.com/](https://api-portal-quaext.stef.com/) Damit Sie eine mit Ihrem Team geteilte Consumer-Anwendung erstellen können, muss Ihr STEF-IT-Ansprechpartner die Erstellung eines Teams veranlassen. ## [2\. Eine Anwendung erstellen](#_2-eine-anwendung-erstellen) Um eine API zu nutzen, benötigen Sie zunächst eine Consumer-Anwendung. Beim Erstellen wird ein **Credential** generiert, das Ihre Anwendung bei API-Aufrufen identifiziert. 1. Klicken Sie oben rechts im Portal auf Ihr Profil 2. Klicken Sie auf die Schaltfläche **Applications** 3. Klicken Sie auf die Schaltfläche **New application** 4. Geben Sie Name und Beschreibung Ihrer Anwendung ein 5. Um die Anwendung mit Ihrem Team zu teilen, aktivieren Sie **This is a team owned application** und wählen das gewünschte Team aus 6. Klicken Sie auf die Schaltfläche **Create application** 7. Notieren Sie das beim Erstellen erzeugte Credential Dieses Credential wird nur bei der Erstellung Ihrer Anwendung angezeigt und ist danach nicht mehr sichtbar. Bewahren Sie es sicher auf. ## [3\. Eine API abonnieren](#_3-eine-api-abonnieren) Eine Consumer-Anwendung kann je nach Bedarf eine oder mehrere APIs abonnieren. Verwenden Sie das Menü **APIs**, um den Katalog der verfügbaren STEF-APIs anzuzeigen. Navigieren Sie zu den für Sie relevanten Produkten, um die technische Entwicklerdokumentation aufzurufen. Diese enthält für jede API: - Die unterstützten Operationen - Die Definition der Eingabe- und Ausgabeobjekte - Codebeispiele zur Nutzung der APIs So abonnieren Sie eine API: 1. Öffnen Sie die Detailansicht einer API 2. Klicken Sie oben rechts auf **Use this API** 3. Klicken Sie bei der gewünschten Anwendung auf die Schaltfläche **Register** Das Abonnement muss anschließend von STEF validiert werden. Wenden Sie sich dafür an Ihren STEF-IT-Ansprechpartner. Da eine Anwendung mehrere APIs abonnieren kann, wiederholen Sie den Abonnementvorgang für jede API, die Sie verwenden möchten. ### [Abonnements einsehen und verwalten](#abonnements-einsehen-und-verwalten) Um die Abonnements einer Anwendung einzusehen, klicken Sie oben links auf Ihr Profil und anschließend auf **Applications**. Öffnen Sie dann den Namen Ihrer Anwendung. Im automatisch angezeigten Tab **APIs** finden Sie die Liste Ihrer Abonnements samt Status. Über dieses Menü können Sie auch weitere API-Abonnements anfordern, indem Sie auf **\+ API** klicken. ## [4\. Eine API nutzen](#_4-eine-api-nutzen) Alle Aufrufe von STEF-APIs laufen über das STEF API Gateway, um Zugriffsrichtlinien durchzusetzen, die Backend-Services des STEF-Informationssystems zu schützen und Aufrufstatistiken zu erfassen. Die API-Gateway sind unter folgenden URLs erreichbar: - Produktion: [https://api-suitelogi-ext.stef.com](https://api-suitelogi-ext.stef.com) - Qualifikation: [https://api-suitelogi-quaext.stef.com](https://api-suitelogi-quaext.stef.com) Um eine API gemäß den Zugriffssicherheitsregeln zu nutzen, fügen Sie der Anfrage den HTTP-Header `X-STEF-Client-Id` hinzu und belegen ihn mit dem Credential Ihrer Consumer-Anwendung. Die technische Entwicklerdokumentation enthält für jede auf der Plattform veröffentlichte API Codebeispiele, mit denen Sie das API Gateway aus verschiedenen Sprachen aufrufen können: Shell, Python, Node.js, JavaScript, Go, Java, C# und Ruby. ### [Beispielaufruf](#beispielaufruf) ```bash curl -X GET "https://api.stef.com/v1/transport/orders" \ -H "X-STEF-Client-Id: " \ -H "Content-Type: application/json" ``` Zusätzlich zu den Codebeispielen bietet die technische Entwicklerdokumentation Formulare, mit denen Sie APIs direkt im Portal im interaktiven Modus über die Schaltfläche **Try it!** aufrufen können. ## [Nächste Schritte](#nächste-schritte) ## API-Katalog [APIs anzeigen →](https://api-portal-suitelogi-quaext.stef.com/de/apis) ## Technische Anleitungen [Anleitungen anzeigen →](https://api-portal-suitelogi-quaext.stef.com/de/guides) ## APIM-Instanzen [Instanzen anzeigen →](https://api-portal-suitelogi-quaext.stef.com/de/getting-started/instances) #### [APIs](#apis) - [API-Katalog](https://api-portal-suitelogi-quaext.stef.com/de/apis) - [Erste-Schritte-Anleitung](https://api-portal-suitelogi-quaext.stef.com/de/getting-started) #### [Entwickler](#entwickler) - [Dokumentation](https://api-portal-suitelogi-quaext.stef.com/de/guides) - [Best Practices](https://api-portal-suitelogi-quaext.stef.com/de/guides/best-practices) - [Portale](https://api-portal-suitelogi-quaext.stef.com/de/getting-started/instances) #### [Support](#support) - [Technischer Support](https://api-portal-suitelogi-quaext.stef.com/de/support) #### [Sprachen](#sprachen) - [Français](https://api-portal-suitelogi-quaext.stef.com/) - [English](https://api-portal-suitelogi-quaext.stef.com/en) - [Español](https://api-portal-suitelogi-quaext.stef.com/es) - [Italiano](https://api-portal-suitelogi-quaext.stef.com/it) - [Português](https://api-portal-suitelogi-quaext.stef.com/pt) - [Nederlands](https://api-portal-suitelogi-quaext.stef.com/nl) - [Deutsch](https://api-portal-suitelogi-quaext.stef.com/de) © 2026 STEF — Alle Rechte vorbehalten [Mentions légales](https://www.stef.com/mentions-legales) · [Politique de confidentialité](https://www.stef.com/politique-confidentialite)