api:graphql [Orbiq wiki]

Denna sida är skrivskyddad. Du kan titta på källkoden, men inte ändra den. Kontakta administratören om du anser att du bör kunna ändra sidan.

<markdown>












# Orbiqs GraphQL API

Orbiqs GraphQL API nås på `{Orbiqs URL}/graphql`.

## 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

```javascript
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 }
```

där `client_id` och `client_secret` är inlogg för en användare i Orbiq.

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>