Question 1

Ano ang Cathopic API?

Accepted Answer

Ang aming API ay isang RESTful na serbisyo na nagbibigay-daan sa iyong isama nang direkta ang Catholic media library ng Cathopic sa iyong mga application. Ma-access ang libu-libong larawan, video, at graphics nang programmatically. Ano ang magagawa mo Maghanap at mag-browse sa pamamagitan ng aming kumpletong katalogo Maglisensya ng mga resources para sa iyong mga end-user nang awtomatiko Mag-download sa maraming format na na-optimize para sa iba’t ibang paggamit Mag-access ng mayamang metadata kabilang ang mga tag, paglalarawan, at liturgical na impormasyon Arkitekturang REST Binuo sa mga karaniwang prinsipyo ng REST: Base URL: https://api.cathopic.com Format ng data: Mga kahilingang JSON at mga tugon Pagpapatunay: API key sa pamamagitan ng x-api-key header HTTP method: POST para sa lahat ng endpoints Apat na pangunahing endpoints POST /resources - Maghanap sa katalogo POST /resource - Kumuha ng mga detalye tungkol sa isang partikular na item POST /confirm - Maglisensya ng isang resource at kumuha ng mga download URL POST /remove - Itigil ang paglilisensya kapag hindi na kailangan (website lang) Kumpletong dokumentasyon Ang lahat ng kailangan mo ay available online: Interactive na API reference: api.cathopic.com/docs Mga halimbawa ng code sa maraming wika Masusing detalye ng mga parameter Pagsisimula Makipag-ugnayan sa aming team para humiling ng access sa API Bumuo ng iyong API key sa Settings → API Magdagdag ng paraan ng pagbabayad para sa pagsingil sa paggamit Simulan ang pagbuo Tingnan ang iba pang mga tanong sa seksyong ito para sa mga detalye tungkol sa pagpapatunay, pagsingil, at pinakamahuhusay na kasanayan. Kasunduan sa Lisensya ng API Ang lahat ng paggamit ng API ay napapailalim sa aming Kasunduan sa Lisensya ng API. Mga pangunahing punto na dapat maunawaan: Digital use lamang: Ang nilalaman ay maaari lamang ipakita sa mga web at email na kapaligiran Walang pagda-download ng file: Ang mga end user ay hindi maaaring mag-download o mag-export ng mga orihinal na file Mga ipinagbabawal na paggamit: Mahigpit na ipinagbabawal ang AI/ML training, mga naka-print na materyales, at offline na paggamit Pagsingil batay sa paggamit: Magbabayad lamang para sa aktwal na paggamit ng nilalaman ng iyong mga end user Sa pamamagitan ng paggamit ng API, tinatanggap mo ang lahat ng mga tuntunin sa kasunduan sa lisensya Bago isama ang API: Suriin ang kumpletong Kasunduan sa Lisensya ng API Unawain ang mga paghihigpit at obligasyon Tiyaking ang iyong sitwasyon ng paggamit ay sumusunod sa mga kinakailangan na digital-only Planuhin ang iyong pagsasama upang tumpak na masubaybayan ang paggamit para sa pagsingil Para sa higit pang detalye, tingnan: Ano ang maaari kong buuin gamit ang API? (kabilang ang mga detalyadong paghihigpit) Paano gumagana ang mga lisensya sa pamamagitan ng API? (kumpletong detalye ng paglilisensya) Paano sinisingil ang paggamit ng API? (paliwanag ng modelo ng pagsingil)

Question 2

Ano ang maaari kong itayo gamit ang API?

Accepted Answer

Ang Cathopic API ay nagbibigay-daan sa iyong isama ang mga katangi-tanging biswal na Katoliko nang direkta sa iyong application, website, o platform. Gayunman, mahigpit na pinamamahalaan ang paggamit ng API ng aming Kasunduan sa Lisensya ng API, na naglilimita sa paggamit sa mga partikular na digital na kapaligiran. Ano ang maaari mong itayo Mga sistema para sa pamamahala ng simbahan at parokya Payagan ang mga parokya na magdagdag ng mga larawang Katoliko sa kanilang mga bulletin at newsletter Paganahin ang promosyon ng mga kaganapan gamit ang kaugnay na biswal na nilalaman Magbigay ng mga larawang liturhikal na tumutugma sa kalendaryo ng simbahan Gumawa ng mga digital na display para sa mga anunsyo ng parokya Mga platform ng nilalamang Katoliko Bumuo ng mga blogging platform para sa mga manunulat na Katoliko na may kasamang imagery Gumawa ng mga website ng balitang Katoliko na may kaugnay na mga biswal Mag-develop ng mga devotional app na may mga pang-araw-araw na larawan at panalangin Disenyo ng mga catechetical platform na may mga pantulong sa pagtuturo na may biswal Mga tool sa email marketing Payagan ang mga ministry na gumawa ng mga newsletter na may imagery na Katoliko Paganahin ang mga organisasyong panrelihiyon na magdisenyo ng mga email campaign Magbigay ng mga template na may integrated na nilalamang Cathopic Suportahan ang mga fundraising campaign gamit ang angkop na mga biswal Mga website builder at CMS Isama ang mga larawang Katoliko sa mga platform ng paggawa ng website Magbigay ng mga content module para sa mga organisasyong Katoliko Paganahin ang pagpili ng larawan na drag-and-drop mula sa Cathopic Gumawa ng mga template na partikular para sa mga ministry ng Katoliko Pamahalaan ng mga kaganapan at social media Tulungan ang mga ministry na gumawa ng mga social media graphic (nang hindi nagda-download ng mga file) Disenyo ng mga sistema ng imbitasyon sa kaganapan na may imagery na Katoliko Bumuo ng mga content calendar na may mga biswal para sa liturgical season Paganahin ang mga organisasyon na mag-iskedyul ng mga post na may angkop na mga larawan Mga mahahalagang paghihigpit na dapat mong sundin Ang Lisensya ng API mahigpit na ipinagbabawal ang ilang paggamit. Ang paglabag sa mga paghihigpit na ito ay maaaring magresulta sa agarang pagwawakas: ❌ Pagsasanay ng AI/ML (MAHIGPIT NA IPINAGBABAWAL HABANGBUHAY) Hindi maaaring gamitin upang magsanay, mag-fine-tune, o magpakain ng anumang AI/ML models Hindi maaaring gumawa ng embeddings, datasets, o mga derivative extract para sa AI Ang paghihigpit na ito ay mananatili nang walang hanggan, kahit matapos ang pagwawakas ng kasunduan Nalalapat sa lahat ng uri ng machine learning at artificial intelligence ❌ Pagda-download ng file at pag-e-export Hindi maaaring i-download o i-save ng mga end user ang nilalaman bilang mga file Hindi maaaring magbigay ng functionality na "download" o "export" Dapat manatiling naka-host ang nilalaman sa Cathopic o sa awtorisadong cache Tanging mga web-optimized na URL ang maaaring gamitin, hindi ang mga orihinal na file ❌ Pagpi-print at paggamit nang offline Hindi maaaring gamitin sa mga materyal na pang-print, brochure, o poster Walang offline na advertising o mga produktong pisikal Mahigpit na limitado sa mga digital na web at email na kapaligiran Hindi maaaring isama sa mga PDF na nilalayong ipi-print ❌ Muling pagbebenta at muling pamamahagi Hindi maaaring gumawa ng mga produktong muling nagbebenta o muling namamahagi ng nilalamang Cathopic Hindi maaaring bumuo ng stock photo marketplaces gamit ang aming API Hindi maaaring ialok ang nilalaman bilang standalone na produkto Dapat itong isama bilang bahagi ng mas malaking serbisyo ❌ Pagbabago at mga derivative Hindi maaaring baguhin, i-transform, o gumawa ng mga derivative works Hindi maaaring mag-apply ng mga filter o makabuluhang pagbabago Dapat ipakita ang nilalaman nang gaya ng ibinigay ng API Pinapayagan ang pangunahing cropping at resizing para sa layunin ng layout Tanging mga web at email na kapaligiran Ang nilalamang naa-access sa pamamagitan ng API ay maaaring lamang gamitin sa: Mga website: Mga pampubliko o pribadong web page Mga web application: Mga tool at platform na nakabatay sa browser Email: Mga newsletter, campaign, at transactional emails Mga blog: Mga online content management system Mga web embed: Kontroladong iframe o content na inihahatid sa pamamagitan ng API Mahalaga: Dapat ipakita ang nilalaman sa web-optimized na resolution lamang. Ang mga orihinal na high-resolution na file ay hindi kailanman naa-access sa pamamagitan ng API. Mga teknikal na kinakailangan Dapat ang iyong application ay: Gumamit ng HTTPS: Lahat ng API calls at paghahatid ng nilalaman ay dapat na ligtas Ipatupad ang paghawak ng watermark: Magsimula sa nilalamang may watermark, at humiling lamang ng walang watermark kapag kinakailangan Subaybayan nang tumpak ang paggamit: I-log ang lahat ng paggamit ng nilalaman para sa layunin ng billing Tawagan ang endpoint na /confirm: Kapag nagpasya ang end user na gamitin ang nilalaman Tawagan ang endpoint na /remove: Kapag ang nilalaman ay hindi na ginagamit (humihinto ang billing) Pigilan ang hindi awtorisadong pag-access: Protektahan ang iyong mga API credential Igalang ang rate limits: Sundin ang mga limitasyong itinakda para sa iyong account Ang iyong mga legal na obligasyon Kapag isinama mo ang API, dapat mong: I-update ang iyong Terms of Use upang ipaalam sa mga end user: Hindi maaaring i-download o gamitin ang nilalaman sa labas ng iyong application Hindi maaaring gamitin ang nilalaman para sa mga layuning AI/ML Ang nilalaman ay pag-aari ng Cathopic at ng mga tagalikha nito Ang paggamit ay sinusubaybayan para sa billing at pagsunod (compliance) Ipatupad ang mga teknikal na kontrol upang maiwasan ang: Mga pagda-download sa pamamagitan ng right-click (kung magagawa) Direktang pag-access sa orihinal na mga file sa pamamagitan ng URL Mga browser extension na nagpapahintulot ng pagda-download Panatilihin ang mga log ng paggamit para sa: Pag-verify ng billing Mga audit sa pagsunod (compliance) Pagresolba ng hindi pagkakaunawaan Mga halimbawa ng mga pagsasamang sumusunod sa patakaran ✅ Tagabuo ng bulletin ng parokya Gumagawa ang mga parokya ng mga digital na bulletin na may mga larawang Katoliko Naiipakita ang nilalaman sa website at sa mga newsletter sa email Walang ibinibigay na functionality para sa pagda-download Sinusubaybayan ng billing ang paggamit kada parokya at kada larawan ✅ Platform ng email ng ministry Dinisenyo ng mga organisasyong panrelihiyon ang mga email campaign Ang mga larawan ay inihahatid nang direkta sa mga email sa pamamagitan ng mga API URL Sisingilin batay sa bawat email na ipinadala na may kasamang nilalaman Walang pag-iimbak ng file sa mga device ng end user ✅ Platform ng Catholic CMS Website builder na may integrated na Cathopic library Maaaring mag-browse at pumili ang mga user ng mga larawan para sa kanilang mga pahina Nai-embed ang nilalaman sa pamamagitan ng mga URL na inihahatid sa pamamagitan ng API Sisingilin batay sa araw ng paggamit kada user Mga halimbawa ng mga pagsasamang ipinagbabawal ❌ AI-powered image generator Paggamit ng nilalamang Cathopic upang magsanay ng mga AI model Paglikha ng mga dataset para sa machine learning Pagbuo ng mga larawang kahawig batay sa aming nilalaman ❌ Tool sa disenyo para sa pagpi-print Pagpapahintulot sa mga user na gumawa ng mga printable poster Pagbibigay ng pagda-download para sa high-res printing Paglikha ng mga PDF na may nilalamang Cathopic para sa pagpi-print ❌ Stock photo marketplace Muling pagbebenta ng nilalamang Cathopic bilang standalone na mga produkto Paglikha ng mga derivative stock photo collection Muling pamamahagi ng nilalaman sa maraming kliyente Bago ka magsimulang magtayo Mahahalagang babasahin: Basahin ang kumpletong Kasunduan sa Lisensya ng API Aralin ang teknikal na dokumentasyon sa api.cathopic.com/docs Unawain nang detalyado ang billing model (tingnan ang Paano sinisingil ang paggamit ng API?) Planuhin ang iyong integration upang sumunod sa lahat ng paghihigpit Makipag-ugnayan sa amin sa pamamagitan ng support kung mayroon kang mga katanungan Tandaan: Sa pamamagitan ng pag-access o paggamit ng API, tinatanggap mo ang lahat ng mga tuntunin sa Kasunduan sa Lisensya ng API. Ang hindi pagsunod ay maaaring magresulta sa agarang pagwawakas at mga legal na kahihinatnan.

