API i integracje

API agencji castingowej do castingów i formularzy na twojej stronie

Pokazuj otwarte castingi na stronie agencji, przyjmuj zgłoszenia przez własny formularz i pobieraj bazę aktorów do CRM — przez REST API z odpowiedziami w JSON. Token wydajesz w ustawieniach agencji, a gotowe biblioteki dla PHP i Pythona skracają integrację do kilku linii.

  • Castingi, pola formularza, zgłoszenia i baza aktorów
  • Zgłoszenia z API trafiają na tę samą listę co ze strony
  • Biblioteki dla PHP i Pythona bez zależności

Darmowy plan bez limitu czasu, bez karty.

API agencji castingowej do castingów i formularzy na twojej stronie

Strona agencji i castingi zwykle żyją osobno

Podwójna publikacja

Rola jest publikowana w systemie, a potem jeszcze raz ręcznie na stronie agencji.

Casting opublikowany w panelu od razu pojawia się w API i na twojej stronie.

Własny formularz — własna skrzynka

Formularz na stronie wysyła maile, a ktoś przepisuje je ręcznie do bazy.

Zgłoszenie z twojego formularza trafia przez API na listę castingu razem ze zdjęciami i wideo.

Zamknięte dane

Aktorzy agencji są w bazie, ale nie ma jak pokazać ich w katalogu na stronie ani w CRM.

API udostępnia profile z bazy agencji do katalogu na stronie albo synchronizacji z CRM.

Castingi agencji na Twojej stronie

Lista opublikowanych castingów, strona roli i zestaw pól jej formularza — wszystko, by pokazać otwarte role w wyglądzie Twojej strony. Gdy publikujesz casting w panelu, pojawia się on też w API.

  • Stronicowane listy o przewidywalnej strukturze odpowiedzi
  • Pola formularza przychodzą z wymaganiami: obowiązkowość, limity zdjęć
Castingi agencji na Twojej stronie

Zgłoszenia przez własny formularz

Wysyłaj zgłoszenie aktora ze swojej strony do castingu — ze zdjęciami i wideo. Przechodzi te same sprawdzenia co formularz na stronie castingu i trafia na wspólną listę zgłoszeń z powiadomieniem dla reżysera castingu.

  • Błędy walidacji wracają dla każdego pola
  • Ponowne zgłoszenie tego samego aktora jest rozpoznawane
Zgłoszenia przez własny formularz

Baza aktorów do katalogu i CRM

Pobieraj profile z prywatnej bazy agencji, by pokazać katalog na stronie lub synchronizować go z CRM. Kontakty aktorów domyślnie nie są zwracane — trzeba o nie poprosić jawnie.

  • Tylko aktorzy Twojej agencji, bez cudzych danych
  • Zgłoszenia na castingi również można pobierać
Baza aktorów do katalogu i CRM

Gotowe biblioteki dla PHP i Pythona

Jeden plik bez zależności: połączenie, stronicowanie list, przesyłanie plików i czytelne wyjątki — zły token, błędy pól, zduplikowane zgłoszenie, przekroczony limit zapytań.

  • PHP 8.1+ i Python 3.9+
  • Opis każdej metody w dokumentacji
Gotowe biblioteki dla PHP i Pythona

Jak podłączyć

  1. 1

    Wydaj token

    Zakładka API w ustawieniach agencji.

  2. 2

    Pobierz bibliotekę

    PHP lub Python — albo wywołuj REST API bezpośrednio.

  3. 3

    Pokaż castingi

    Role i formularz w wyglądzie Twojej strony.

  4. 4

    Przyjmuj zgłoszenia

    Trafią do panelu razem z pozostałymi.

Najczęstsze pytania

Skąd wziąć token?

Właściciel agencji wydaje go w zakładce API w ustawieniach agencji. Tam też token można wygenerować ponownie lub unieważnić — stary od razu przestaje działać.

Czy przez API widać dane innych agencji?

Nie. Każde zapytanie jest ograniczone do agencji właściciela tokenu, a cudze castingi, zgłoszenia i profile dla niego nie istnieją.

Czy API zwraca kontakty aktorów?

Tylko jeśli poprosisz o nie jawnie. Domyślnie profile przychodzą bez telefonów i adresów e-mail.

Czy jest limit zapytań?

Tak, określona liczba zapytań na minutę na token. Aktualna wartość jest w dokumentacji, a po jej przekroczeniu API podaje, jak długo poczekać.

Czy da się obejść bez programisty?

W prostym przypadku tak. W ustawieniach agencji jest gotowy widżet: jeden fragment kodu osadza castingi z formularzem na stronie. API przyda się do własnego projektu albo integracji z CRM.

Z bloga

Inne funkcje

Podłącz castingi do swojej strony

Utwórz agencję za darmo, wydaj token i wyślij pierwsze zapytanie.

Zacznij za darmo

Darmowy plan bez limitu czasu, bez karty.