Portal do Desenvolvedor

FR|EN|ES|IT|PT|NL|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

ElementoIBM API ConnectKong Konnect
URL basehttps://api.stef.com/https://api.stef.com/
AutenticaçãoClient ID / Secret IBMOAuth 2.0 / API Key Kong
GatewayDataPowerKong Gateway
PortalDrupal (connect_theme)Kong Dev Portal v3 (MDC)
EspecificaçõesSwagger 2.0OpenAPI 3.0
Limitação de taxaBaseado em planosBaseado em plugins (configurável)

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

O formato dos erros mudou:

Formato IBM antigo

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

Novo formato Kong

{
  "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

  • 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

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.