API testen

Mutations ändern Inhalte direkt im CMS. Achten Sie beim Testen von Funktionen wie dem Anlegen oder Bearbeiten von Benutzern darauf, keine unbeabsichtigten Änderungen vorzunehmen – diese können nicht rückgängig gemacht werden.

Mit Postman

  1. Postman herunterladen, installieren und Einloggen.

  2. Klicken Sie oben links im Menü auf New und wählen Sie GraphQL aus. Bild

  3. Unter Authorization wählen Sie bei Auth Type die Option Bearer Token aus. Bild

  4. Geben Sie hier den API-Token ein, den Sie im CMS unter Einstellungen > Entwickler durch Klick auf Token anzeigen erhalten. Bild

  5. Tragen Sie unter URL die folgende Adresse ein: https://api.appack.de/graphql.

  6. Um Ihr Access Token zu bekommen, führen Sie folgende Query aus:

    query {
        getToken
    }
  7. Tauschen Sie nun den API-Token durch das erhaltene Access Token aus.

  8. Klicken Sie anschließend unter Schema auf Use GraphQL Introspection, um das Schema zu laden.

Im Query-Tab sehen Sie nun alle verfügbaren Queries und Mutations. Sie können Funktionen auswählen, die Sie verwenden möchten, indem Sie den entsprechenden Haken setzen. Postman erstellt automatisch den passenden Query.

Für eine detailliertere Anleitung zu Postman können Sie folgende Seite besuchen:
GraphQL mit Postman testen

Mit GraphiQL

Alternativ können Sie die API direkt über die Web-Oberfläche testen, ohne Software herunterladen zu müssen. Besuchen Sie dafür https://cdn.appack.de/graphiql/index.html. Dort lassen sich Queries und Mutations ohne Konfigurationsaufwand direkt im Browser ausführen.