Deprecazione
DeprecazioneNotificatore di Deprecazioni

Notificatore di Deprecazioni

Included in the “Power Extensions” bundle

Invia le deprecazioni nella risposta alla query (e non solo durante l'introspezione), sotto la voce di primo livello extensions.

Descrizione

Ogni volta che viene interrogato un campo deprecato, viene restituito un messaggio di deprecazione nella stessa risposta GraphQL, sotto la voce di primo livello extensions.

Questo avvisa gli utenti delle nostre API affinché aggiornino il loro utilizzo dello schema, anche quando non prestano attenzione alla query di introspezione.

Ad esempio, eseguendo questa query, dove il campo isPublished è deprecato:

query {
  posts {
    title
    isPublished
  }
}

...verrà prodotta questa risposta:

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