Foretag Deres første API-kald

En grundlæggende GET-anmodning kræver kun en URL og en metode. Valgfrie headere og forespørgselsparametre finjusterer den. De fleste første kald består af én enkelt kodelinje.

Bed din assistent skrive linjen på dit sprog og forklare hver del, så du forstår, hvad du sender, i stedet for at kopiere blindt.

I JavaScript sender fetch anmodningen og returnerer et promise. Du afventer svaret og kalder derefter response.json() for at hente de fortolkede data.

Dette totrinsmønster, fetch efterfulgt af fortolkning, er grundlaget for næsten enhver browserbaseret integration, du kommer til at bygge med en assistent.

Det fortolkede svar er normalt et JSON-objekt. Du finder værdier i det via en nøgle, f.eks. data.results[0].name, for at hente den værdi, du ønsker.

Hvis strukturen forvirrer dig, kan du indsætte det faktiske svar i din assistent og bede om den nøjagtige sti til det felt, du har brug for.

Forespørgselsparametre står efter et spørgsmålstegn i URL'en, f.eks. ?city=Paris&units=metric. De filtrerer eller former det, endpointet returnerer.

Byg dem omhyggeligt, for en slåfejl betyder forkerte eller tomme data. Din assistent kan pålideligt konstruere en URL med parametre ud fra dine input.

Nogle endpoints kræver headere, f.eks. Accept: application/json eller en indholdstype. Headere følger med anmodningen som metadata og er adskilt fra URL'en.

Når dokumentationen nævner en påkrævet header, skal du bede din assistent inkludere den i fetch-indstillingsobjektet, så kaldet accepteres.

Før du kobler data til din brugerflade, skal du logge svaret til konsollen. Når du ser det rå objekt, bekræfter det, at kaldet virkede, og afslører de faktiske feltnavne.

Denne vane opdager overraskelser tidligt. Mange integrationsfejl skyldes blot, at et felt hedder noget andet end det, dokumentationen antydede.

Når du har dataene, er det sidste trin at gengive dem. Du tildeler den fortolkede værdi til en variabel, som din visning viser, f.eks. en tekstetiket eller et listeelement.

Beskriv den brugerflade, du ønsker, for din assistent sammen med svarstrukturen, og lad den generere gengivelseskoden til dit framework.

Hvis dit første kald mislykkes, skal du kontrollere statuskoden og stavningen af URL'en. En 404 betyder et forkert endpoint, en 401 betyder manglende godkendelse, og en slåfejl betyder tomme data.

Indsæt den nøjagtige fejl og din kode i din assistent. Med begge dele kan den normalt finde løsningen i ét svar.

Et fungerende første kald er en milepæl. Det samme mønster – byg URL, fetch, fortolk, gengiv – gælder for næsten enhver API, du nogensinde kommer til at bruge.

Når ét kald virker, består udskiftningen med et nyt endpoint for det meste i at ændre URL'en og de felter, du læser. Færdigheden kan bruges direkte andre steder.

Du valgte en enkel API, byggede en anmodning med valgfrie parametre og headere, sendte den med fetch, fortolkede JSON'en, loggede den og gengav resultatet.

Fejl aflæses fra statuskoder og rettes med din assistent. Derefter skal du håndtere API-nøgler sikkert og håndtere fejl på en robust måde.