Comment rechercher dans le catalogue et utiliser les URL d’aperçu Cathopic

Dernière mise à jour: il y a 3 mois

Utilisez GET /api/v2/catalog avec catalog.read. Il utilise la couche de recherche floue tolérante aux fautes de frappe existante de Cathopic et charge les mêmes modèles médiatiques canoniques utilisés par la grille du site web.

Paramètres

  • q ou query: texte jusqu’à 250 caractères.

  • type: photo, vidéo, graphique, œuvre, ai, ou tout.

  • orientation: paysage, portrait, carré, ou tout.

  • sort: most_recent, popular, ou popular_alltime.

  • page, per_page : jusqu’à 50, et locale.

GET /api/v2/catalog?q=adoration&type=photo&orientation=landscape&per_page=30
Authorization: Bearer ACCESS_TOKEN

Utilisez les URL d’aperçu inchangées

Chaque résultat inclut preview.url et preview.transformation_url_template. Ils proviennent exactement du même présentateur de grille, de l’hôte CDN, du chemin de stockage et des règles de filigrane utilisés sur cathopic.com. Utilisez-les inchangés afin que les intégrations réutilisent les clés de cache existantes de Cloudflare.

  • Ne téléversez pas une autre copie et ne le mettez pas en proxy inutilement.

  • N’ajoutez pas de paramètres de requête destinés à contourner le cache.

  • Remplacez <OPTIONS> uniquement par des options d’image Cloudflare stables.

Les aperçus ne consomment jamais un téléchargement. already_licensed inclut les droits individuels et ceux de l’équipe partagée.

Cet article vous a-t-il été utile ?