Aller au contenu

Qu'est-ce que GraphQL ?

GraphQL est un format d'API JSON qui vous permet de décider quels champs vous voulez récupérer.

Notez que :

  • il n'y a qu'une seul méthode HTTP : POST
  • il n'y a qu'une seule URL : https://cults3d.com/graphql
  • vous passez une chaîne de requête qui représente les données que vous souhaitez recevoir au format GraphQL
  • vous obtenez un retour JSON correspondant à chaque champ de chaque type que vous avez demandé

Autorisation

Tous les appels sont effectués en utilisant HTTP Basic Auth avec les identifiants qui vous ont été donnés.

Essayer l'API

Utilisez l'explorateur graphique pour parcourir et tester l'API. La documentation à droite vous montre toutes les données disponibles que vous pouvez consulter.

Exemple d'appel

Voici un exemple d'appel en ligne de commande utilisant curl:

curl https://cults3d.com/graphql -u your_username:your_password -d'query={
  creations(limit: 1) {
    name
    url
    creator {
      nick
    }
  }
}'

Les données JSON qui sortent sont dans le même format que la requête :

{
  "data": {
    "creations": [
      {
        "name": "frame wall hanger ",
        "url": "https://cults3d.com/en/3d-model/art/frame-wall-hanger-f745834a-4835-4db9-b28c-d1dff7bd4d64",
        "creator": {
          "nick": "3DPrinterFiles"
        }
      }
    ]
  }
}