Gerar um cliente local
Ainda não foram publicados pacotes públicos para Java, Python ou Node.js. Gere um cliente local a partir do contrato público versionado utilizando o comando do gerador fixado apresentado abaixo. Manter a versão do gerador fixa torna as atualizações do contrato deliberadas.
Configurar pedidos
Execute as chamadas a partir de um servidor confiável, leia o token de acesso do ambiente e utilize o endereço base e os tempos limite apresentados nos exemplos. Nunca coloque o token no código do navegador.
Listar animais
Os exemplos de Java, Python e Node.js abaixo executam a mesma primeira operação com bibliotecas padrão da plataforma, pelo que não dependem de um pacote ainda não publicado.
Tratar erros
Verifique o estado e o corpo da resposta. Guarde o identificador do pedido ao contactar o suporte, mas nunca registe o token de acesso. Repita uma operação de escrita ou a geração de uma dieta apenas quando o pedido puder ser repetido com segurança.
Versão e origem
Gere clientes a partir do pacote público OpenAPI. Fixe as versões do contrato e do gerador no seu processo de compilação para que as atualizações sejam revistas e reproduzíveis.
Java
curl --fail --silent --show-error https://api.barflab.io/openapi.yaml -o openapi.yaml
docker run --rm -v "$PWD:/local" openapitools/openapi-generator-cli:v7.24.0 generate \
-i /local/openapi.yaml -g java -o /local/generated/barflab-java \
--additional-properties=library=native
Java HTTP
var request = HttpRequest.newBuilder(URI.create(
"https://api.barflab.io/v1/pets"))
.header("Authorization", "Bearer " + System.getenv("BARFLAB_TOKEN"))
.header("Accept", "application/json")
.timeout(Duration.ofSeconds(30))
.GET()
.build();
var response = httpClient.send(request, BodyHandlers.ofString());
Python
curl --fail --silent --show-error https://api.barflab.io/openapi.yaml -o openapi.yaml
docker run --rm -v "$PWD:/local" openapitools/openapi-generator-cli:v7.24.0 generate \
-i /local/openapi.yaml -g python -o /local/generated/barflab-python
Python HTTP
import os
import urllib.request
request = urllib.request.Request(
"https://api.barflab.io/v1/pets",
headers={
"Authorization": f"Bearer {os.environ['BARFLAB_TOKEN']}",
"Accept": "application/json",
},
)
with urllib.request.urlopen(request, timeout=30) as response:
body = response.read()
Node.js
curl --fail --silent --show-error https://api.barflab.io/openapi.yaml -o openapi.yaml
docker run --rm -v "$PWD:/local" openapitools/openapi-generator-cli:v7.24.0 generate \
-i /local/openapi.yaml -g typescript-fetch -o /local/generated/barflab-node
Node.js HTTP
const response = await fetch(
"https://api.barflab.io/v1/pets",
{
headers: {
Authorization: `Bearer ${process.env.BARFLAB_TOKEN}`,
Accept: "application/json",
},
signal: AbortSignal.timeout(30_000),
},
);
const body = await response.json();