---
title: "Best Practices"
description: "Best Practices für eine robuste und leistungsstarke API-Integration"
url: "https://api-portal-suitelogi-quaext.stef.com/de/guides/best-practices"
image: "https://api-portal-suitelogi-quaext.stef.com/_og/d/c_Ocean.takumi,title_Best+Practices,description_~QmVzdCBQcmFjdGljZXMgZsO8ciBlaW5lIHJvYnVzdGUgdW5kIGxlaXN0dW5nc3N0YXJrZSBBUEktSW50ZWdyYXRpb24,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiM1NTk2ZTYifX19,p_Ii9kZS9ndWlkZXMvYmVzdC1wcmFjdGljZXMi,s_VVBlh2cWbAuRUUOt.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)**

## Best Practices

Empfohlene Muster für den Aufbau robuster und leistungsstarker Integrationen mit den STEF-APIs.

## [Rate Limiting](#rate-limiting)

Beachten Sie die vom API zurückgegebenen Rate-Limiting-Header:

| Header                | Beschreibung                               |
| :-------------------- | :----------------------------------------- |
| X-RateLimit-Limit     | Maximale Anzahl von Anfragen pro Fenster   |
| X-RateLimit-Remaining | Verbleibende Anfragen im aktuellen Fenster |
| X-RateLimit-Reset     | Zeitstempel für die Fenster-Zurücksetzung  |
| Retry-After           | Sekunden zu warten (bei 429)               |

## [Sicherheit](#sicherheit)

### [Geheimnisverwaltung](#geheimnisverwaltung)

Speichern Sie Ihr Client Secret oder API Key niemals direkt im Quellcode.

Verwenden Sie Umgebungsvariablen oder einen Secrets Manager:

```bash
# .env
STEF_CLIENT_ID=your_client_id
STEF_CLIENT_SECRET=your_client_secret
```

```bash
# .gitignore
.env
```

## [Performance](#performance)

### [Caching](#caching)

-   Cachen Sie Antworten von Lese-Endpunkten, die sich nicht häufig ändern
-   Beachten Sie die Header `Cache-Control` und `ETag`
-   Verwenden Sie bedingte Anfragen (`If-None-Match`, `If-Modified-Since`)

### [Effiziente Paginierung](#effiziente-paginierung)

-   Verwenden Sie die vom API bereitgestellte cursor-basierte Paginierung
-   Begrenzen Sie die Anzahl der Elemente pro Seite (`limit`) auf das strikt Notwendige
-   Vermeiden Sie das Laden aller Seiten auf einmal

### [Komprimierung](#komprimierung)

Aktivieren Sie die gzip-Komprimierung in Ihren Anfragen:

```bash
curl -X GET "https://api.stef.com/v1/transport/orders" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Accept-Encoding: gzip"
```

## [Monitoring](#monitoring)

-   Protokollieren Sie Antwortzeiten und Rückgabecodes
-   Richten Sie Alarme für 4xx- und 5xx-Fehler ein
-   Überwachen Sie Ihren Quotenverbrauch über das Portal-Dashboard

#### [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)