Genera un cliente local
Los paquetes públicos aún no están publicados para Java, Python ni Node.js. Genera un cliente local a partir del contrato público versionado usando el comando del generador fijado que aparece a continuación. Mantener fija la versión del generador hace que las actualizaciones del contrato sean deliberadas.
Configura las solicitudes
Ejecuta las llamadas desde un servidor de confianza, lee el token de acceso del entorno y usa la dirección base y los tiempos de espera mostrados en los ejemplos. Nunca pongas el token en código del navegador.
Lista las mascotas
Los ejemplos de Java, Python y Node.js que aparecen a continuación realizan la misma primera operación con bibliotecas estándar de la plataforma, por lo que no dependen de un paquete no publicado.
Gestiona los errores
Comprueba tanto el estado como el cuerpo de la respuesta. Conserva el identificador de la solicitud al contactar con soporte, pero nunca registres el token de acceso. Reintenta una escritura o la generación de una dieta solo cuando la solicitud se pueda repetir de forma segura.
Versión y origen
Genera clientes a partir del paquete público de OpenAPI. Fija las versiones del contrato y del generador en tu compilación para que las actualizaciones se revisen y sean repetibles.
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();