Question 3

Ano ang mga rate limit?

Accepted Answer

Sa kasalukuyan, hindi namin ipinapatupad ang mahigpit na mga limitasyon na requests kada segundo. Gayunman, inaasahan ang patas na paggamit upang mapanatili ang kalidad ng serbisyo para sa lahat. Kasalukuyang pamamaraan Sa halip na matitigas na limitasyon, hinihikayat namin ang responsableng paggamit: I-space nang makatwiran ang iyong mga request Magpatupad ng exponential backoff kapag may mga error I-cache ang mga tugon upang maiwasan ang paulit-ulit na tawag Makipag-ugnayan sa amin kung inaasahan mong mataas ang volume ng trapiko Mga pinakamahuhusay na gawain I-cache nang masinsinan: I-save ang mga resulta ng paghahanap para sa mga karaniwang query I-keep nang lokal ang media metadata pagkatapos ma-retrieve Huwag tumawag /confirm ng maraming beses para sa parehong user/resource I-batch ang iyong mga operasyon: Pangkatin ang mga kaugnay na request Magdagdag ng maliliit na pagkaantala sa pagitan ng mga batch Limitahan ang sabayang koneksyon (10-20 ay makatwiran) Mahusay na pangasiwaan ang mga error: Magpatupad ng retry logic na may exponential backoff Huwag agad mag-retry kapag nabigo I-log ang mga error para sa pagsubaybay Mga inaasahang oras ng tugon /resources search: Karaniwang 200-500ms /resource details: Mas mababa sa 100ms /confirm licensing: 300-800ms Itakda ang timeout ng iyong client sa hindi bababa sa 30 segundo upang mahawakan ang paminsan-minsang mas mabagal na tugon. Kung maaabot mo ang mga limitasyon Makakatanggap ka ng 429 Too Many Requests na error. Kapag nangyari ito: // Implement exponential backoff async function fetchWithRetry(url, options, maxRetries = 3) { for (let i = 0; i < maxRetries; i++) { try { const response = await fetch(url, options); if (response.status === 429) { const waitTime = Math.pow(2, i) * 1000; // 1s, 2s, 4s await new Promise(resolve => setTimeout(resolve, waitTime)); continue; } return response; } catch (error) { if (i === maxRetries - 1) throw error; } } } Subaybayan ang iyong paggamit I-track ang aktibidad ng API sa Settings → API: Tingnan ang kabuuang bilang ng mga request na ginawa Suriin ang mga aktibong lisensya I-review ang mga trend ng paggamit Mag-monitor para sa mga hindi pangkaraniwang pattern Kailangan mo ba ng mas mataas na limitasyon? Kung ang iyong lehitimong sitwasyon ng paggamit ay nangangailangan ng mataas na volume ng request (>1M requests/month), makipag-ugnayan sa aming team upang pag-usapan: Ang iyong application at mga pattern ng trapiko Inaasahang volume ng request Mga garantisadong rate limit kung kinakailangan

Question 4

Paano sinisingil ang paggamit ng API?

Accepted Answer

Ang Cathopic API ay gumagamit ng pay-as-you-go na modelo ng pagsingil batay sa aktuwal na paggamit ng nilalaman ng iyong mga end user. Ang lahat ng tuntunin sa pagsingil ay pinamamahalaan ng aming API License Agreement. Dalawang modelo ng pagsingil Nakasalalay ang pagsingil sa kung paano ginagamit ng iyong mga end user ang nilalaman: 1. Paggamit sa Website (Days of Use model) Nalalapat kapag ipinapakita ang nilalaman sa mga website, blog, o web application Kinakalkula kada kalendaryong araw na naa-access ng isang end user ang partikular na nilalaman Pormula: Kabuuang Days of Use × (Napagkasunduang buwanang rate ÷ 30) Ang prorated na pang-araw-araw na pagsingil ay nagsisiguro na babayaran mo lang ang aktuwal na paggamit Sinusubaybayan nang hiwalay para sa bawat end user at para sa bawat item ng nilalaman 2. Paggamit sa Email (Per Email model) Nalalapat kapag ang nilalaman ay isinama sa mga mensahe ng email Sinisingil kada mensahe ng email na ipinapadala (hindi kada tatanggap) Isang beses na pagsingil kada email na kasama ang nilalaman Rate na napagkasunduan sa panahon ng pag-set up ng API access Paano nagsisimula at humihinto ang pagsingil Libre ang watermarked na nilalaman Ang nilalaman ay unang lumilitaw na may watermark Ang watermarked na preview ay hindi nagbubunga ng mga singil Mainam para hayaan ang mga end user na mag-browse muna bago magdesisyon Maaaring gamitin para sa testing at trial Nagsisimula ang pagsingil kapag inalis ang watermark Nagpapasya ang end user na gamitin ang nilalaman nang walang watermark Ang iyong application ay tumatawag ng POST /confirm na may: media_id: Ang identifier ng nilalaman usage_type: Alinman sa "website" o "email" client_identifier: Natatanging ID ng iyong end user Ibinabalik ng API ang mga permanenteng URL para sa nilalamang walang watermark Nagsisimula agad ang pagsingil mula sa sandaling ito Dapat mong i-store ang mga URL na ito at data ng paggamit para sa pagsubaybay sa pagsingil Humihinto ang pagsingil kapag inalis ang nilalaman Inaalis o ititigil ng end user ang paggamit ng nilalaman Ang iyong application ay tumatawag ng POST /remove na may: media_id: Ang identifier ng nilalaman client_identifier: ID ng end user Humihinto ang pagsingil para sa partikular na paggamit na iyon Dapat mong tanggalin ang mga URL na walang watermark mula sa iyong database Halimbawa ng pagsingil sa Website Sabihin nating napagkasunduan mo ang isang buwanang rate ng para sa walang limitasyong paggamit ng nilalaman: Sitwasyon: Ipinapakita ng Parish A ang Image #12345 sa kanilang homepage Araw 1: Tatawag ka ng /confirm → Nagsisimula ang pagsingil Mga Araw 1-15: Mananatili ang image sa homepage (15 araw ng paggamit) Araw 16: Inaalis ng Parish ang image, tatawag ka ng /remove → Humihinto ang pagsingil Pagkalkula: 15 araw × ( ÷ 30 araw) = Sisingilin: para sa partikular na paggamit na ito Kung ginagamit din ng Parish B ang parehong image sa loob ng 10 araw, hiwalay itong sinusubaybayan at magdadagdag pa. Halimbawa ng pagsingil sa Email Sabihin nating napagkasunduan mo ang isang rate na --.05 kada email: Sitwasyon: Nagpapadala ang Ministry ng newsletter na may Image #67890 Gawain: Tatawag ka ng /confirm na may usage_type: "email" Resulta: Isang beses na singil na --.05 para sa email na iyon Mga tatanggap: Hindi mahalaga kung ipinadala sa 100 o 10,000 katao Sisingilin: --.05 kabuuan (hindi kada tatanggap) Mga buwanang cap sa pagsingil Maaaring kasama sa kasunduan mo ang mga buwanang cap sa pagsingil: Pinoprotektahan ka laban sa hindi inaasahang mataas na singil Kapag naabot na ang cap, maaaring libre na ang karagdagang paggamit o sa nabawasang rate Ang eksaktong halaga ng cap ay napagkasunduan sa panahon ng pag-set up ng API access Nalalapat sa kabuuang singil kada buwan sa lahat ng end user Invoicing at pagbabayad Iskedyul ng invoice Ang mga invoice ay inilalabas buwan-buwan sa loob ng unang 10 araw ng bawat buwan Sinasaklaw nito ang lahat ng paggamit mula sa nakaraang buwan Detalyadong breakdown ng paggamit ayon sa end user at item ng nilalaman Ipinapadala sa email address na naka-link sa iyong API account Proseso ng pagbabayad Ang mga pagbabayad ay pinoproseso nang eksklusibo sa pamamagitan ng Stripe Awtomatikong singil sa iyong nakarehistrong paraan ng pagbabayad Dapat mong panatilihing wasto ang impormasyon sa pagbabayad sa lahat ng oras Ang mga resibo ay awtomatikong ibinibigay pagkatapos ng matagumpay na pagbabayad Mga pagkabigo sa pagbabayad Kung mabigo ang pagbabayad, ang system ay gagawa ng 4 na pagtatangka muli Makakatanggap ka ng mga abiso sa email tungkol sa mga isyu sa pagbabayad Kung mabigo ang lahat ng retry, isususpinde ang API access Iibabalik ang access kaagad kapag matagumpay na ang pagbabayad Ang mga hindi nabayarang invoice ay maaaring magkaroon ng mga singil sa interes Mga responsibilidad mo sa pagsubaybay Dapat mong panatilihin ang tumpak na mga tala ng: Mga usage log: Kailan na-confirm at na-remove ang nilalaman Mga ID ng end user: Aling mga user ang naka-access sa aling nilalaman Mga Content ID: Aling mga media item ang ginamit Mga uri ng paggamit: Website vs email para sa bawat paggamit Mga petsa: Mga petsa ng simula at pagtatapos para sa paggamit sa website Mga URL: Mga naka-store na watermark-free URL para sa aktibong paggamit Mahahalaga ang mga log na ito para sa: Pagpapatunay ng mga buwanang invoice Pagresolba ng mga hindi pagkakaunawaan sa pagsingil Mga compliance audit ng Cathopic Ang sarili mong internal reporting Pag-access sa mga usage report Maaari mong subaybayan ang paggamit ng iyong API sa real-time: Pumunta sa Settings → API Tingnan ang seksyong "On-demand usage" Tingnan ang kasalukuyang mga istatistika ng billing period: Kabuuang halaga na naipon hanggang ngayon Bilang ng mga website uses Bilang ng mga email uses I-click ang "View detailed report" para sa breakdown ayon sa: End user (client identifier) Item ng nilalaman Uri ng paggamit Saklaw ng petsa Mga indibidwal na gastos I-export ang mga report bilang CSV para sa iyong mga tala Pag-uusap sa mga rate Ang pagpepresyo ng API ay iniangkop para sa bawat kliyente: Ang mga rate ay napagkasunduan sa panahon ng proseso ng paghingi ng API access Batay sa inaasahang dami ng iyong paggamit Batay sa iyong partikular na sitwasyon ng paggamit at uri ng integration Maaaring may kasamang volume discounts para sa mga application na mataas ang paggamit Maaaring pag-usapan ang mga billing cap para makapagbigay ng mas predictable na gastos Para pag-usapan ang pagpepresyo: Bisitahin ang aming pahina ng suporta Piliin ang "API access request" Ilarawan ang iyong integration at inaasahang paggamit Magbibigay ang aming team ng customized na quote Pag-unawa sa buong lisensya Ang pagsingil ay isa lamang sa aspeto ng kasunduan sa API. Suriin ang kumpletong mga tuntunin: Basahin ang buong API License Agreement Unawain ang mga paghihigpit sa paggamit (digital lamang, walang AI/ML, walang downloads) Alamin ang iyong mga obligasyon para sa pag-track at pag-uulat Suriin ang mga tuntunin tungkol sa intellectual property at pagwawakas Para sa mga teknikal na detalye sa implementasyon: Tingnan ang /confirm at /remove na mga endpoint sa api.cathopic.com/docs Unawain kung paano kalkulahin ang paggamit para sa iyong partikular na integration Suriin ang mga best practice para sa tumpak na pagsubaybay sa pagsingil Tandaan: Ang tumpak na pagsubaybay sa paggamit ay responsibilidad mo. Panatilihin ang detalyadong mga log upang matiyak ang tamang pagsingil at pagsunod sa kasunduan sa lisensya.

