Użyj GET /api/v2/catalog wraz z catalog.read. Wykorzystuje istniejącą w Cathopic warstwę wyszukiwania rozmytego tolerującą literówki i wypełnia te same kanoniczne modele multimediów używane w siatce na stronie internetowej.
Parametry
qlubquery: tekst do 250 znaków.type: photo, video, graphic, artwork, ai lub all.orientation: landscape, portrait, square lub all.sort: most_recent, popular lub popular_alltime.page,per_page: do 50 orazlocale.
GET /api/v2/catalog?q=adoration&type=photo&orientation=landscape&per_page=30
Authorization: Bearer ACCESS_TOKENUżywaj podglądowych adresów URL bez zmian
Każdy wynik zawiera preview.url oraz preview.transformation_url_template. Pochodzą one z dokładnie tego samego prezentera siatki, hosta CDN, ścieżki w pamięci masowej oraz reguł znakowania wodnego używanych na cathopic.com. Używaj ich bez zmian, aby integracje ponownie wykorzystywały istniejące klucze cache Cloudflare.
Nie przesyłaj kolejnej kopii ani nie udostępniaj jej niepotrzebnie jako proxy.
Nie dodawaj parametrów zapobiegających cache’owaniu (cache-busting).
Zamień
<OPTIONS>wyłącznie na stabilne opcje obrazów Cloudflare.
Podglądy nigdy nie zużywają pobrania. already_licensed obejmuje uprawnienia dla pojedynczych użytkowników oraz dla zespołów współdzielonych.
