---
title: "Buone pratiche"
description: "Buone pratiche per un'integrazione delle API robusta ed efficiente"
url: "https://api-portal-suitelogi-ppr.stef.com/it/guides/best-practices"
image: "https://api-portal-suitelogi-ppr.stef.com/_og/d/c_Ocean.takumi,title_Buone+pratiche,description_Buone+pratiche+per+un'integrazione+delle+API+robusta+ed+efficiente,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiM1NTk2ZTYifX19,p_Ii9pdC9ndWlkZXMvYmVzdC1wcmFjdGljZXMi,s_J3lvF6vfG_T3HVH7.png"
---

**Portale per Sviluppatori**

-   [API](https://api-portal-suitelogi-ppr.stef.com/it/apis)
-   [Iniziare](https://api-portal-suitelogi-ppr.stef.com/it/getting-started)
-   [Guide](https://api-portal-suitelogi-ppr.stef.com/it/guides)
-   [Supporto](https://api-portal-suitelogi-ppr.stef.com/it/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)

## Buone pratiche

Pattern consigliati per costruire integrazioni robuste ed efficienti con le API STEF.

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

Rispetta gli header di rate limiting restituiti dall'API:

| Header                | Descrizione                                 |
| :-------------------- | :------------------------------------------ |
| X-RateLimit-Limit     | Numero massimo di richieste per finestra    |
| X-RateLimit-Remaining | Richieste rimanenti nella finestra corrente |
| X-RateLimit-Reset     | Timestamp di ripristino della finestra      |
| Retry-After           | Secondi da attendere (in caso di 429)       |

## [Sicurezza](#sicurezza)

### [Archiviazione dei segreti](#archiviazione-dei-segreti)

Non archiviare mai il tuo Client Secret o API Key direttamente nel codice sorgente.

Utilizza le variabili d'ambiente o un gestore di segreti:

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

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

## [Performance](#performance)

### [Caching](#caching)

-   Metti in cache le risposte degli endpoint di lettura che non cambiano frequentemente
-   Rispetta gli header `Cache-Control` e `ETag`
-   Utilizza le richieste condizionali (`If-None-Match`, `If-Modified-Since`)

### [Paginazione efficiente](#paginazione-efficiente)

-   Utilizza la paginazione basata su cursore fornita dall'API
-   Limita il numero di elementi per pagina (`limit`) allo stretto necessario
-   Evita di caricare tutte le pagine in una sola volta

### [Compressione](#compressione)

Abilita la compressione gzip nelle tue richieste:

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

## [Monitoraggio](#monitoraggio)

-   Registra i tempi di risposta e i codici di ritorno
-   Imposta avvisi sugli errori 4xx e 5xx
-   Monitora il consumo delle quote tramite il dashboard del portale

#### [API](#api)

-   [Catalogo delle API](https://api-portal-suitelogi-ppr.stef.com/it/apis)
-   [Guida introduttiva](https://api-portal-suitelogi-ppr.stef.com/it/getting-started)

#### [Sviluppatori](#sviluppatori)

-   [Documentazione](https://api-portal-suitelogi-ppr.stef.com/it/guides)
-   [Buone pratiche](https://api-portal-suitelogi-ppr.stef.com/it/guides/best-practices)
-   [Portali](https://api-portal-suitelogi-ppr.stef.com/it/getting-started/instances)

#### [Supporto](#supporto)

-   [Supporto tecnico](https://api-portal-suitelogi-ppr.stef.com/it/support)

#### [Lingue](#lingue)

-   [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 — Tutti i diritti riservati

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