Question 5

Paano humiling ng developer access para sa API at OAuth

Accepted Answer

Sinusuri ng Cathopic ang isang developer account nang isang beses lamang. Ang iisang pag-apruba na iyon ay nagbubukas ng parehong commercial API at pamamahala ng OAuth application; hindi ka nagsusumite ng hiwalay na mga kahilingan. Pagkatapos maaprubahan, gagawa at pamamahalaan mo ang iyong mga API key at OAuth credentials mula sa Cathopic Settings. Hindi kailanman kailangan ng mga developer ng command ng Cathopic server o access sa imprastraktura. 1. Ihanda ang iyong Cathopic account Gumawa ng Cathopic account, i-verify ang email address nito, at tiyaking eksaktong tumutugma ang username at email sa kahilingan sa account na iyon. 2. Ipadala ang developer request Buksan ang Cathopic contact form. Piliin Request developer access. Kumpirmahin ang Cathopic username at ilarawan ang produkto, organisasyon, at nilalayong paggamit ng catalog. Ipadala ang form. Ang kahilingan ay lumalabas sa internal review dashboard ng Cathopic. 3. Tanggapin ang desisyon Sinusuri ng Cathopic ang account at use case. Kapag naaprubahan, ang developer ay makakatanggap ng email na may mga susunod na hakbang at isang link sa Settings → Developer / API → OAuth applications. Kung kailangan ng karagdagang impormasyon, kinokontak ng Cathopic ang email mula sa kahilingan. 4. Gawin ang application Piliin ang isang confidential web application kapag ang produkto ay may secure na backend, o isang public PKCE application para sa browser-only, mobile, o desktop clients. Ilagay ang pampublikong pangalan nito, paglalarawan, website, privacy policy, security contact, eksaktong callback URLs, at ang mga scope lamang na kailangan nito. 5. I-store ang credentials Tinutukoy ng client ID ang integration at ibinabahagi ito sa lahat ng user ng produktong iyon. Mananatiling hiwalay ang user authorization at tokens para sa bawat Cathopic account. Ang confidential client secret ay ipinapakita nang isang beses lamang at dapat itong i-encrypt sa server ng application. Huwag itong isama sa browser code, mga generated website, logs, support messages, o isang pampublikong repository. Ang parehong pahina ay nagbibigay-daan sa naaprubahang developer na i-edit ang callbacks at scopes, i-rotate ang confidential secret, o i-revoke ang application.

Question 6

Paano gumagana ang mga API key?

Accepted Answer

Ang mga API key ay ang iyong mga kredensyal sa pagpapatunay (authentication) para ma-access ang Cathopic API. Ang pag-unawa kung paano ito gumagana ay mahalaga para sa ligtas at epektibong pagsasama (API integration). Ano ang API key? Ang API key ay isang natatanging lihim na token na tumutukoy sa iyong application at nagbibigay ng pahintulot para ma-access ang Cathopic API: Isang mahabang alphanumeric na string (hal., sk_live_abc123xyz789...) Gumaganap bilang parehong authentication at authorization Nakaugnay sa iyong Cathopic account at billing Maaaring aktibo o hindi aktibo Siklo ng buhay ng key Paglikha: Bumuo ng mga key sa Settings → API Bigyan ang bawat key ng mapaglarawang pangalan ("Production Website", "Staging", "Mobile App") Kopyahin agad ang buong key—ipapakita lang ito nang isang beses Iimbak nang ligtas (environment variables, secrets manager, password manager) Paggamit: Isama sa x-api-key HTTP header sa bawat request Ang mga key ay beripikado sa server-side sa bawat request Ang lahat ng paggamit ng API ay sinusubaybayan at sinisingil sa iyong account Pagde-deactivate: Maaaring pansamantalang i-disable ang mga key nang hindi tinatanggal Kapaki-pakinabang para sa troubleshooting o pag-pause ng partikular na integration Maaari itong muling i-activate anumang oras Pagtanggal: Permanenteng inaalis ang key Hindi na mababawi o maibabalik Lahat ng request gamit ang key na iyon ay agad mabibigo Mga alituntunin sa pamamahala ng key Seguridad: Huwag kailanman i-commit ang mga key sa version control: Gamitin .env mga file at idagdag sa .gitignore Huwag kailanman ilantad sa client-side code: Dapat gamitin ang mga API key sa server-side lamang Gumamit ng environment variables: Iimbak ang mga key sa process.env.CATHOPIC_API_KEY o katumbas Mag-rotate nang regular: Palitan ang mga key paminsan-minsan (tuwing quarterly o pagkatapos magbago ang miyembro ng team) Gumamit ng magkakahiwalay na key bawat environment: Iba-iba ang key para sa dev, staging, at production Organisasyon: Mapaglarawang pangalan: Pangalanan ang mga key ayon sa layunin: "Production Website", "iOS App", "Email System" I-dokumento ang pagmamay-ari: Tukuyin kung aling miyembro ng team ang gumawa ng bawat key Regular na audit: Suriin ang mga aktibong key buwan-buwan at alisin ang mga hindi ginagamit Maramihang API key Maaari kang gumawa ng maraming API key para sa iba’t ibang layunin: Bawat environment: Magkahiwalay na key para sa development, staging, at production Bawat application: Iba-iba ang key para sa website, mobile app, at internal tools Bawat miyembro ng team: Mga indibidwal na key para sa mga developer (mas madaling subaybayan at i-revoke) Ang lahat ng key sa ilalim ng iyong account ay may iisang billing. Ang paggamit mula sa lahat ng key ay pinagsasama sa iyong buwanang invoice. Pagsubaybay sa paggamit ng key Subaybayan ang aktibidad para sa bawat key: Pumunta sa Settings → API Tingnan ang listahan ng lahat ng key kasama ang huling petsa na ginamit I-click ang isang key para makita ang detalyadong istatistika ng paggamit Mag-monitor para sa hindi inaasahang aktibidad Ano ang gagawin kung may nakompromisong key Kung naniniwala kang nalantad ang isang API key: Agad na tanggalin o i-deactivate ang key sa Settings → API Bumuo ng bagong kapalit na key I-update ang iyong application gamit ang bagong key Suriin ang mga log ng paggamit para sa anumang kahina-hinalang aktibidad Makipag-ugnayan sa support kung may makita kang hindi awtorisadong paggamit Halimbawa: Ligtas na pag-iimbak ng mga key Node.js gamit ang environment variables: // .env file (add to .gitignore!) CATHOPIC_API_KEY=sk_live_abc123xyz789... // Your code require('dotenv').config(); const apiKey = process.env.CATHOPIC_API_KEY; fetch('https://api.cathopic.com/resources', { method: 'POST', headers: { 'x-api-key': apiKey, 'Content-Type': 'application/json' }, body: JSON.stringify({ query: 'Jesus' }) }); Python gamit ang environment variables: import os import requests api_key = os.environ.get('CATHOPIC_API_KEY') response = requests.post( 'https://api.cathopic.com/resources', headers={'x-api-key': api_key}, json={'query': 'Jesus'} )

