Introdução às APIs
Siga este guia para configurar o seu acesso e efetuar a sua primeira chamada API.
Pré-requisitos
- Uma conta de programador neste portal
- Um cliente HTTP: cURL, Postman ou Insomnia
Passo 1 — Criar uma conta
- Clique em Registar no canto superior direito
- Preencha o formulário de registo
- Confirme o seu endereço de email através do link recebido
- Aguarde a aprovação da sua conta pelo administrador
Passo 2 — Criar uma aplicação
- Inicie sessão no portal
- Aceda a As minhas aplicações
- Clique em Criar uma aplicação
- Introduza o nome e a descrição
- Selecione as APIs a que pretende aceder
Passo 3 — Obter as suas credenciais
Depois de criar a sua aplicação:
- Copie o Application Secret apresentado e guarde-o num local seguro. Não será mais visível após este passo — pode gerar um novo se necessário.
Passo 4 — Primeira chamada API
Depois de a sua aplicação ser aprovada, pode testar uma chamada API:
curl -X GET "https://api.stef.com/v1/transport/orders" \
-H "X-STEF-Client-Id: <YOUR_APPLICATION_SECRET>" \
-H "Content-Type: application/json"