---
title: "Guia de migração"
description: "Guia de migração do IBM API Connect para o Kong Konnect Dev Portal"
url: "https://api-portal-suitelogi-ppr.stef.com/pt/guides/migration"
image: "https://api-portal-suitelogi-ppr.stef.com/_og/d/c_Ocean.takumi,title_~R3VpYSBkZSBtaWdyYcOnw6Nv,description_~R3VpYSBkZSBtaWdyYcOnw6NvIGRvIElCTSBBUEkgQ29ubmVjdCBwYXJhIG8gS29uZyBLb25uZWN0IERldiBQb3J0YWw,props_eyJ0aGVtZSI6eyJtb2RlIjoibGlnaHQiLCJjb2xvcnMiOnsicHJpbWFyeSI6IiM1NTk2ZTYifX19,p_Ii9wdC9ndWlkZXMvbWlncmF0aW9uIg,s_QyyYwJfM1DT1FDBY.png"
---

**Portal do Desenvolvedor**

-   [APIs](https://api-portal-suitelogi-ppr.stef.com/pt/apis)
-   [Começar](https://api-portal-suitelogi-ppr.stef.com/pt/getting-started)
-   [Guias](https://api-portal-suitelogi-ppr.stef.com/pt/guides)
-   [Suporte](https://api-portal-suitelogi-ppr.stef.com/pt/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)

## Migração IBM API Connect → Kong Konnect

Este guia acompanha-o na migração das suas integrações do antigo portal IBM API Connect para o novo portal Kong Konnect.

## [Resumo das alterações](#resumo-das-alterações)

| Elemento          | IBM API Connect        | Kong Konnect                      |
| :---------------- | :--------------------- | :-------------------------------- |
| URL base          | https://api.stef.com/  | https://api.stef.com/             |
| Autenticação      | Client ID / Secret IBM | OAuth 2.0 / API Key Kong          |
| Gateway           | DataPower              | Kong Gateway                      |
| Portal            | Drupal (connect_theme) | Kong Dev Portal v3 (MDC)          |
| Especificações    | Swagger 2.0            | OpenAPI 3.0                       |
| Limitação de taxa | Baseado em planos      | Baseado em plugins (configurável) |

## [Passo 1: Novas credenciais](#passo-1-novas-credenciais)

As suas credenciais IBM API Connect existentes continuam a funcionar para as subscrições já ativas.

No entanto, para qualquer nova subscrição de uma API, deve:

1.  Criar uma conta no novo portal (se ainda não tiver feito)
2.  Criar uma nova aplicação
3.  Subscrever as APIs desejadas
4.  Obter as suas novas credenciais (API Key)

Os antigos Client ID e Client Secret IBM já não funcionam nos novos endpoints. Planeie um período de transição com configuração dupla se necessário.

## [Passo 2: Tratamento de erros](#passo-2-tratamento-de-erros)

O formato dos erros mudou:

### [Formato IBM antigo](#formato-ibm-antigo)

```json
{
  "httpCode": "404",
  "httpMessage": "Not Found",
  "moreInformation": "Resource not found"
}
```

### [Novo formato Kong](#novo-formato-kong)

```json
{
  "status": 404,
  "title": "Not Found",
  "detail": "The requested resource was not found",
  "instance": "/v1/transport/orders/invalid-id"
}
```

## [Lista de verificação de migração](#lista-de-verificação-de-migração)

-   [ ]  Criar uma nova conta no portal Kong
-   [ ]  Criar uma aplicação e obter as credenciais
-   [ ]  Adaptar a análise de erros ao novo formato

## [Suporte de migração](#suporte-de-migração)

## Precisa de ajuda para migrar?

A nossa equipa de suporte está disponível para o acompanhar na sua migração. Não hesite em contactar-nos.

#### [APIs](#apis)

-   [Catálogo de APIs](https://api-portal-suitelogi-ppr.stef.com/pt/apis)
-   [Guia de início](https://api-portal-suitelogi-ppr.stef.com/pt/getting-started)

#### [Desenvolvedores](#desenvolvedores)

-   [Documentação](https://api-portal-suitelogi-ppr.stef.com/pt/guides)
-   [Boas práticas](https://api-portal-suitelogi-ppr.stef.com/pt/guides/best-practices)
-   [Portais](https://api-portal-suitelogi-ppr.stef.com/pt/getting-started/instances)

#### [Suporte](#suporte)

-   [Suporte técnico](https://api-portal-suitelogi-ppr.stef.com/pt/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 os direitos reservados

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