Skillnader

Här visas skillnader mellan den valda versionen och den nuvarande versionen av sidan.

--- api:graphql [2023/04/28 11:35] – dokuadmin
+++ api:graphql [2023/05/10 09:18] (aktuell) – [GraphQL] dokuadmin
@@ Rad 1: / Rad 1: @@
 <markdown>
@@ Rad 21: / Rad 16: @@
 Orbiqs GraphQL API nås på `{Orbiqs URL}/graphql`.
-## Autentisera
+## GraphQL
+Om GraphQL känns som ett nytt koncept, börja med läsa [GraphQL:s egna guide](https://graphql.org/learn/).
+## Autentisering
  För att autentisera sig mot API:et krävs en giltig oauth2 token, som kan efterfrågas från {Orbiq URL}/oauth2/token. T.ex. med client_credentials
@@ Rad 28: / Rad 27: @@
 headers: {
     'Content-Type': 'application/x-www-form-urlencoded'
-}}),
+},
 body: "grant_type=client_credentials&client_id=example&client_secret=test&scope=iqalarm";
+// res => { "token": "abcd", "expiry": 3600 }
 ```
@@ Rad 35: / Rad 36: @@
 För requests till GraphQL API:et specificeras sedan autentiseringen i en header som `Authorization: Bearer {token}`, där `{token}` är ett giltigt token från Orbiq.
+## Utforska API:et
+API:et är självbeskrivande där tillgängliga frågor kan fås genom [Introspection](https://graphql.org/learn/introspection/). Förslagsvis är det bästa sättet att lära sig Orbiqs GraphQL API att utforska det med valfri GraphQL klient. Till exempel med [Altair](https://altairgraphql.dev/).
 </markdown>