Deprecation

Entwickle das GraphQL-Schema weiter, indem du Felder als veraltet markierst und erklärst, wie sie ersetzt werden können – über eine Benutzeroberfläche.

​

Veraltete Felder

Benutzeroberfläche, um Felder im GraphQL-Schema als veraltet zu markieren.

​

Deprecation-Benachrichtigung

Wenn ein veraltetes Feld abgefragt wird, wird eine Deprecation-Meldung in derselben GraphQL-Antwort zurückgegeben, unter dem Eintrag extensions auf oberster Ebene.

Das informiert Nutzer unserer APIs darüber, ihre Verwendung des Schemas zu aktualisieren – auch wenn sie die Introspection-Query nicht beachten.

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

query {
  posts {
    title
    isPublished
  }
}Copy

...wird folgende Antwort zurückgegeben:

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