Question 7

Paano ko i-authenticate ang mga request?

Accepted Answer

Lahat ng request sa Cathopic API ay dapat i-authenticate gamit ang iyong API key. Narito kung paano maayos na i-authenticate ang iyong mga API call. Paraan ng pag-a-authenticate Gumagamit ang Cathopic API ng API key authentication sa pamamagitan ng HTTP headers: Pangalan ng header: x-api-key Halaga ng header: Ang iyong buong API key Kinakailangan para sa: Lahat ng API endpoints Case sensitive: Dapat eksaktong tumugma ang mga pangalan at halaga ng header Halimbawa ng basic authentication cURL: curl -X POST https://api.cathopic.com/resources \ -H "x-api-key: YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "Birheng Maria", "page": 1, "page_size": 20, "order": "popular" }' JavaScript (fetch): const response = await fetch('https://api.cathopic.com/resources', { method: 'POST', headers: { 'x-api-key': process.env.CATHOPIC_API_KEY, 'Content-Type': 'application/json' }, body: JSON.stringify({ query: 'Birheng Maria', page: 1, page_size: 20, order: 'popular' }) }); const data = await response.json(); console.log(data); JavaScript (axios): const axios = require('axios'); const response = await axios.post( 'https://api.cathopic.com/resources', { query: 'Birheng Maria', page: 1, page_size: 20, order: 'popular' }, { headers: { 'x-api-key': process.env.CATHOPIC_API_KEY } } ); console.log(response.data); Python (requests): import os import requests api_key = os.environ.get('CATHOPIC_API_KEY') response = requests.post( 'https://api.cathopic.com/resources', headers={ 'x-api-key': api_key, 'Content-Type': 'application/json' }, json={ 'query': 'Birheng Maria', 'page': 1, 'page_size': 20, 'order': 'popular' } ) data = response.json() print(data) PHP (cURL):

Question 8

Paano ko i-rotate ang isang API key?

Accepted Answer

Ang regular na pag-rotate ng mga API key ay isang mahalagang kasanayan sa seguridad. Narito kung paano ligtas na i-rotate ang iyong mga key nang hindi naaabala ang iyong serbisyo. Bakit i-rotate ang mga API key? Pinakamahusay na kasanayan sa seguridad: Nililimitahan ang pagkakalantad kung sakaling ma-compromise ang isang key Mga pagbabago sa miyembro ng team: Kapag umalis ang mga developer o nagbago ng tungkulin Pinaghihinalaang pag-compromise: Kung naniniwala kang maaaring nalantad ang isang key Pagsunod (Compliance): Ang ilang patakaran sa seguridad ay nangangailangan ng pana-panahong pag-rotate ng key Mga pagbabago sa environment: Kapag nagmi-migrate ng imprastraktura o nagre-refactor Karaniwang proseso ng pag-rotate (zero downtime) Hakbang 1: Gumawa ng bagong key Mag-log in sa Settings → API I-click "Create new API key" Bigyan ito ng malinaw na pangalan (hal., "Production Web v2") Kopyahin agad ang bagong key—ipapakita lang ito nang isang beses I-store ito nang ligtas Hakbang 2: I-update ang iyong application I-deploy ang bagong key sa iyong application (environment variables, secrets manager, atbp.) I-restart ang iyong application para ma-load ang bagong key I-verify na gumagana nang tama ang bagong key Mag-monitor para sa anumang error Hakbang 3: I-monitor ang paglipat Panatilihing aktibo muna ang parehong key Tingnan Settings → API para makita ang mga petsa ng "Last used" Maghintay hanggang ang lumang key ay walang kamakailang aktibidad Siguraduhing lahat ng instance/serbisyo ay lumipat na sa bagong key Hakbang 4: Tanggalin ang lumang key Kapag nakumpirma na ang lumang key ay hindi na ginagamit Tanggalin o i-deactivate ang lumang key sa Settings → API I-document ang pag-rotate para sa iyong mga tala Mabilis na proseso ng pag-rotate (kung na-compromise) Kung ang isang key ay tiyak na na-compromise at kailangan mong kumilos agad: Tanggalin muna ang na-compromise na key sa Settings → API Gumawa ng bagong kapalit na key Mabilis na i-deploy ang bagong key sa lahat ng application Tanggapin ang maikling downtime para maiwasan ang hindi awtorisadong pag-access I-monitor ang mga usage log para sa anumang kahina-hinalang aktibidad Makipag-ugnayan sa support kung kailangan Istratehiya sa pag-rotate sa maraming environment Para sa mga production system, gumamit ng phased approach: Linggo 1: Development Gumawa at i-deploy ang bagong key sa dev environment Subukan nang masinsinan Linggo 2: Staging I-deploy ang bagong key sa staging Patakbuhin ang integration tests Mag-monitor para sa mga isyu Linggo 3: Production I-deploy ang bagong key sa production sa panahon ng mababang trapiko Mag-monitor nang mabuti Panatilihing aktibo ang lumang key sa loob ng 24-48 oras bilang fallback Linggo 4: Cleanup I-verify na walang aktibidad ang lumang key Tanggalin ang lumang key I-update ang dokumentasyon Halimbawa ng automation Script para makatulong na i-verify na kumpleto ang pag-rotate ng key: #!/bin/bash # check-api-key.sh OLD_KEY="sk_live_OLD123..." NEW_KEY="sk_live_NEW789..." echo "Testing old key..." OLD_RESPONSE=$(curl -s -w "%{http_code}" -X POST https://api.cathopic.com/resources \ -H "x-api-key: $OLD_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"test","page":1,"page_size":1}') echo "Testing new key..." NEW_RESPONSE=$(curl -s -w "%{http_code}" -X POST https://api.cathopic.com/resources \ -H "x-api-key: $NEW_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"test","page":1,"page_size":1}') echo "Old key status: ${OLD_RESPONSE: -3}" echo "New key status: ${NEW_RESPONSE: -3}" if [ "${NEW_RESPONSE: -3}" == "200" ]; then echo "✅ New key is working!" else echo "❌ New key failed!" fi Mga best practices Mag-rotate nang regular: Bawat 90 araw para sa mga production key I-document ang mga pag-rotate: Magtago ng tala kung kailan na-rotate ang mga key at kung bakit Subukan bago tanggalin: Palaging i-verify na gumagana ang bagong key bago alisin ang lumang key Gumamit ng maraming key: Paghiwalayin ang mga key per environment para mas madaling mag-rotate I-automate kung posible: Gumamit ng mga tool sa secrets management na sumusuporta sa automatic rotation Checklist pagkatapos ng pag-rotate I-verify ang mga item na ito pagkatapos mag-rotate: ✅ Lahat ng production instances na gumagamit ng bagong key ✅ Lahat ng staging/dev environments na na-update (kung gumagamit ng parehong key) ✅ Na-update ang mga environment variables ✅ Na-update ang CI/CD secrets ✅ Na-update ang dokumentasyon ✅ Naabisuhan ang mga miyembro ng team ✅ Tanggal ang lumang key ✅ Na-log ang pag-rotate para sa audit purposes

Question 9

Paano ko mapoprotektahan ang aking mga kredensyal?

Accepted Answer

Ang iyong mga API key ay ang daanan para sa iyong Cathopic account. Ang pagpapanatiling ligtas sa mga ito ay pumipigil sa hindi awtorisadong pag-access at nagpoprotekta laban sa pandaraya sa pagsingil. Ang ginintuang tuntunin: Panatilihing lihim ang mga key Tratuhin ang iyong mga API key na parang mga password. Mga karaniwang pagkakamaling dapat iwasan: I-hardcode ang mga key nang direkta sa source code I-commit ang mga key sa Git o iba pang version control Gamitin ang mga key sa client-side JavaScript o mga mobile app Ibahagi ang mga key sa pamamagitan ng email, Slack, o mga messaging app Iimbak ang mga key sa mga pampublikong lokasyon (public repos, wikis, atbp.) Gumamit ng environment variables I-store ang mga key sa environment variables imbes na sa code: // .env file (add to .gitignore!) CATHOPIC_API_KEY=sk_live_abc123xyz789... // Your code require('dotenv').config(); const apiKey = process.env.CATHOPIC_API_KEY; Inihihiwalay nito ang sensitibong impormasyon sa iyong codebase at ginagawang mas madali ang pag-rotate ng key. Para lamang sa server-side Dapat maganap ang mga API call mula sa iyong mga backend server, hindi mula sa mga browser o mobile app. Kung kailangan ng mga user ng access sa mga mapagkukunan ng Cathopic: Gumawa ng backend endpoint na gumagamit ng iyong API key Ang iyong frontend ay tumatawag sa IYONG endpoint, hindi sa Cathopic nang direkta Ibe-validate ng iyong server ang kahilingan ng user bago tumawag sa Cathopic I-restrict ayon sa IP (kung posible) Ang ilang infrastructure ay nagbibigay-daan sa IP whitelisting. Kung ang iyong mga API call ay nagmumula sa mga kilalang IP: I-configure ang mga firewall rule upang limitahan ang outbound access Gumamit ng mga dedicated service account na may pinakamababang permissions Subaybayan ang access logs para sa hindi pangkaraniwang aktibidad Kung may nakompromisong key Kung pinaghihinalaan mong nalantad ang isang key: Agad na gumawa ng bagong API key I-update ang iyong application gamit ang bagong key Tanggalin ang nakompromisong key Suriin ang mga usage logs para sa kahina-hinalang aktibidad Makipag-ugnayan sa support kung may makikita kang mga singiling na hindi awtorisado Pamahalaan nang ligtas ang iyong mga key sa Settings → API.

