Verwenden Sie GET /api/v2/catalog mit catalog.read. Es nutzt Cathopics vorhandene fehlertolerante Fuzzy-Suchschicht und lädt dieselben kanonischen Medienmodelle, die auch im Website-Grid verwendet werden.
Parameter
qoderquery: Text bis zu 250 Zeichen.type: photo, video, graphic, artwork, ai oder all.orientation: landscape, portrait, square oder all.sort: most_recent, popular oder popular_alltime.page,per_page: bis zu 50 undlocale.
GET /api/v2/catalog?q=adoration&type=photo&orientation=landscape&per_page=30
Authorization: Bearer ACCESS_TOKENVorschau-URLs unverändert verwenden
Jedes Ergebnis enthält preview.url und preview.transformation_url_template. Sie stammen aus exakt demselben Grid-Presenter, CDN-Host, Speicherpfad und denselben Watermark-Regeln, die auf cathopic.com verwendet werden. Verwenden Sie sie unverändert, damit Integrationen die vorhandenen Cloudflare-Cache-Keys wiederverwenden.
Laden Sie keine weitere Kopie hoch oder proxyn Sie sie nicht unnötig.
Fügen Sie keine cache-busting Query-Parameter hinzu.
Ersetzen Sie
<OPTIONS>nur durch stabile Cloudflare-Bildoptionen.
Vorschauen verbrauchen niemals einen Download. already_licensed umfasst individuelle und Entitlements für gemeinsam genutzte Teams.
