API Cults・Cults

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é
l'API ne vous donnera pas accès aux fichiers 3D (ils resteront hébergés sur Cults pour des raisons légales) mais elle vous donnera accès à tout le reste : photos, titres, descriptions, tags, etc.

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"
        }
      }
    ]
  }
}