As definições de Swagger ou OpenAPI são arquivos de dados que descrevem todos os métodos e parâmetros de uma API REST. Você pode baixar e consumir esses arquivos de dados localmente como referência pessoal da API.
Para usar as definições de Marketo Engage Swagger/OpenAPI, o campo host
de cada documento deve ser atualizado para corresponder ao nome de host da API REST da sua instância de Marketo Engage.
Primeiro, baixe a definição de OpenAPI que deseja usar:
Em seguida, obtenha o nome de host da API REST do administrador do Marketo. Acesse o menu Admin-> Serviços da Web no Marketo Engage e copie o nome do host do campo Ponto de extremidade. O hostname
é a cadeia de caracteres entre o protocolo https://
e /rest
, que se parece com AAA-999-AAA.mktorest.com
Abra o arquivo OpenAPI em um editor de texto e localize o campo host
no JSON e altere seu valor para o nome de host da API REST: "host":"localhost:8080"
para "host":"AAA-999-AAA.mktorest.com"
.
Depois de salvo, você pode executar o arquivo de definição na instância da interface do usuário do Swagger ou em qualquer outro software OpenAPI.