Jak naliczane jest korzystanie z API?

API Cathopic korzysta z modelu rozliczeń typu „pay-as-you-go”, opartego na rzeczywistym wykorzystaniu treści przez użytkowników końcowych. Wszystkie warunki rozliczeń regulowane są przez nasze Umowę licencyjną dla API.

Dwa modele rozliczeń

Rozliczenia zależą od tego, w jaki sposób użytkownicy końcowi korzystają z treści:

1. Korzystanie z witryny (model Dni użycia)

• Dotyczy sytuacji, gdy treść jest wyświetlana na stronach internetowych, blogach lub w aplikacjach webowych

• Obliczane na podstawie każdego dnia kalendarzowego, w którym użytkownik końcowy uzyskuje dostęp do określonej treści

• Wzór: Łączna liczba Dni użycia × (uzgodniona miesięczna stawka ÷ 30)

• Rozliczanie proporcjonalne w ujęciu dziennym sprawia, że płacisz tylko za rzeczywiste wykorzystanie

• Śledzone osobno dla każdego użytkownika końcowego i dla każdego elementu treści

2. Korzystanie z e-maili (model „Per Email”)

• Dotyczy sytuacji, gdy treść jest włączana do wiadomości e-mail

• Opłata naliczana za wysłaną wiadomość e-mail (nie za odbiorcę)

• Jednorazowe rozliczenie za e-mail, który zawiera treść

• Stawka uzgadniana podczas konfiguracji dostępu do API

Kiedy rozliczenia się zaczynają i kończą

Treść ze znakiem wodnym jest bezpłatna

• Treść początkowo pojawia się ze znakiem wodnym

• Podgląd ze znakiem wodnym nie generuje opłat

• Idealne do umożliwienia użytkownikom końcowym przeglądania treści przed podjęciem decyzji

• Może być używana do testów i celów próbnych

Rozliczenia zaczynają się, gdy usuniesz znak wodny

1. Użytkownik końcowy decyduje się korzystać z treści bez znaku wodnego

2. Twoja aplikacja wywołuje POST /confirm z:

   • media_id: Identyfikator treści

   • usage_type: „website” albo „email”

   • client_identifier: Unikalny identyfikator Twojego użytkownika końcowego

3. API zwraca stałe adresy URL dla treści bez znaku wodnego

4. Rozliczenia rozpoczynają się natychmiast od tej chwili

5. Musisz przechowywać te adresy URL oraz dane o wykorzystaniu do celów śledzenia rozliczeń

Rozliczenia kończą się, gdy treść zostanie usunięta

1. Użytkownik końcowy usuwa treść lub przestaje z niej korzystać

2. Twoja aplikacja wywołuje POST /remove z:

   • media_id: Identyfikator treści

   • client_identifier: Identyfikator użytkownika końcowego

3. Rozliczenia dla tego konkretnego wykorzystania zostają zatrzymane

4. Musisz usunąć adresy URL dla treści bez znaku wodnego z bazy danych

Przykład rozliczeń dla witryny

Załóżmy, że uzgodniłeś miesięczną stawkę za nieograniczone korzystanie z treści:

• Scenariusz: Parafia A wyświetla Obraz #12345 na swojej stronie głównej

• Dzień 1: Wywołujesz /confirm → Rozliczenia się rozpoczynają

• Dni 1-15: Obraz pozostaje na stronie głównej (15 dni użycia)

• Dzień 16: Parafia usuwa obraz, wywołujesz /remove → Rozliczenia się kończą

• Obliczenie: 15 dni × ( ÷ 30 dni) =

• Naliczono: za to konkretne wykorzystanie

Jeśli Parafia B również używa tego samego obrazu przez 10 dni, jest to śledzone osobno i powoduje naliczenie dodatkowych opłat.

Przykład rozliczeń dla e-maila

Załóżmy, że uzgodniłeś stawkę --.05 za e-mail:

• Scenariusz: Ministerstwo wysyła newsletter z Obrazem #67890

• Działanie: Wywołujesz /confirm z usage_type: "email"

• Wynik: Jednorazowa opłata --.05 za ten e-mail

• Odbiorcy: Nie ma znaczenia, czy wiadomość została wysłana do 100 czy 10 000 osób

• Naliczono: --.05 łącznie (nie za odbiorcę)

Miesięczne limity rozliczeń

Twoja umowa może zawierać miesięczne limity rozliczeń:

• Chronią Cię przed niespodziewanie wysokimi rachunkami

• Po osiągnięciu limitu dodatkowe wykorzystanie może być bezpłatne lub naliczane w obniżonej stawce

• Konkretną kwotę limitu uzgadnia się podczas konfiguracji dostępu do API