Question 10

Mga karaniwang error sa pag-authenticate

Accepted Answer

Kung nahihirapan kang mag-authenticate gamit ang Cathopic API, ito ang mga pinakakaraniwang error at kung paano ayusin ang mga ito. 401 Unauthorized Ang pinakakaraniwang error sa pag-authenticate: HTTP 401 Unauthorized { "message": "Unauthorized" } Mga karaniwang sanhi: Nawawala x-api-key header Hindi wasto o nag-expire na API key Typo sa API key May whitespace bago/pagkatapos ng key Hindi na-load ang key mula sa environment variable Paano ayusin: I-verify na eksakto ang pangalan ng header x-api-key (lowercase) Kopyahin muli ang iyong API key mula sa Settings → API Tiyaking na-load ang mga environment variable: console.log(process.env.CATHOPIC_API_KEY) Tanggalin ang whitespace: apiKey.trim() I-verify na aktibo ang key (hindi tinanggal o dinisabled) Maling pangalan ng header Kinakailangan ng API ang x-api-key, hindi ang ibang karaniwang pangalan ng header: // ❌ MALI Authorization: Bearer sk_live_abc... API-Key: sk_live_abc... apikey: sk_live_abc... // ✅ TAMA x-api-key: sk_live_abc... Error sa unauthorized token HTTP 401 Unauthorized { "error": "Unauthorized token" } Sanhi: Nadisable o natanggal ang iyong API key. Paano ayusin: Tingnan kung aktibo pa rin ang key sa Settings → API I-reactivate ang key kung nadisable ito Gumawa ng bagong key kung natanggal ang luma Hindi na-load ang environment variable Hindi mahanap ng iyong code ang API key: // Nagbabalik ng undefined const apiKey = process.env.CATHOPIC_API_KEY; console.log(apiKey); // undefined Paano ayusin: Node.js: // Siguraduhing na-load ang .env require('dotenv').config(); const apiKey = process.env.CATHOPIC_API_KEY; if (!apiKey) { throw new Error('CATHOPIC_API_KEY not set'); } Python: import os from dotenv import load_dotenv load_dotenv() api_key = os.environ.get('CATHOPIC_API_KEY') if not api_key: raise ValueError('CATHOPIC_API_KEY not set') Error sa paglantad sa client-side Sinusubukang gamitin ang API key sa browser JavaScript: // ❌ Mabibigo ito (hindi gumagana ang mga key sa browsers) fetch('https://api.cathopic.com/resources', { headers: { 'x-api-key': 'sk_live_abc...' } }); Paano ayusin: Gumawa ng server-side endpoint na nagsisilbing proxy sa mga request papunta sa Cathopic API. Tingnan ang "Paano ko mapo-protekta ang aking mga kredensyal?" para sa mga halimbawa. Mga error sa CORS Kung makakita ka ng mga error sa CORS sa browser console: Na-block ang access sa fetch dahil sa patakaran ng CORS... Sanhi: Sinusubukan mong tawagin nang direkta ang API mula sa client-side JavaScript. Paano ayusin: Ang Cathopic API ay server-side lamang. Kailangan mong i-proxy ang mga request sa pamamagitan ng sarili mong backend. Pagsusuri ng pag-authenticate Mabilis na test para beripikahin ang setup mo: curl -v -X POST https://api.cathopic.com/resources \ -H "x-api-key: YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"test","page":1,"page_size":1}' # Maghanap ng HTTP 200 response # Kung 401, maingat na suriin ang key Checklist sa pag-debug Kung hindi pa rin gumagana ang pag-authenticate: ☐ Ang pangalan ng header ay x-api-key (case sensitive) ☐ Ang API key ay ang buong key (nagsisimula sa sk_live_ o katulad nito) ☐ Walang Bearer prefix o mga panipi sa paligid ng key ☐ Naka-set at na-load ang environment variable ☐ Ang request ay ipinapadala mula sa server-side, hindi mula sa browser ☐ Aktibo ang key sa Settings → API ☐ Idinagdag ang paraan ng pagbabayad at valid Kung magpapatuloy ang problema, makipag-ugnayan sa developer support gamit ang: Ang mensahe ng error Huling 4 na digit ng iyong API key Wikang programming at framework Halimbawang code (nang hindi inilalantad ang buong key mo)

Question 11

Mga magagamit na parameter ng paghahanap

Accepted Answer

Ang /resources tumatanggap ng ilang parameter upang mapino ang mga resulta ng iyong paghahanap. Pangunahing paghahanap POST https://api.cathopic.com/resources { "query": "Saint Francis", "page": 1, "page_size": 20, "order": "popular" } Mga parameter query (string, optional) Ang iyong termino sa paghahanap. Iwanang walang laman upang makuha ang lahat ng resources. Mga halimbawa: "Virgin Mary", "Eucharist", "cross" Sumusuporta sa malabong pagtutugma at pagtanggap sa mga typo Naghahanap sa mga pamagat, paglalarawan, at tag page (integer, default: 1) Aling pahina ng mga resulta ang ibabalik. Nagsisimula sa 1. page_size (integer, default: 20, max: 100) Bilang ng mga resulta kada pahina. Ang maximum ay 100 upang mapanatili ang performance. order (string, default: "popular") Paano pag-uri-uriin ang mga resulta: popular - Unang ipapakita ang mga pinakamaraming na-download na resources recent - Unang ipapakita ang pinakabagong mga upload Istruktura ng tugon { "total": 1523, "page": 1, "page_size": 20, "results": [ { "id": 1234, "name": "Resource title", "description": "Resource description", "type": "photo", "orientation": "portrait", "thumbnail_url": "https://...", "author": { ... }, "tags": ["tag1", "tag2"] } ] } Mga praktikal na halimbawa Kunin ang unang 10 pinakasikat na resources tungkol sa panalangin: { "query": "prayer", "page": 1, "page_size": 10, "order": "popular" } Kunin ang mga kamakailang upload, nang walang partikular na termino sa paghahanap: { "query": "", "page": 1, "page_size": 50, "order": "recent" } Mag-browse ng pahina 3 ng mga larawan ng mga santo: { "query": "saints", "page": 3, "page_size": 20, "order": "popular" } Para sa kumpletong sanggunian ng API, bisitahin ang api.cathopic.com/docs.

Question 12

Paano ako makakapag-download ng mga larawan sa pamamagitan ng API?

Accepted Answer

Mahalagang paglilinaw: Ang API ay hindi nagpapahintulot ng "pagda-download" sa tradisyonal na kahulugan. Sa halip, nagbibigay ito ng permanenteng mga URL sa nilalamang na-optimize para sa web na hinahain ng iyong application sa mga end user. Ito ay pinamamahalaan ng aming Kasunduan sa Lisensya ng API. HINDI mo dina-download ang mga file Ang Cathopic API ay gumagana sa panimula na naiiba sa mga tradisyonal na pagda-download: Walang paglilipat ng file: Hindi mo kailanman natatanggap o naiimbak ang aktuwal na mga file ng larawan/video Pag-access na nakabatay sa URL: Ang API ay nagbibigay ng mga URL na tumuturo sa nilalamang naka-host sa Cathopic Web-optimized lamang: Ang nilalaman ay hinahain sa resolusyong angkop para sa digital na pagpapakita Walang orihinal na mga file: Ang mga orihinal na may mataas na resolusyon ay HINDI kailanman naa-access sa pamamagitan ng API Laging naka-host: Ang nilalaman ay nananatili sa mga server ng Cathopic o sa awtorisadong CDN Magagamit na mga resolusyon : Ang API ay nagbibigay ng tatlong laki na na-optimize para sa web: Maliit: Angkop para sa mga thumbnail at maliliit na embed (karaniwang ~400px ang lapad) Katamtaman: Maganda para sa karaniwang nilalaman sa web (karaniwang ~800px ang lapad) Malaki: Pinakamahusay ang kalidad para sa pagpapakita sa web (karaniwang ~1200px ang lapad) Mahahalagang paghihigpit: Ang mga orihinal na high-resolution na file ay HINDI kailanman ibinibigay Ang mga resolusyon ay na-optimize para sa pagpapakita sa screen, hindi para sa pagpi-print Ang mga laki ng file ay pinipiga para sa mabilis na paghahatid sa web Hindi ka makakahiling ng mga custom na resolusyon o orihinal na kalidad Para sa kumpletong mga tuntunin, basahin ang buong Kasunduan sa Lisensya ng API at suriin ang teknikal na dokumentasyon sa api.cathopic.com/docs. Ang pagda-download ng mga larawan ay may dalawang hakbang: pagli-lisensya sa resource gamit ang /confirm, pagkatapos ay gamitin ang mga URL na ibinalik. Hakbang 1: I-lisensya ang resource Tawagin /confirm para i-lisensyahan ang isang resource para sa partikular na end-user: POST https://api.cathopic.com/confirm x-api-key: YOUR_API_KEY { "media_id": 1234, "usage_type": "website", "client_identifier": "user_123" } Mga parameter: media_id - Ang resource ID mula sa iyong mga resulta ng paghahanap usage_type - Alinman sa "website" o "email" client_identifier - Natatanging ID para sa iyong end-user Hakbang 2: Gamitin ang mga download URL Ang tugon ay naglalaman ng mga permanenteng URL sa maraming format: { "download_url": { "avif": { "320": "https://...", "640": "https://...", "1280": "https://...", "1920": "https://...", "2560": "https://..." }, "jpeg": { "320": "https://...", "640": "https://...", "1280": "https://...", "1920": "https://...", "2560": "https://..." } } } Mahalaga: I-store ang mga URL Ang mga URL na ibinabalik ay permanente - i-store ang mga ito sa iyong database: // Pagkatapos tumawag sa /confirm const response = await api.confirm(mediaId, userId); // I-store sa iyong database await db.save({ userId: userId, mediaId: mediaId, avifUrls: response.download_url.avif, jpegUrls: response.download_url.jpeg, licensedAt: new Date() }); // Sa susunod, kunin mula sa DB imbes na tumawag muli sa /confirm Pagpili ng tamang format Format na AVIF: Mas maliliit na laki ng file (mas magandang performance) Mas mahusay na compression Inirerekomenda para sa mga modernong browser Hindi sinusuportahan sa mga lumang browser Format na JPEG: Pangkalahatang compatibility Mas malalaking laki ng file Gamitin bilang fallback para sa mga lumang browser Mahahalagang paalala ⚠️ Laging suriin ang iyong database bago tumawag sa /confirm. Ang pagtawag nito nang maraming beses para sa parehong user at resource ay lilikha ng mga duplicate na singil. Buong dokumentasyon sa api.cathopic.com/docs.

