---
title: "Best practices"
description: "Best practices voor robuuste en performante API-integratie"
url: "https://api-portal-suitelogi-ppr.stef.com/nl/guides/best-practices"
image: "https://api-portal-suitelogi-ppr.stef.com/_og/d/c_Ocean.takumi,title_Best+practices,description_Best+practices+voor+robuuste+en+performante+API-integratie,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiM1NTk2ZTYifX19,p_Ii9ubC9ndWlkZXMvYmVzdC1wcmFjdGljZXMi,s_RdFgOyAi6j0g7yuX.png"
---

**Ontwikkelaarsportaal**

-   [API's](https://api-portal-suitelogi-ppr.stef.com/nl/apis)
-   [Aan de slag](https://api-portal-suitelogi-ppr.stef.com/nl/getting-started)
-   [Handleidingen](https://api-portal-suitelogi-ppr.stef.com/nl/guides)
-   [Ondersteuning](https://api-portal-suitelogi-ppr.stef.com/nl/support)

[FR](https://api-portal-suitelogi-ppr.stef.com/)|[EN](https://api-portal-suitelogi-ppr.stef.com/en)|[ES](https://api-portal-suitelogi-ppr.stef.com/es)|[IT](https://api-portal-suitelogi-ppr.stef.com/it)|[PT](https://api-portal-suitelogi-ppr.stef.com/pt)|**[NL](https://api-portal-suitelogi-ppr.stef.com/nl)**|[DE](https://api-portal-suitelogi-ppr.stef.com/de)

## Best practices

Aanbevolen patronen voor het bouwen van robuuste en performante integraties met de STEF API's.

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

Respecteer de rate limiting headers die door de API worden geretourneerd:

| Header                | Beschrijving                                |
| :-------------------- | :------------------------------------------ |
| X-RateLimit-Limit     | Maximum aantal verzoeken per venster        |
| X-RateLimit-Remaining | Resterende verzoeken in het huidige venster |
| X-RateLimit-Reset     | Tijdstempel van vensterreset                |
| Retry-After           | Seconden te wachten (bij 429)               |

## [Beveiliging](#beveiliging)

### [Opslag van geheimen](#opslag-van-geheimen)

Sla uw Client Secret of API Key nooit rechtstreeks op in de broncode.

Gebruik omgevingsvariabelen of een secrets manager:

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

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

## [Prestaties](#prestaties)

### [Caching](#caching)

-   Sla antwoorden op van leesendpoints die niet vaak veranderen
-   Respecteer de headers `Cache-Control` en `ETag`
-   Gebruik voorwaardelijke verzoeken (`If-None-Match`, `If-Modified-Since`)

### [Efficiënte paginering](#efficiënte-paginering)

-   Gebruik de cursorgebaseerde paginering die door de API wordt geboden
-   Beperk het aantal items per pagina (`limit`) tot het strikt noodzakelijke
-   Vermijd het laden van alle pagina's in één keer

### [Compressie](#compressie)

Schakel gzip-compressie in uw verzoeken in:

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

## [Monitoring](#monitoring)

-   Log reactietijden en retourcodes
-   Stel waarschuwingen in voor 4xx- en 5xx-fouten
-   Monitor uw quotumverbruik via het portaaldashboard

#### [API's](#apis)

-   [API-catalogus](https://api-portal-suitelogi-ppr.stef.com/nl/apis)
-   [Aan-de-slag-gids](https://api-portal-suitelogi-ppr.stef.com/nl/getting-started)

#### [Ontwikkelaars](#ontwikkelaars)

-   [Documentatie](https://api-portal-suitelogi-ppr.stef.com/nl/guides)
-   [Best practices](https://api-portal-suitelogi-ppr.stef.com/nl/guides/best-practices)
-   [Portalen](https://api-portal-suitelogi-ppr.stef.com/nl/getting-started/instances)

#### [Ondersteuning](#ondersteuning)

-   [Technische ondersteuning](https://api-portal-suitelogi-ppr.stef.com/nl/support)

#### [Talen](#talen)

-   [Français](https://api-portal-suitelogi-ppr.stef.com/)
-   [English](https://api-portal-suitelogi-ppr.stef.com/en)
-   [Español](https://api-portal-suitelogi-ppr.stef.com/es)
-   [Italiano](https://api-portal-suitelogi-ppr.stef.com/it)
-   [Português](https://api-portal-suitelogi-ppr.stef.com/pt)
-   [Nederlands](https://api-portal-suitelogi-ppr.stef.com/nl)
-   [Deutsch](https://api-portal-suitelogi-ppr.stef.com/de)

© 2026 STEF — Alle rechten voorbehouden

[Mentions légales](https://www.stef.com/mentions-legales) · [Politique de confidentialité](https://www.stef.com/politique-confidentialite)