---
title: "Buenas prácticas"
description: "Buenas prácticas para una integración de APIs robusta y eficiente"
url: "https://api-portal-suitelogi-ppr.stef.com/es/guides/best-practices"
image: "https://api-portal-suitelogi-ppr.stef.com/_og/d/c_Ocean.takumi,title_~QnVlbmFzIHByw6FjdGljYXM,description_~QnVlbmFzIHByw6FjdGljYXMgcGFyYSB1bmEgaW50ZWdyYWNpw7NuIGRlIEFQSXMgcm9idXN0YSB5IGVmaWNpZW50ZQ,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiM1NTk2ZTYifX19,p_Ii9lcy9ndWlkZXMvYmVzdC1wcmFjdGljZXMi,s_k-vwB3xfAEwUyOVz.png"
---

**Portal del Desarrollador**

-   [APIs](https://api-portal-suitelogi-ppr.stef.com/es/apis)
-   [Comenzar](https://api-portal-suitelogi-ppr.stef.com/es/getting-started)
-   [Guías](https://api-portal-suitelogi-ppr.stef.com/es/guides)
-   [Soporte](https://api-portal-suitelogi-ppr.stef.com/es/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)

## Buenas prácticas

Patrones recomendados para construir integraciones robustas y eficientes con las APIs de STEF.

## [Limitación de velocidad](#limitación-de-velocidad)

Respete los encabezados de limitación de velocidad devueltos por la API:

| Encabezado            | Descripción                                       |
| :-------------------- | :------------------------------------------------ |
| X-RateLimit-Limit     | Número máximo de solicitudes por ventana          |
| X-RateLimit-Remaining | Solicitudes restantes en la ventana actual        |
| X-RateLimit-Reset     | Marca de tiempo de restablecimiento de la ventana |
| Retry-After           | Segundos a esperar (en caso de 429)               |

## [Seguridad](#seguridad)

### [Almacenamiento de secretos](#almacenamiento-de-secretos)

Nunca almacene su Client Secret o API Key directamente en el código fuente.

Utilice variables de entorno o un gestor de secretos:

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

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

## [Rendimiento](#rendimiento)

### [Caché](#caché)

-   Almacene en caché las respuestas de los endpoints de lectura que no cambian frecuentemente
-   Respete los encabezados `Cache-Control` y `ETag`
-   Utilice solicitudes condicionales (`If-None-Match`, `If-Modified-Since`)

### [Paginación eficiente](#paginación-eficiente)

-   Utilice la paginación por cursor proporcionada por la API
-   Limite el número de elementos por página (`limit`) al mínimo estrictamente necesario
-   Evite cargar todas las páginas de una sola vez

### [Compresión](#compresión)

Active la compresión gzip en sus solicitudes:

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

## [Monitorización](#monitorización)

-   Registre los tiempos de respuesta y los códigos de retorno
-   Configure alertas sobre errores 4xx y 5xx
-   Supervise su consumo de cuotas a través del panel del portal

#### [APIs](#apis)

-   [Catálogo de APIs](https://api-portal-suitelogi-ppr.stef.com/es/apis)
-   [Guía de inicio](https://api-portal-suitelogi-ppr.stef.com/es/getting-started)

#### [Desarrolladores](#desarrolladores)

-   [Documentación](https://api-portal-suitelogi-ppr.stef.com/es/guides)
-   [Buenas prácticas](https://api-portal-suitelogi-ppr.stef.com/es/guides/best-practices)
-   [Portales](https://api-portal-suitelogi-ppr.stef.com/es/getting-started/instances)

#### [Soporte](#soporte)

-   [Soporte técnico](https://api-portal-suitelogi-ppr.stef.com/es/support)

#### [Idiomas](#idiomas)

-   [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 — Todos los derechos reservados

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