Question 13

Paghahandle ng pagination at sorting

Accepted Answer

Ibinabalik ng API ang mga resulta ng paghahanap sa mga pahina. Narito kung paano mahusay na mag-navigate sa malalaking set ng resulta. Pangunahing pagination POST /resources { "query": "saints", "page": 1, "page_size": 20 } Response: { "total": 1523, "page": 1, "page_size": 20, "results": [ ... 20 items ... ] } Sinasabi sa iyo ng response na may kabuuang 1,523 na resulta, at tinitingnan mo ang page 1 na may 20 item. Pagkalkula ng kabuuang bilang ng mga pahina const totalPages = Math.ceil(response.total / response.page_size); // 1523 / 20 = 76.15 → 77 pages Paglo-load ng susunod na pahina // Simpleng susunod na pahina currentPage++; // O buuin ang pagination UI for (let page = 1; page <= totalPages; page++) { // Gumawa ng button ng pahina } Pag-o-optimize ng page size Piliin ang page size batay sa iyong sitwasyon ng paggamit: Maliliit na pahina (10-20 item): Mas mabilis ang unang pag-load Maganda para sa paghahanap na nakikita ng user Kailangan ng mas maraming kahilingan sa API Malalaking pahina (50-100 item): Mas kaunting kahilingan sa API Maganda para sa batch processing Mas mabagal ang mga indibidwal na kahilingan Ang maximum ay 100 item Mga opsyon sa sorting Popular (default): { "order": "popular" } Ibinabalik muna ang mga pinaka-na-download na resources. Pinakamainam para sa pagpapakita ng de-kalidad at napatunayang content. Kamakailan lang: { "order": "recent" } Ibinabalik muna ang pinakabagong mga upload. Maganda para sa pagtuklas ng sariwang content. Halimbawa ng infinite scroll let currentPage = 1; const pageSize = 20; let isLoading = false; let hasMore = true; async function loadMore() { if (isLoading || !hasMore) return; isLoading = true; const response = await fetch('https://api.cathopic.com/resources', { method: 'POST', headers: { 'x-api-key': apiKey, 'Content-Type': 'application/json' }, body: JSON.stringify({ query: 'prayer', page: currentPage, page_size: pageSize, order: 'popular' }) }); const data = await response.json(); // Idagdag ang mga resulta sa iyong UI appendResults(data.results); // Suriin kung may mga susunod pang pahina const totalPages = Math.ceil(data.total / pageSize); hasMore = currentPage < totalPages; currentPage++; isLoading = false; } // I-trigger kapag nag-scroll window.addEventListener('scroll', () => { if (window.innerHeight + window.scrollY >= document.body.offsetHeight - 500) { loadMore(); } }); Mga tip sa performance I-cache ang mga resulta nang lokal para maiwasan ang paulit-ulit na kahilingan Gumamit ng angkop na page sizes para sa iyong sitwasyon ng paggamit Ipatupad ang loading states para sa mas magandang UX Isaalang-alang ang virtualization para sa napakalalaking listahan Huwag kunin ang lahat ng pahina nang sabay - mag-load kapag kailangan Para sa higit pang detalye, tingnan ang buong dokumentasyon sa api.cathopic.com/docs.

Question 14

Paano maghanap sa catalog at gamitin ang Cathopic preview URLs

Accepted Answer

Gamitin GET /api/v2/catalog na catalog.read. Ginagamit nito ang kasalukuyang typo-tolerant fuzzy search layer ng Cathopic at pinapagana ang parehong canonical media models na ginagamit ng website grid. Mga parameter q o query: text hanggang 250 character. type: photo, video, graphic, artwork, ai, o lahat. orientation: landscape, portrait, square, o lahat. sort: most_recent, popular, o popular_alltime. page, per_page hanggang 50, at locale. GET /api/v2/catalog?q=adoration&type=photo&orientation=landscape&per_page=30 Authorization: Bearer ACCESS_TOKENGamitin nang hindi nagbabago ang preview URLs Kasama sa bawat resulta ang preview.url at preview.transformation_url_template. Nagmumula ang mga ito sa eksaktong parehong grid presenter, CDN host, storage path, at watermark rules na ginagamit sa cathopic.com. Gamitin nang hindi nagbabago ang mga ito upang magamit muli ng mga integration ang kasalukuyang Cloudflare cache keys. Huwag mag-upload ng isa pang kopya o i-proxy ito nang hindi kinakailangan. Huwag magdagdag ng cache-busting query parameters. Palitan ang <OPTIONS> ng stable Cloudflare image options lamang. Ang mga preview ay hindi kailanman kumokonsumo ng download. already_licensed kasama ang mga indibidwal at shared-team entitlements.

Question 15

Paano maglisensya at mag-download ng resource nang ligtas

Accepted Answer

Ang paglikha ng lisensya at ang paglikha ng orihinal na URL ay hiwalay, kaya ligtas ang mga retry at hindi na muling sisingilin ang mga sariwang URL. 1. Lumikha ng lisensya POST /api/v2/licenses Authorization: Bearer ACCESS_TOKEN Content-Type: application/json Idempotency-Key: 2bd25ec7-12da-45fc-9daa-67593b510932 {"media_id":123}Gumamit ng natatanging key na 8 hanggang 160 printable ASCII characters para sa lohikal na pagtatangkang pagpili at panatilihin ito kapag nagre-retry. Ang bagong lisensya ay nagbabalik ng 201; ang idempotent na replay ay nagbabalik ng 200 na may parehong license ID. Unang beripikahin ng Cathopic ang orihinal. Sa isang transaksyon, i-lock nito ang indibidwal o subscription ng team, tinitingnan ang access sa media at ang mga kasalukuyang shared entitlements, kumokonsumo ng hanggang isang download, at itinatala ang entitlement, history, at lisensya. 2. Humiling ng orihinal na URL POST /api/v2/licenses/LICENSE_UUID/download-url Authorization: Bearer ACCESS_TOKENNag-e-expire ang URL pagkatapos ng limang minuto. Humiling ng bagong URL para sa muling pag-download; huwag gumawa ng isa pang lisensya. Iniuugnay ng Cathopic ang storage path at hindi kailanman tumatanggap ng arbitrary na path. Mga mahahalagang error subscription_required: walang aktibong bayad na access. media_type_not_in_plan: ang uri ay hindi kasama. download_balance_exhausted: walang natitirang download para sa limited-plan. file_unavailable: nawawala ang orihinal; walang sisingil. idempotency_key_conflict: ang key ay ginamit para sa ibang media ID. Itago ang X-Request-Id para sa suporta, ngunit huwag kailanman mag-log ng mga token, secret, o signed URLs. Mag-back off na may jitter pagkatapos ng 429 o pansamantalang tugon na 5xx.

Question 16

Mabilisang gabay sa OAuth 2.0 para sa mga Cathopic connected apps

Accepted Answer

Gumagamit ang Cathopic Connected Apps ng OAuth 2.0 Authorization Code na may kinakailangang PKCE S256. Ang parehong pag-apruba ng developer ay nagbubukas din ng komersyal na API ng Cathopic, ngunit ang mga koneksyon sa OAuth ay gumagamit ng mga token ng user at plan ng naka-connect na user, hindi mga API key at metered na pagsingil sa API. 1. Kumuha ng access at irehistro ang application Isumite ang iisang developer access request sa pamamagitan ng contact form. Matapos aprubahan ng Cathopic ang account sa pamamagitan ng email, buksan ang Settings → Developer / API → OAuth applications, gawin ang application, irehistro ang eksaktong callbacks at mga kinakailangang scope nito, at itabi ang one-time secret nito kung ito ay confidential. 2. Tuklasin ang authorization server GET https://cathopic.com/.well-known/oauth-authorization-server3. I-redirect ang user GET https://cathopic.com/oauth/authorize ?client_id=CLIENT_ID &redirect_uri=EXACT_CALLBACK &response_type=code &scope=account.read%20catalog.read%20entitlements.read%20licenses.create%20licenses.read &state=UNGUESSABLE_STATE &code_challenge=BASE64URL_SHA256_VERIFIER &code_challenge_method=S256 &ui_locales=enBumuo ng isang URL; ang mga line break ay para lang gawing madaling basahin ang halimbawa. Bumuo ng bagong high-entropy na state at PKCE values para sa bawat pagtatangka. ui_locales ay opsyonal at maaaring humiling ng suportadong wika tulad ng en o es. Kung kailangan ang sign-in, ipagpapatuloy ng Cathopic ang parehong authorization request at pagkatapos ay ipapakita ang permission screen. 4. I-validate ang callback at i-exchange ang code Ihambing ang ibinalik na state bago i-exchange ang code. Dapat tumugma ang redirect URI nang eksakto, byte for byte. POST https://cathopic.com/oauth/token Content-Type: application/x-www-form-urlencoded grant_type=authorization_code&client_id=CLIENT_ID&client_secret=CLIENT_SECRET&redirect_uri=EXACT_CALLBACK&code=CODE&code_verifier=VERIFIERAng mga public application ay hindi kasama ang client_secret. Itabi ang mga token at confidential secrets lamang sa server at i-encrypt ang mga ito habang nakaimbak. Ang access tokens ay tumatagal ng huling 30 minuto; ang refresh tokens ay tumatagal hanggang 30 araw at umiikot kapag nagamit. Mga karaniwang pagsusuri Ang isang tinanggihang callback ay kadalasang naiiba sa registered URI dahil sa scheme, host, port, path, casing, o trailing slash. invalid_request bago ang consent ay nangangahulugang nawawala o hindi wasto ang PKCE S256, ang challenge, o ang state. invalid_grant karaniwang nangangahulugang na-reuse ang isang code o na-rotate na refresh token, o nagbago ang callback o verifier. Pagkatapos ng 401, i-refresh nang isang beses; kung mabigo ang refresh, hilingin sa user na muling kumonekta. Ang 403 ay nangangahulugang kulang ang token sa kinakailangang scope. Tingnan ang kumpletong OpenAPI contract at ang detalyadong Connected Apps integration guide.

