Hoe doorzoek je de catalogus en gebruik je Cathopic preview-URL’s

Laatst bijgewerkt: 3 maanden geleden

Gebruik GET /api/v2/catalog met catalog.read. Het gebruikt Cathopics bestaande fuzzy-zoeklaag die tolerant is voor typefouten en vult dezelfde canonieke mediaproductmodellen aan die ook door de website-grid worden gebruikt.

Parameters

  • q of query: tekst tot 250 tekens.

  • type: foto, video, grafiek, artwork, ai, of alles.

  • orientation: landscape, portrait, vierkant, of alles.

  • sort: most_recent, popular, of popular_alltime.

  • page, per_page tot 50, en locale.

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

Gebruik preview-URL’s ongewijzigd

Elke resultaat bevat preview.url en preview.transformation_url_template. Ze komen uit dezelfde grid-presenter, CDN-host, opslagpad en watermerkregels die op cathopic.com worden gebruikt. Gebruik ze ongewijzigd zodat integraties de bestaande Cloudflare-cache-sleutels opnieuw kunnen gebruiken.

  • Upload geen andere kopie of proxy het onnodig.

  • Voeg geen cache-busting queryparameters toe.

  • Vervang <OPTIONS> alleen door stabiele Cloudflare-afbeeldingsopties.

Previews verbruiken nooit een download. already_licensed omvat individuele en gedeelde entitlements voor teams.

Was dit artikel nuttig?