Português
English
A resposta curta: o Insomnia, e a maioria dos clientes de API, importa a nossa especificação OpenAPI e cria os pedidos todos de uma vez. O que muda de um cliente para outro é o nome dos menus; os passos são os mesmos: importar, pôr a chave numa variável, autenticar com Bearer e testar.
No Insomnia
|
|
|
|
|
Noutros clientes
Clientes como o Bruno e o Hoppscotch também importam especificações OpenAPI. Procure a opção de importar, escolha OpenAPI e siga a mesma ordem. Em qualquer um, a autenticação é sempre a mesma: o cabeçalho Authorization: Bearer seguido da chave.
Se a importação falhar
| Sintoma | O que tentar |
| O cliente diz que não reconhece a versão | A especificação está em OpenAPI 3.1. Actualize o cliente: versões antigas de algumas ferramentas só lêem a 3.0. |
| A importação pela ligação não funciona | Descarregue o ficheiro e importe-o a partir do disco. |
| Os pedidos vão para o endereço errado | Confirme o endereço base no ambiente ou na colecção. Os caminhos já começam por /v1. |
| Erro 401 | A chave está em falta, mal escrita, revogada ou fora da validade. Veja se a variável tem valor no ambiente activo. |
| Um cliente de secretária guarda a chave nos dados dele. Use uma chave sandbox_ para ensaiar, não exporte colecções com a chave e, se a partilhar por engano, revogue-a: o que fazer, pela ordem certa. |
| Prefere o Postman? Os passos dele, com as variáveis certas, estão em importar a API no Postman. |
|
A ligação da especificação está no fim da Referência da API. Ver a especificação |
PRODUTO RECOMENDADO Hospedagem de sites com cPanel Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde 321,75 MT/mês (plano de 3 anos, com cupão) Ver planos |
