Luo paikallinen asiakas
Javan, Pythonin tai Node.js:n julkisia paketteja ei ole vielä julkaistu. Luo paikallinen asiakas versioidusta julkisesta sopimuksesta käyttäen alla näytettyä lukittua generaattorikomentoa. Generaattorin version pitäminen kiinteänä tekee sopimuspäivityksistä harkittuja.
Määritä pyynnöt
Suorita kutsut luotetulta palvelimelta, lue käyttöoikeustunnus ympäristöstä ja käytä esimerkeissä näytettyä perusosoitetta ja aikakatkaisuja. Älä koskaan sijoita tunnusta selaimen koodiin.
Listaa lemmikit
Alla olevat Java-, Python- ja Node.js-esimerkit suorittavat saman ensimmäisen toiminnon alustan vakiokirjastoilla, joten ne eivät riipu julkaisemattomasta paketista.
Käsittele virheet
Tarkista sekä vastauksen tila että sisältö. Säilytä pyyntötunnus ottaessasi yhteyttä tukeen, mutta älä koskaan kirjaa käyttöoikeustunnusta. Yritä kirjoitusta tai ruokavalion luontia uudelleen vain, jos pyynnön voi toistaa turvallisesti.
Versio ja lähde
Luo asiakkaat julkisesta OpenAPI-paketista. Lukitse sopimuksen ja generaattorin versiot koontiversiossasi, jotta päivitykset voidaan tarkistaa ja toistaa.
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();