Deprecation-Benachrichtiger

Sendet Deprecation-Hinweise in der Antwort auf die Query (und nicht nur bei der Introspektion), unter dem Top-Level-Eintrag extensions.

​

Beschreibung

Immer wenn ein veraltetes Feld abgefragt wird, wird eine Deprecation-Nachricht in derselben GraphQL-Antwort zurückgegeben, unter dem Top-Level-Eintrag extensions.

Das informiert die Nutzer unserer APIs, damit sie ihre Verwendung des Schemas aktualisieren – auch wenn sie nicht auf die Introspection-Query achten.

Wenn du zum Beispiel diese Query ausführst, bei der das Feld isPublished veraltet ist:

query {
  posts {
    title
    isPublished
  }
}Copy

...wird diese Antwort erzeugt:

{
  "extensions": {
    "deprecations": [
      {
        "message": "Use 'isStatus(status:published)' instead of 'isPublished'",
        "extensions": {
          ...
        }
      }
    ]
  },
  "data": {
    "posts": [
      ...
    ]
  }
}Copy