Question 17

Paano ko ikokonekta ang Cathopic sa isa pang application?

Accepted Answer

Ang isang aprubadong platform ay maaaring magbigay-daan sa iyong gamitin ang Cathopic catalog nang hindi mo natatanggap ang iyong password. Ire-redirect nito ang iyong browser sa isang secure na pahina sa cathopic.com, kung saan ka mag-sign in at susuriin ang eksaktong mga pahintulot na hinihiling. Ikonekta ang iyong account Sa ibang application, piliin ang connector nito para sa Cathopic at i-click Connect o Mag-sign in gamit ang Cathopic. Kumpirmahin na ang browser ay nasa cathopic.com. Mag-sign in sa Cathopic kung kinakailangan. Ibinabalik ka ng Cathopic sa parehong kahilingan sa pahintulot sa halip na buksan ang iyong profile. Basahin ang bawat pahintulot. Maaaring kabilang dito ang pagkakakilanlan ng account, pag-access sa catalog, balanse ng subscription, o ang kakayahang maglisensya ng mga resource. Piliin Payagan ang pag-access. Ibinabalik ka lang ng Cathopic pabalik sa eksaktong callback na nakarehistro para sa application na iyon. Wika at kaligtasan ng account Maaaring humiling ang application ng suportadong wika para sa sign-in at mga pahina ng pahintulot. Pinapanatili ng Cathopic ang wikang iyon sa buong koneksyon. Tumatanggap ang application ng mga token na panandalian lang, hindi kailanman ang iyong password, at maaari lamang nitong isagawa ang mga aksyong nakalista sa pahina ng pahintulot. Kung hindi mo pinagkakatiwalaan ang kahilingan Piliin Kanselahin. Huwag aprubahan ang koneksyon kung ang application ay hindi pamilyar, ang mga pahintulot ay mukhang hindi kailangan, o hindi ipinapakita ng browser ang Cathopic domain. Maaari mong bawiin ang pag-access sa ibang pagkakataon mula sa Mga Setting → Developer / API → Mga Connected app.

Question 18

Gumagamit ba ang mga connected app ng aking mga download, at paano ko sila ididiskonekta?

Accepted Answer

Ang paghahanap at pagpapakita ng mga preview na may watermark ay hindi kumokonsumo ng download. Ang isang download ay puwedeng maubos lamang kapag ang isang connected application ay humiling sa Cathopic na lisensyahan ang isang bayad na resource. Kapag isang download ang naubos Ang resource ay may bayad, kasama sa plan ang uri nito, at wala ni ikaw o ang kasalukuyang subscription ng team ang nakalilisensya nito dati. Ang plan ay may limitadong balanse. Ang mga unlimited plan ay nagtatala ng lisensya nang hindi binabawasan ang isang bilang. Magagamit ang orihinal na file. Ibe-verify ito ng Cathopic bago baguhin ang balanse. Kapag walang karagdagang download na naubos Ang resource ay libre. Ikaw o ang ibang miyembro na gumagamit ng parehong subscription ng team ay nakalilisensya na nito. Humiling ka ng bagong link ng download para sa isang umiiral na lisensya. Sinusubukan muli ng application ang parehong request gamit ang parehong idempotency key. Kino-consume ng mga miyembro ng team ang shared balance na ibinabahagi ng may-ari ng team. Ang Cathopic ang palaging source of truth. Idiskonekta ang isang application Buksan Settings → Developer / API → Connected apps. Suriin ang application at ang mga pahintulot nito. I-click Idiskonekta at kumpirmahin. Ang bawat aktibong access at refresh token para sa application na iyon ay agad na nire-revoke. Mananatili ang mga umiiral na lisensya at kasaysayan ng download.

Question 19

Mga karaniwang code ng error sa API

Accepted Answer

