GraphQL

Meister1 używa interfejsu API GraphQL. GraphQL to język zapytań, który pozwala klientowi określić, jakich danych potrzebuje.

Tutaj pokrótce pokażemy, jak wygląda żądanie HTTP w GraphQL. Przyjrzymy się również niektórym typowym przypadkom użycia.

Endpoint: https://api.meister1.com/graphql

uwaga

Do zapytań należy używać nagłówka Authorization z accessToken (patrz Autoryzacja)

Ogólne

Zasadniczo każde żądanie wygląda tak samo. Jest to żądanie POST. Schemat oczekiwany jako odpowiedź jest zdefiniowany w treści żądania.

Żądanie

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

Odpowiedź

{
  "data": {
    "viewer": {
      "id": "VSFlcgox",
      "email": "user@meister1.de"
    }
  }
}

Kreator zapytań

Przełączaj powyżej między trybem Odczyt (zapytania) i Zapis (mutacje). Wybierz jedno lub więcej zapytań albo mutacji — zostaną scalone, a operacja GraphQL jest generowana na żywo. W przypadku mutacji pokazywane są także możliwe wartości (np. status leada).

Dostępne zapytania

Wybrane zapytania

Nie wybrano jeszcze żadnych zapytań — wyświetlane jest tylko zapytanie bazowe.

GraphQL Query

query {
  viewer {
    id
    email
  }
}