Come cercare nel catalogo e usare gli URL di anteprima di Cathopic

Ultimo aggiornamento: 3 mesi fa

Usa GET /api/v2/catalog con catalog.read. Usa lo strato di ricerca fuzzy tollerante agli errori di battitura già esistente di Cathopic e carica gli stessi modelli canonici di contenuti multimediali usati dalla griglia del sito web.

Parametri

  • q oppure query: testo fino a 250 caratteri.

  • type: foto, video, grafica, opera d’arte, ai, oppure tutti.

  • orientation: orizzontale, verticale, quadrata, oppure tutti.

  • sort: più_recente, popolare, oppure popolare_tutto_il_tempo.

  • page, per_page fino a 50 e locale.

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

Usa gli URL di anteprima invariati

Ogni risultato include preview.url e preview.transformation_url_template. Provengono esattamente dallo stesso presenter della griglia, dall’host CDN, dal percorso di storage e dalle regole di watermark usate su cathopic.com. Usali invariati così le integrazioni riutilizzano le chiavi di cache esistenti di Cloudflare.

  • Non caricare un’altra copia o farne da proxy inutilmente.

  • Non aggiungere parametri di query per forzare la cache.

  • Sostituisci <OPTIONS> solo con opzioni immagine Cloudflare stabili.

Le anteprime non consumano mai un download. already_licensed include le autorizzazioni individuali e del team condiviso.

Questo articolo è stato utile?