¿Qué es GraphQL?
GraphQL es una API de JSON que le permite decidir qué campos desea recuperar.
Nótese que:
- sólo hay un URL :
http://cults3d.com/graphql - sólo hay HTTP
POST - se pasa una cadena de consulta que representa los datos que se desea recibir en el formato GraphQL
- obtendrá un JSON que coincide con cada uno de los campos de cada tipo que haya solicitado
- la API no le dará acceso a los archivos 3D (seguirán alojados en Cults por razones legales), pero le dará acceso a todo lo demás: fotos, títulos, descripciones, etiquetas, etc.
Autorización
Todas las llamadas se realizan utilizando HTTP Basic Auth con las credenciales que se le han dado.
Pruébalo
Utilice el explorador gráfico para explorar y probar la API. La documentación de la derecha muestra todos los datos disponibles que puede consultar.
Ejemplo de llamada
Aquí hay un ejemplo de una llamada a la línea de comandos usando curl:
curl https://cults3d.com/graphql -u your_username:your_password -d'query={
creations(limit: 1) {
name
url
creator {
nick
}
}
}'
Los datos JSON que salen tienen el mismo formato que la consulta:
{
"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"
}
}
]
}
}
