---
title: "Guias"
description: "Guias técnicos e boas práticas para a integração de APIs"
url: "https://api-portal-ext.stef.com/pt/guides"
image: "https://api-portal-ext.stef.com/_og/d/c_Ocean.takumi,title_Guias,description_~R3VpYXMgdMOpY25pY29zIGUgYm9hcyBwcsOhdGljYXMgcGFyYSBhIGludGVncmHDp8OjbyBkZSBBUElz,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiM1NTk2ZTYifX19,p_Ii9wdC9ndWlkZXMi,s_YZ3lZx-vugdJ5i3X.png"
---

**Developer Portal**

[APIs](https://api-portal-ext.stef.com/pt/apis) [Introdução](https://api-portal-ext.stef.com/pt/getting-started) [Suporte](https://api-portal-ext.stef.com/pt/support)

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

## Guias técnicos

Documentação técnica, exemplos de código e recomendações para as suas integrações.

## Boas práticas

[Ler o guia →](https://api-portal-ext.stef.com/pt/guides/best-practices)

## Migração IBM → Kong

[Ler o guia →](https://api-portal-ext.stef.com/pt/guides/migration)

## [Outros recursos](#outros-recursos)

| Código | Significado                                        |
| :----- | :------------------------------------------------- |
| 400    | Pedido inválido                                    |
| 401    | Não autenticado                                    |
| 403    | Acesso negado                                      |
| 404    | Recurso não encontrado                             |
| 429    | Demasiados pedidos (limite de frequência atingido) |
| 500    | Erro interno do servidor                           |

As listas de recursos utilizam paginação por cursor. Parâmetros padrão:

-   `page[size]` — número de itens por página (predefinição: 20, máx.: 100)
-   `page[after]` — cursor para a página seguinte (valor do campo `meta.next`)

Exemplo:

```text
GET /v1/transport/orders?page[size]=50&page[after]=eyJpZCI6MTIzfQ==
```

Qualquer alteração incompatível com versões anteriores é publicada como uma nova versão principal. As versões anteriores permanecem ativas até ao fim do período de transição, comunicado antecipadamente através do portal.

#### [APIs](#apis)

-   [Catálogo de APIs](https://api-portal-ext.stef.com/pt/apis)
-   [Introdução](https://api-portal-ext.stef.com/pt/getting-started)

#### [Programadores](#programadores)

-   [Documentação](https://api-portal-ext.stef.com/pt/guides)
-   [Boas práticas](https://api-portal-ext.stef.com/pt/guides/best-practices)

#### [Suporte](#suporte)

-   [Suporte técnico](https://api-portal-ext.stef.com/pt/support)

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

© 2025 — Todos os direitos reservados