Référence

Matériaux d’édition

GET /v1/edit-materials renvoie, page par page et dans l’ordre du catalogue, les matériaux et textures utilisables dans une édition par masque. La liste peut se filtrer par catégorie (bois, pierre, peinture…) ou par nom. Passez l’id d’un matériau dans le champ material d’un calque modify d’une édition.

curl "https://api.renderthink.com/v1/edit-materials?category=wood&lang=fr&limit=20" \
  -H "Authorization: Bearer $RENDERTHINK_API_KEY"

Paramètres

Paramètres de l’URL :

Nom	Type	Description
`category`	chaîne	`id` d’une catégorie (voir « Catégories » ci-dessous) : seuls les matériaux de cette catégorie et de ses sous-catégories sont renvoyés.
`search`	chaîne	Texte cherché dans le nom des matériaux, toutes langues confondues, sans tenir compte des accents. 100 caractères au plus.
`limit`	entier	Nombre d’objets par page, de 1 à 100. Par défaut : 20.
`after`	chaîne	`id` du dernier objet de la page précédente (voir Pagination).
`lang`	chaîne	Langue des noms : `fr` ou `en`. Par défaut : `en`.

category et search peuvent se combiner. Droit de la clé : edits.

Réponse

Une liste d’objets edit_material :

json
{
  "object": "list",
  "data": [
    {
      "object": "edit_material",
      "id": "mat_4Zq8nV2bXk7pLr9TcW3yHd",
      "name": "Chêne clair",
      "image_url": "https://cdn.renderthink.com/...",
      "thumbnail_url": "https://cdn.renderthink.com/...",
      "category": "wood"
    }
  ],
  "has_more": true
}

Champ	Type	Description
`object`	chaîne	Toujours `edit_material`.
`id`	chaîne	Identifiant du matériau (`mat_…`), à passer dans le champ `material` d’un calque.
`name`	chaîne	Nom dans la langue demandée, ou dans la langue d’origine du catalogue s’il n’est pas traduit.
`image_url`	chaîne	URL publique de l’image du matériau.
`thumbnail_url`	chaîne ou `null`	URL publique d’une vignette, à afficher dans une liste de choix ; `null` si le matériau n’en a pas.
`category`	chaîne ou `null`	`id` de sa catégorie (voir « Catégories »), ou `null` s’il n’en a pas.

Catégories

GET /v1/edit-material-categories renvoie les grandes catégories de matériaux (bois, pierre, peinture…) qui contiennent au moins un matériau, sous-catégories comprises, dans l’ordre du catalogue et en une seule page. Leur id est stable : c’est la valeur du filtre category.

curl "https://api.renderthink.com/v1/edit-material-categories?lang=fr" \
  -H "Authorization: Bearer $RENDERTHINK_API_KEY"

Paramètre de l’URL : lang, la langue des noms, fr ou en (par défaut : en). Droit de la clé : edits.

json
{
  "object": "list",
  "data": [
    { "object": "edit_material_category", "id": "wood", "name": "Bois" },
    { "object": "edit_material_category", "id": "stone", "name": "Pierre" }
  ],
  "has_more": false
}

Champ	Type	Description
`object`	chaîne	Toujours `edit_material_category`.
`id`	chaîne	Identifiant stable (`wood`, `stone`…).
`name`	chaîne	Nom dans la langue demandée.

Erreurs

Statut	Code	Cause
400	`parameter_invalid`	`limit` hors de 1 à 100, `after` mal formé ou inconnu, `category` qui n’est pas l’`id` d’une catégorie, `search` de plus de 100 caractères, ou `lang` autre que `fr` ou `en`.

Les erreurs communes à toutes les routes (clé, droits, limites) sont dans Erreurs.