Ang pag-unawa sa mga tugon ng error ay makakatulong sa iyong ma-debug nang mabilis ang mga isyu. Narito ang mga pinakakaraniwang error na makakaharap mo. 400 Bad Request { "error": "media_id is required" } Mga sanhi: Nawawala ang kinakailangang parameter Hindi wasto ang format ng parameter Maling anyo ng JSON Ayusin: Tiyaking ang iyong request body ay tugma sa API specification sa api.cathopic.com/docs. 401 Unauthorized { "message": "Unauthorized" } o { "error": "Unauthorized token" } Mga sanhi: Nawawala o hindi wasto ang API key Hindi na-activate ang API key Maling pangalan ng header Ayusin: I-verify na ang iyong x-api-key header ay tama at ang key ay aktibo sa Settings → API. 404 Not Found { "error": "No file found for media_id 1234" } o { "error": "Media item not found" } Mga sanhi: Walang ganitong resource Nabura na ang resource Maling media_id Ayusin: I-verify na umiiral ang media_id sa pamamagitan ng paghahanap muna gamit ang /resources. 429 Too Many Requests { "error": "Limit exceed." } Mga sanhi: Napakaraming request sa maikling panahon Nalampasan ang rate limit Ayusin: Ipatupad ang exponential backoff. Maghintay at subukang muli na may pagtaas ng pagitan (1s, 2s, 4s, atbp.). 500 Internal Server Error { "error": "Internal server error" } Mga sanhi: Pansamantalang isyu sa server Hindi inaasahang kondisyon Ayusin: Maghintay sandali at subukang muli. Kung magpapatuloy, makipag-ugnayan sa support. Halimbawa ng paghawak ng error async function searchWithErrorHandling(query) { try { const response = await fetch('https://api.cathopic.com/resources', { method: 'POST', headers: { 'x-api-key': apiKey, 'Content-Type': 'application/json' }, body: JSON.stringify({ query, page: 1, page_size: 20 }) }); if (!response.ok) { const error = await response.json(); switch (response.status) { case 400: console.error('Bad request:', error); break; case 401: console.error('Unauthorized. Check your API key.'); break; case 404: console.error('Resource not found:', error); break; case 429: console.error('Rate limited. Implementing backoff...'); await sleep(5000); return searchWithErrorHandling(query); // Retry case 500: console.error('Server error. Retrying in 10s...'); await sleep(10000); return searchWithErrorHandling(query); default: console.error('Unknown error:', error); } throw new Error(`API error: ${response.status}`); } return await response.json(); } catch (error) { console.error('Request failed:', error); throw error; } } Para sa mga paulit-ulit na error, tingnan ang kumpletong API documentation o makipag-ugnayan sa support.

Question 20

Mga error sa rate limit

Accepted Answer

Kung makikita mo ang 429 Too Many Requests, ibig sabihin ay masyadong madalas mong tinatamaan ang API. Narito kung paano ito haharapin nang tama. Ang error HTTP 429 Too Many Requests { "error": "Limit exceed." } Bakit nangyayari ito Pinoprotektahan ng mga rate limit ang API laban sa labis na paggamit: Napakaraming request sa maikling panahon Agresibong pagpo-poll o pag-scrape Walang pagkaantala sa pagitan ng mga request Mga sabayang request nang walang throttling Exponential backoff na estratehiya Ang pinakamainam na paraan para harapin ang mga rate limit ay ang exponential backoff—maghintay nang mas matagal pagkatapos ng bawat retry: async function fetchWithBackoff(url, options, maxRetries = 5) { for (let attempt = 0; attempt < maxRetries; attempt++) { try { const response = await fetch(url, options); if (response.status === 429) { const waitTime = Math.pow(2, attempt) * 1000; // 1s, 2s, 4s, 8s, 16s console.log(`Rate limited. Waiting ${waitTime}ms before retry ${attempt + 1}/${maxRetries}`); await new Promise(resolve => setTimeout(resolve, waitTime)); continue; } if (!response.ok) { throw new Error(`HTTP ${response.status}`); } return await response.json(); } catch (error) { if (attempt === maxRetries - 1) throw error; } } throw new Error('Max retries exceeded'); } Pag-iwas sa rate limits Magdagdag ng mga pagkaantala sa pagitan ng mga request: // Bad: Rapid-fire requests for (const id of mediaIds) { await api.getResource(id); // No delay } // Good: Throttled requests for (const id of mediaIds) { await api.getResource(id); await sleep(500); // 500ms delay } I-batch ang mga operasyon: // Proseso sa mga batch na 10 na may mga pagkaantala const batchSize = 10; for (let i = 0; i < mediaIds.length; i += batchSize) { const batch = mediaIds.slice(i, i + batchSize); await Promise.all(batch.map(id => api.getResource(id))); if (i + batchSize < mediaIds.length) { await sleep(2000); // 2s sa pagitan ng mga batch } } I-cache ang mga tugon: const cache = new Map(); async function getCachedResource(mediaId) { if (cache.has(mediaId)) { return cache.get(mediaId); } const data = await api.getResource(mediaId); cache.set(mediaId, data); return data; } Ano ang HINDI dapat gawin ❌ I-retry agad nang walang pagkaantala ❌ Gumawa ng mga sabayang request nang walang limit ❌ Balewalain ang mga 429 error ❌ Gumamit ng nakapirming maiikling pagkaantala (laging gumamit ng exponential backoff) Kung magpapatuloy ang mga problema Makipag-ugnayan sa developer support kung lehitimo mong kailangan ng mas mataas na rate limit para sa iyong use case. Magbigay ng mga detalye tungkol sa: Ang iyong application at use case Inaasahang dami ng request Kasalukuyang implementasyon (na may backoff)

Question 21

Mga isyu sa timeout at network

Accepted Answer

Ang mga problema sa network ay maaaring maging sanhi ng pagkabigo ng mga kahilingan sa API. Narito kung paano haharapin nang maayos ang mga timeout at mga isyu sa koneksyon. Itakda ang naaangkop na mga timeout Palaging magtakda ng mga timeout upang maiwasan ang pagbitin ng mga kahilingan: // JavaScript with fetch const controller = new AbortController(); const timeout = setTimeout(() => controller.abort(), 30000); // 30s try { const response = await fetch('https://api.cathopic.com/resources', { method: 'POST', headers: { 'x-api-key': apiKey, 'Content-Type': 'application/json' }, body: JSON.stringify({ query: 'Jesus' }), signal: controller.signal }); clearTimeout(timeout); return await response.json(); } catch (error) { clearTimeout(timeout); if (error.name === 'AbortError') { console.error('Request timed out after 30s'); } else { console.error('Network error:', error); } throw error; } // Python with requests import requests from requests.exceptions import Timeout, RequestException try: response = requests.post( 'https://api.cathopic.com/resources', headers={'x-api-key': api_key}, json={'query': 'Jesus'}, timeout=30 # 30 seconds ) return response.json() except Timeout: print('Request timed out after 30s') raise except RequestException as e: print(f'Network error: {e}') raise Mga karaniwang error sa network Timeout sa koneksyon: Hindi maitatag ang koneksyon sa server Karaniwang isyu sa network o firewall Suriin ang koneksyon sa internet Tiyaking pinapayagan ng firewall ang HTTPS sa api.cathopic.com Timeout sa pagbabasa: Naitatag ang koneksyon ngunit walang tugon Maaaring mabagal o sobrang karga ang server Dagdagan ang timeout o subukang muli sa ibang pagkakataon Kabiguan sa resolusyon ng DNS: Hindi ma-resolve ang api.cathopic.com Isyu sa DNS server Subukang muli o suriin ang mga setting ng DNS Muling subok na may backoff async function fetchWithRetry(url, options, maxRetries = 3) { for (let attempt = 0; attempt < maxRetries; attempt++) { try { const controller = new AbortController(); const timeout = setTimeout(() => controller.abort(), 30000); const response = await fetch(url, { ...options, signal: controller.signal }); clearTimeout(timeout); if (!response.ok) { throw new Error(`HTTP ${response.status}`); } return await response.json(); } catch (error) { const isLastAttempt = attempt === maxRetries - 1; if (isLastAttempt) { console.error(`All ${maxRetries} attempts failed`); throw error; } const waitTime = Math.pow(2, attempt) * 1000; console.log(`Attempt ${attempt + 1} failed. Retrying in ${waitTime}ms...`); await new Promise(resolve => setTimeout(resolve, waitTime)); } } } Mga inirerekomendang halaga ng timeout Timeout sa koneksyon: 10 seconds Timeout sa pagbabasa: 30 seconds /resources search: 30 seconds /confirm licensing: 30 seconds Pag-debug ng mga isyu sa network Gamitin ang curl upang subukan ang koneksyon: # Test basic connectivity curl -v https://api.cathopic.com/resources # Test with timeout curl --max-time 30 -X POST https://api.cathopic.com/resources \ -H "x-api-key: YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"query": "test"}' Suriin kung may: ✓ Niresolba ang DNS para sa api.cathopic.com ✓ Matagumpay ang SSL/TLS na koneksyon ✓ Nakatanggap ng HTTP response ✓ Makatwirang oras ng tugon (<5s karaniwan) Kung magpapatuloy ang mga isyu, makipag-ugnayan sa support gamit ang mga detalye ng network diagnostic.

Question 22

Nabigong kahilingan sa pag-debug

Accepted Answer

Kapag nabigo ang mga kahilingan, nakatutulong ang sistematikong pag-debug upang mabilis na matukoy ang isyu. I-enable ang detalyadong logging async function debugRequest(url, options) { console.log('=== API Request ==='); console.log('URL:', url); console.log('Method:', options.method); console.log('Headers:', { ...options.headers, 'x-api-key': options.headers['x-api-key']?.substring(0, 10) + '...' }); console.log('Body:', options.body); const startTime = Date.now(); try { const response = await fetch(url, options); const duration = Date.now() - startTime; console.log('=== API Response ==='); console.log('Status:', response.status, response.statusText); console.log('Duration:', duration + 'ms'); console.log('Headers:', Object.fromEntries(response.headers)); const data = await response.json(); console.log('Body:', data); return { response, data }; } catch (error) { console.error('=== Request Failed ==='); console.error('Error:', error.message); console.error('Duration:', Date.now() - startTime + 'ms'); throw error; } } Suriin muna ito 1. Tama ang API key: console.log('API key starts with:', apiKey.substring(0, 10)); console.log('API key length:', apiKey.length); 2. Eksakto ang pangalan ng header: // Dapat ay lowercase na 'x-api-key' headers: { 'x-api-key': apiKey, // ✓ Tama 'X-API-Key': apiKey, // ✗ Mali 'api-key': apiKey, // ✗ Mali } 3. Wasto ang JSON: try { const body = JSON.stringify({ query: 'test' }); console.log('Valid JSON:', body); } catch (e) { console.error('Invalid JSON:', e); } 4. Naabot ang server ang kahilingan: // Gamitin ang browser DevTools Network tab o curl -v -X POST https://api.cathopic.com/resources \ -H "x-api-key: YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"query": "test"}' Mga karaniwang pagkakamali Maling Content-Type: // ✗ Mali headers: { 'Content-Type': 'text/plain' } // ✓ Tama headers: { 'Content-Type': 'application/json' } Hindi ginagawang string ang body: // ✗ Mali body: { query: 'test' } // ✓ Tama body: JSON.stringify({ query: 'test' }) Gumagamit ng GET imbes na POST: // ✗ Lahat ng endpoint ay nangangailangan ng POST method: 'GET' // ✓ Tama method: 'POST' Subukan gamit ang minimal na kahilingan Ibinawas sa pinakamaliit upang maihiwalay ang isyu: const response = await fetch('https://api.cathopic.com/resources', { method: 'POST', headers: { 'x-api-key': 'YOUR_ACTUAL_KEY_HERE', 'Content-Type': 'application/json' }, body: '{}' // Walang laman na object }); console.log(response.status); console.log(await response.json()); Kung gumagana ito, unti-unting idagdag muli ang mga parameter hanggang sa muling mabigo. Ihambing sa gumaganang halimbawa Subukan gamit ang curl upang ma-verify ang iyong pagpapatupad: curl -X POST https://api.cathopic.com/resources \ -H "x-api-key: YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"query": "Jesus", "page": 1, "page_size": 5}' Kung gumagana ang curl pero hindi ang code mo, ihambing ang eksaktong headers at body. Naka-stuck pa rin? Makipag-ugnayan suporta ng developer na may: Buong mensahe ng error Mga header ng kahilingan (itago ang iyong buong API key) Body ng kahilingan Katayuan at body ng tugon Wikang pangprograma at HTTP library Snippet ng code (nang hindi inilalantad ang mga kredensyal)

Question 23

Paano makipag-ugnayan sa developer support

Accepted Answer

Kailangan mo ba ng tulong sa iyong API integration? Narito ang aming developer support team para tulungan ka. Kailan makikipag-ugnayan sa support Makipag-ugnayan kung nararanasan mo ang: Mga isyu sa authentication kahit sinunod mo ang mga gabay Mga hindi inaasahang tugon na may error Mga problema sa performance o mabagal na tugon Mga tanong tungkol sa billing o paggamit Kailangan ng mas mataas na rate limits Paglilinaw sa mga tuntunin ng lisensya Tulong sa mga partikular na sitwasyon ng integration Paano makipag-ugnayan sa amin Support page: Bisitahin ang cathopic.com/support at punan ang contact form. Email (kung ibinigay): Ipadala ang mga detalye nang direkta sa developer support email na nakalista sa iyong API dashboard. Impormasyong isasama Tulungan kaming matulungan ka nang mas mabilis sa pamamagitan ng pagbibigay ng: 1. Malinaw na paglalarawan ng problema Ano ang sinusubukan mong gawin Ano ang nangyayari kumpara sa inaasahan mo Kailan nagsimula ang isyu 2. Mga teknikal na detalye Programming language at framework HTTP library o SDK na ginagamit mo Huling 4 na digit ng iyong API key Mga mensahe ng error (buong teksto) Mga HTTP status code 3. Halimbawa ng code (na-sanitize) // Alisin ang iyong buong API key! const response = await fetch('https://api.cathopic.com/resources', { method: 'POST', headers: { 'x-api-key': '••••1234', // Huling 4 na digit lang 'Content-Type': 'application/json' }, body: JSON.stringify({ query: 'test' }) }); console.log(response.status); // 401 console.log(await response.json()); // {"error": "Unauthorized"} 4. Mga detalye ng request/tugon Request headers Request body Response status Response body Oras (timestamp) ng isyu Bago makipag-ugnayan sa support Subukan muna ito para makatipid ng oras: Tingnan ang API documentation Suriin ang mga tanong sa seksyong ito ng help Subukan gamit ang curl para matukoy ang isyu I-verify na aktibo ang iyong API key sa Settings → API Tiyaking wasto ang iyong paraan ng pagbabayad Oras ng pagtugon Layunin naming tumugon sa mga katanungan sa developer support sa loob ng 24-48 oras sa mga araw ng negosyo. Ang mga komplikadong isyu ay maaaring mangailangan ng karagdagang oras ng pag-iimbestiga. Para sa mga agarang isyu Kung nakakaranas ka ng kritikal na production outage: Markahan ang iyong support request bilang "Urgent" Ibigay ang email ng iyong account para sa priority identification Isama ang mga detalye ng epekto (bilang ng mga user na apektado, epekto sa kita, atbp.) API status Bago mag-ulat ng outage, tingnan kung may kilalang isyu: Subukan ang basic connectivity: curl https://api.cathopic.com/resources Tingnan ang aming status page (kung available) Maghanap ng mga anunsyo sa iyong account dashboard Mga karagdagang resources Buong API documentation: api.cathopic.com/docs Account dashboard: cathopic.com/settings/api General support: cathopic.com/support Impormasyon sa lisensya: cathopic.com/legal/license Nandito kami para tulungan kang maging matagumpay ang iyong integration!

Developer / API

Pagsisimula

Mga API key, pagsingil at seguridad

Katalog, paghahanap at paglilisensya

Mga application sa OAuth

Mga nakakonektang app

Pag-troubleshoot