W skrócie: agencja rejestruje się raz, pod własną nazwą prawną. Reklamuje swoich klientów, wpisując nazwę każdego z nich w polu Nazwa wyświetlana użytkownikom. Agencja płaci, ma salda i otrzymuje faktury. Programiści mogą tworzyć oferty i wydarzenia oraz zarządzać nimi za pomocą REST API Agilis (https://ads.agilis.dating). Potrzebują do tego kluczy API z Portalu reklamowego. Klucze testowe są bezpłatne, a treści utworzone za ich pomocą nigdy nie są wyświetlane użytkownikom.
Dla agencji
- Proszę zarejestrować agencję pod jej własną nazwą prawną. → Jak się zarejestrować
- Tworząc ofertę lub wydarzenie, proszę wpisać nazwę klienta w polu Nazwa wyświetlana użytkownikom. Użytkownicy widzą nazwę klienta, a nie Państwa.
- Do reklamowania każdego klienta potrzebują Państwo jego upoważnienia. Zgodnie z Regulaminem reklamowym odpowiada za to agencja.
Kto płaci i kto otrzymuje faktury
- Płatności dokonuje konto Państwa agencji, w walucie rozliczeniowej agencji.
- Każda osoba w Państwa agencji ma własne saldo i płaci z niego. Saldo organizacji to suma tych sald. → Jak działają salda
- Faktury i wyniki są na nazwę Państwa agencji. Za każdą płatność wystawiana jest jedna faktura, dzięki czemu mogą Państwo refakturować koszty na każdego klienta.
- Aby rozdzielić wydatki poszczególnych klientów, proszę tworzyć osobną ofertę lub osobne wydarzenie dla każdego klienta. Koszty można wtedy refakturować na podstawie odpowiedniej faktury.
Role w zespole
Administratorzy organizacji i Reklamodawcy pracują w Portalu reklamowym, a Programiści przez API. Programiści nie mogą tworzyć ofert ani wydarzeń w Portalu reklamowym. Za pomocą swoich kluczy API mogą jednak tworzyć je, publikować i opłacać przez API. Za sposób korzystania z kluczy odpowiada Państwa firma. Pełna tabela znajduje się w sekcji Role w zespole i uprawnienia.
REST API Agilis
- Adres bazowy: https://ads.agilis.dating
- Dokumentacja: www.agilis.dating/api-doc, z przykładami w cURL, Python, Node.js i PHP oraz z asystentem API
- Do odczytu maszynowego: OpenAPI 3.1 pod adresem www.agilis.dating/openapi.json, Markdown pod adresem www.agilis.dating/api-doc.md oraz pełny tekst dla narzędzi AI pod adresem www.agilis.dating/llms-full.txt
- Oferty: pobieranie listy kategorii i zainteresowań; wycena oferty przed jej utworzeniem; tworzenie, wyświetlanie listy, wstrzymywanie, wznawianie i usuwanie ofert; odczyt wyników każdej oferty
- Wydarzenia: podgląd, publikacja, wyświetlanie listy, edycja, zmiana terminu, odwoływanie i usuwanie wydarzeń; odczyt wyników każdego wydarzenia
Jak uzyskać klucz API
- Proszę zalogować się do Portalu reklamowego jako Administrator organizacji lub Programista.
- Proszę wybrać Tryb testowy lub tryb rzeczywisty za pomocą przełącznika u góry strony.
- Proszę przejść do sekcji Klucze API → Utwórz nowy klucz i nadać kluczowi nazwę. W razie potrzeby można też ustawić datę wygaśnięcia.
- Proszę od razu skopiować klucz. Później nie będzie można go ponownie wyświetlić.
Klucze testowe zaczynają się od pk_test_, a klucze rzeczywiste od pk_live_. Każda osoba może mieć do 10 kluczy w każdym trybie. Wymień klucz natychmiast zastępuje klucz, dlatego najpierw proszę zaktualizować swoje systemy. Klucz należy przesyłać w nagłówku żądania x-api-key: x-api-key: pk_test_….
Bezpieczna integracja
- Integrację najlepiej tworzyć i testować z kluczem
pk_test_. Testowe oferty i wydarzenia są bezpłatne i nigdy nie są wyświetlane użytkownikom. - Przed utworzeniem oferty proszę ją wycenić za pomocą punktu końcowego do szacowania ceny.
- Proszę nie umieszczać kluczy w repozytoriach kodu ani w przeglądarkach. API należy wywoływać z własnego serwera.
Pytania
Czy agencja może obsługiwać kilku klientów z jednego konta?
Tak. Wystarczy raz zarejestrować agencję i podawać nazwę klienta w każdej ofercie lub każdym wydarzeniu.
Czy każdy klient może mieć własną fakturę?
Faktury są wystawiane na Państwa agencję, jedna za każdą płatność. Na ich podstawie mogą Państwo refakturować koszty na klientów.
Czy jest dostępne środowisko testowe?
Tak. Tryb testowy z kluczami pk_test_ to pełne środowisko testowe. Nie są naliczane żadne opłaty i nic nie jest wyświetlane użytkownikom.
Czy mogę podłączyć narzędzia AI do programowania?
Tak. Wystarczy wskazać narzędziu adres www.agilis.dating/api-doc.md lub www.agilis.dating/openapi.json.