• Dotyczy łącznych opłat miesięcznych naliczanych za wszystkich użytkowników końcowych

Fakturowanie i płatności

Harmonogram faktur

• Faktury są wystawiane co miesiąc w pierwszych 10 dniach każdego miesiąca

• Obejmuje wszystkie wykorzystania z poprzedniego miesiąca

• Szczegółowe zestawienie wykorzystania według użytkownika końcowego i elementu treści

• Wysyłane na adres e-mail powiązany z Twoim kontem API

Obsługa płatności

• Płatności są przetwarzane wyłącznie przez Stripe

• Automatyczne obciążenie zarejestrowanej metody płatności

• Musisz przez cały czas utrzymywać poprawne informacje o płatnościach

• Potwierdzenia (paragony) są udostępniane automatycznie po udanej płatności

Niepowodzenia płatności

• Jeśli płatność się nie powiedzie, system wykona 4 próby ponowienia

• Otrzymujesz powiadomienia e-mail o problemach z płatnością

• Jeśli wszystkie ponowienia się nie powiodą, dostęp do API zostaje zawieszony

• Dostęp zostaje przywrócony natychmiast po udanej płatności

• Niezapłacone faktury mogą naliczać odsetki

Twoje obowiązki w zakresie śledzenia

Musisz prowadzić dokładne rejestry:

• Dzienniki wykorzystania: Kiedy treść została potwierdzona i usunięta

• Identyfikatory użytkowników końcowych: Którzy użytkownicy uzyskali dostęp do jakiej treści

• Identyfikatory treści: Które elementy multimedialne zostały użyte

• Typy wykorzystania: Witryna vs e-mail dla każdego wykorzystania

• Daty: Data rozpoczęcia i zakończenia korzystania z treści na stronie

• Adresy URL: Przechowywane adresy URL bez znaku wodnego dla aktywnego wykorzystania

Te rejestry są niezbędne do:

• Weryfikowania miesięcznych faktur

• Rozwiązywania sporów dotyczących rozliczeń

• Audytów zgodności przez Cathopic

• Twojego własnego raportowania wewnętrznego

Uzyskiwanie raportów o wykorzystaniu

Możesz śledzić wykorzystanie API w czasie rzeczywistym:

1. Przejdź do Ustawienia → API

2. Zobacz sekcję „On-demand usage”

3. Sprawdź statystyki bieżącego okresu rozliczeniowego:

   • Łączny koszt naliczony do tej pory

   • Liczba użyć w witrynie

   • Liczba użyć e-mail

4. Kliknij „View detailed report”, aby zobaczyć zestawienie według:

   • Użytkownika końcowego (client identifier)

   • Elementu treści

   • Typu wykorzystania

   • Zakresu dat

   • Poszczególnych kosztów

5. Eksportuj raporty do pliku CSV na potrzeby swoich zapisów

Uzgadnianie stawek

Cennik API jest dostosowywany do każdego klienta:

• Stawki są uzgadniane podczas procesu składania wniosku o dostęp do API

• Na podstawie przewidywanej wielkości wykorzystania

• Na podstawie Twojego konkretnego przypadku użycia i typu integracji

• Może obejmować rabaty ilościowe dla aplikacji o wysokim wykorzystaniu

• Limity rozliczeń mogą zostać uzgodnione w celu zapewnienia przewidywalnych kosztów

Aby omówić wycenę:

1. Odwiedź naszą stronę pomocy

2. Wybierz „API access request”

3. Opisz swoją integrację i oczekiwane wykorzystanie

4. Nasz zespół przygotuje dostosowaną wycenę

Zrozumienie pełnej licencji

Rozliczenia to tylko jeden aspekt umowy dotyczącej API. Przejrzyj kompletne warunki:

• Przeczytaj pełną Umowę licencyjną dla API

• Zrozum ograniczenia dotyczące korzystania (tylko treści cyfrowe, bez AI/ML, bez pobierania)

• Znajdź swoje obowiązki w zakresie śledzenia i raportowania

• Przejrzyj postanowienia dotyczące własności intelektualnej i zakończenia umowy

W celu uzyskania szczegółów technicznych dotyczących wdrożenia:

• Zobacz punkty końcowe /confirm i /remove na api.cathopic.com/docs

• Zrozum, jak obliczać wykorzystanie dla Twojej konkretnej integracji

• Przejrzyj najlepsze praktyki dotyczące dokładnego śledzenia rozliczeń

Pamiętaj: Dokładne śledzenie wykorzystania jest Twoim obowiązkiem. Prowadź szczegółowe rejestry, aby zapewnić prawidłowe rozliczenia i zgodność z umową licencyjną.