GraphQL
Meister1 utilizza un'API GraphQL. GraphQL è un linguaggio di query che permette al client di determinare quali dati sono necessari.
Qui mostreremo brevemente come appare una richiesta HTTP in GraphQL. Esamineremo anche alcuni casi d'uso tipici.
Endpoint: https://api.meister1.com/graphql
Per le query deve essere utilizzato un header Authorization con il accessToken (vedi Autorizzazione)
Generale
In sostanza, ogni richiesta ha lo stesso aspetto. Si tratta di una richiesta POST. Lo schema atteso come risposta è definito nel corpo.
Richiesta
query {
viewer {
id
email
}
}
cURL
curl 'https://api.meister1.com/graphql' -H 'Content-Type: application/json' \
--data-binary '{"query":"query {\n viewer {\n id\n email\n }\n}"}' --compressed
Risposta
{
"data": {
"viewer": {
"id": "VSFlcgox",
"email": "user@meister1.de"
}
}
}
Generatore di query
Passa sopra tra Lettura (query) e Scrittura (mutation). Seleziona una o più query o mutation: vengono unite e l'operazione GraphQL viene generata in tempo reale. Per le mutation vengono mostrati anche i valori possibili (ad es. lo stato del lead).
Nessuna query selezionata: viene mostrata solo la query di base.
query {
viewer {
id
email
}
}