Gato GraphQL vs WP REST API

Les différences entre les APIs REST et GraphQL sont généralement valables lorsqu'on compare la WP REST API avec Gato GraphQL.

Avec GraphQL, vous pouvez exécuter une requête GraphQL adaptée contre un endpoint, en indiquant les données spécifiques dont vous avez besoin, et en récupérant uniquement ces données dans une seule requête.

Par exemple, la requête GraphQL suivante récupérera les données nécessaires pour un article spécifique, y compris les données de ses relations (auteur, catégories et étiquettes), le tout dans une seule requête :

query {
  post(by: { id: 1 }) {
    title
    content
    url
    date
    author {
      id
      name
    }
    categories {
      id
      name
    }
    tags {
      id
      name
    }
  }
}Copy

Pour récupérer les mêmes données avec REST, vous devrez peut-être d'abord exécuter une requête pour récupérer les données de l'article, puis une requête supplémentaire pour chacune de ses relations (auteur, catégories et étiquettes) afin d'en obtenir les données.

Ces différences architecturales entre REST et GraphQL ont été largement abordées ailleurs, donc nous ne les répéterons pas ici.

Ci-dessous, faisons une comparaison plus spécifique entre Gato GraphQL + toutes les extensions, et la WP REST API.

​

Tableau récapitulatif

Résumé des points clés :

• Récupération de données : Gato GraphQL utilise des requêtes adaptées, tandis que la WP REST API utilise plusieurs requêtes vers des endpoints.
• Endpoints : Gato GraphQL utilise des persisted queries créées via une UI, tandis que la WP REST API utilise des endpoints REST codés en PHP.
• Contrôle d'accès : Gato GraphQL offre un contrôle au niveau des champs, tandis que la WP REST API utilise le paramètre context.
• Opérations en masse : Gato GraphQL utilise la Multiple Query Execution, et la WP REST API utilise les batch requests.
• Gestion du site : Gato GraphQL est un outil complet, et la WP REST API est principalement une API.

​

Accès aux données prédéfinies

Avec la WP REST API, vous exposez des données via des endpoints REST. Chaque endpoint possède sa propre URL, et ses données sont prédéfinies (pour les ressources correspondantes, telles que les articles ou les utilisateurs).

De façon similaire aux endpoints REST, Gato GraphQL prend en charge les Persisted queries, qui sont également des endpoints avec des données prédéfinies. Faire une requête à une persisted query via GET exécutera la requête GraphQL stockée et produira la réponse JSON attendue :

La différence entre eux est que les endpoints de la REST API sont créés via du code PHP et doivent être déployés dans un thème ou un plugin, tandis que les persisted queries de Gato GraphQL sont créées à l'aide du langage GraphQL et sont publiées via une interface utilisateur (propulsée par l'éditeur WordPress) dans le wp-admin, sans avoir besoin de déployer de code.

Les mêmes mécanismes de cache peuvent être appliqués aux endpoints REST et aux persisted queries GraphQL. Puisque la persisted query est accessible sous son propre endpoint, sa réponse peut être mise en cache avec le cache HTTP standard (PRO).

​

Contrôle d'accès

La restriction des données dans la WP REST API dépend du paramètre context. Passer ?context=view produit des données pour les utilisateurs non authentifiés, et ?context=edit inclut des données supplémentaires pour les utilisateurs authentifiés (avec les bonnes permissions), telles que le champ content.raw de l'article.

Gato GraphQL offre beaucoup plus de flexibilité, chaque champ étant accessible ou non selon les règles de Contrôle d'accès. Vous pouvez valider que seuls les utilisateurs connectés, ou les utilisateurs avec un certain rôle ou une certaine capacité, ou les visiteurs d'une certaine plage IP, peuvent accéder à un champ spécifique (PRO).

​

Opérations en masse

La WP REST API permet d'exécuter des batch requests, où plusieurs requêtes sont satisfaites en interne dans une seule requête HTTP.

Gato GraphQL fournit la Exécution de multiples requêtes, où un seul document GraphQL peut exécuter plusieurs opérations.

Multiple Query Execution est une amélioration des batch requests, car les opérations peuvent partager un état entre elles via la directive @export.

Par exemple, pour dupliquer un article, nous avons une opération query qui récupère les données de l'article et passe ces données à une opération mutation qui crée un nouvel article avec :

query GetPostAndExportData($postId: ID!)
{
  post(by: { id: $postId }, status: any) {
    author {
      id @export(as: "authorID")
    }
    categories {
      id @export(as: "categoryIDs", type: LIST)
    }
    rawContent @export(as: "rawContent")
    rawExcerpt @export(as: "excerpt")
    featuredImage {
      id @export(as: "featuredImageID")
    }
    tags {
      id @export(as: "tagIDs", type: LIST)
    }
    rawTitle @export(as: "title")
  }
}
 
mutation DuplicatePost
  @depends(on: "GetPostAndExportData")
{
  createPost(input: {
    status: draft,
    authorBy: {
      id: $authorID
    },
    categoriesBy: {
      ids: $categoryIDs
    },
    contentAs: {
      html: $rawContent
    },
    excerpt: $excerpt
    featuredImageBy: {
      id: $featuredImageID
    },
    tagsBy: {
      ids: $tagIDs
    },
    title: $title
  }) {
    postID
  }
}Copy

​

Gestion du site WordPress

Gato GraphQL nous permet de récupérer des données depuis la base de données, de les modifier selon les besoins et de les stocker en retour, le tout dans un seul document GraphQL.

Cela est réalisé via des interfaces utilisateur, pour composer et publier les requêtes GraphQL, configurer les endpoints selon les besoins et automatiser l'exécution d'une requête lorsqu'un événement se produit.

Tout cela signifie que Gato GraphQL est un outil générique pour gérer nos sites WordPress, satisfaisant les cas d'utilisation où des données (que ce soit depuis le site WordPress ou fournies par des services tiers) doivent être mutées, car cela peut être accompli en exécutant une requête GraphQL.

Remarquez comment Gato GraphQL peut remplir les fonctionnalités de plusieurs plugins :

• Ce n'est pas un plugin de duplication, pourtant vous pouvez dupliquer des articles avec lui.
• Ce n'est pas un plugin d'automatisation, mais vous pouvez automatiser vos tâches, sans aucune restriction.
• Ce n'est pas un plugin de sauvegarde, mais vous pouvez importer et exporter des articles.
• Ce n'est pas un plugin de recherche et remplacement, mais vous pouvez modifier vos articles en masse.
• Ce n'est pas un plugin de webhooks ni un client HTTP, mais vous pouvez à la fois envoyer une requête à n'importe quelle API, et recevoir et traiter des requêtes entrantes de n'importe quel service.
• Ce n'est pas un plugin de traduction, mais vous pouvez traduire n'importe quel contenu.

La WP REST API n'est que cela, une API.

Gato GraphQL est aussi une API, mais aussi bien plus.