FS GraphQL API
FS GraphQL API lar deg utveksle data med FS, både for applikasjons- og integrasjonsbehov.
For å få tilgang, se her:
Dersom GraphQL er nytt for deg, anbefaler vi å lese våre GraphQL-veiledere.
URL til GraphQL-endepunkter
FS GraphQL API er tilgjengelig i flere miljø, pass på at du bruker riktig URL.
Produksjonsmiljø
Testmiljø
Tidlig tilgang til funksjonalitet under utvikling
Vi gir tidlig tilgang til funksjonalitet som er under utvikling, både i test- og produksjonsmiljøet.
For å unngå at noen tar i bruk uferdig funksjonalitet ved et uhell, er slik funksjonalitet opt-in.
Det vil si at må sette Feature-Flags
-headeren for å få med de delene av APIet som ikke er stabile.
Verdien for headeren skal være en kommaseparert liste av stabilitetsnivå man aksepterer.
I API-kontrakten skiller vi mellom stabilt, beta- og eksperimentelt nivå. Kunder som er med og tester, vil i så fall få beskjed direkte om verdien headeren skal inneholde.
Tilgang til | Header |
---|---|
Stabil | |
Stabil og beta | Feature-Flags: beta |
Stabil, beta og eksperimentell | Feature-Flags: beta,experimental |
Hvis du ønsker eksperimentell funksjonalitet, skal du alltid angi både beta
og experimental
i headeren. Dette er for å unngå at
spørringen din brekker hvis felter blir flyttet til beta uten at du er klar over det.
I Voyager kan du sette headerne med URL-parameteren ?flags
.
Her følger for enkelhets skyld lenker til Voyager for de forskjellige nivåene i de respektive miljøene:
- Produksjon
- Testmiljøet
I GraphiQL setter du headeren direkte i grensesnittet. Headeren må være JSON-formatert, slik:
{ "Feature-Flags": "beta,experimental" }
Endringslogg
Nyttige ressurser
Følgende kan være nyttige ressurser for å forstå hvordan man jobber med GraphQL: