Paano sinisingil ang paggamit ng API?

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

1. Nagpapasya ang end user na gamitin ang nilalaman nang walang watermark

2. 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

3. Ibinabalik ng API ang mga permanenteng URL para sa nilalamang walang watermark

4. Nagsisimula agad ang pagsingil mula sa sandaling ito

5. 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

1. Inaalis o ititigil ng end user ang paggamit ng nilalaman

2. Ang iyong application ay tumatawag ng POST /remove na may:

   • media_id: Ang identifier ng nilalaman

   • client_identifier: ID ng end user

3. Humihinto ang pagsingil para sa partikular na paggamit na iyon

4. 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:

1. Pumunta sa Settings → API

2. Tingnan ang seksyong "On-demand usage"

3. Tingnan ang kasalukuyang mga istatistika ng billing period:

   • Kabuuang halaga na naipon hanggang ngayon

   • Bilang ng mga website uses

   • Bilang ng mga email uses

4. 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

5. 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:

1. Bisitahin ang aming pahina ng suporta

2. Piliin ang "API access request"

3. Ilarawan ang iyong integration at inaasahang paggamit

4. 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.