Cults API・Cults

Что такое GraphQL?

GraphQL - это тип JSON API, который позволяет вам решать, какие поля вы хотите получить.

Обратите внимание, что:

существует только один метод HTTP: POST
существует только один URL конечной точки: https://cults3d.com/graphql
вы передаете строку запроса, которая представляет данные, которые вы хотели бы получить в формате GraphQL
вы получаете обратно JSON, соответствующий каждому полю каждого типа, который вы запрашивали
API не даст вам доступ к 3D-файлам (они останутся размещенными на Cults по юридическим причинам), но даст вам доступ ко всему остальному: фотографиям, названиям, описаниям, тегам и т.д.

Авторизация

Все вызовы осуществляются с использованием HTTP Basic Auth с предоставленными вам учетными данными.

Попробуйте

Используйте графический проводник для просмотра и тестирования API. Документация справа покажет вам все доступные данные, которые вы можете запросить.

Пример вызова

Вот пример вызова командной строки с использованием curl:

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

Полученные данные JSON имеют тот же формат, что и запрос:

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