# Agencje, zespoły i API

Jak agencje reklamują klientów w Agilis pod ich nazwami, jak działają role w zespole, salda i faktury oraz jak korzystać z REST API Agilis.

**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

1. **Proszę zarejestrować agencję** pod jej własną nazwą prawną. → [Jak się zarejestrować](https://www.agilis.dating/pl/business/guide/register)
2. 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.
3. 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](https://www.agilis.dating/pl/business/guide/pricing)
- 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](https://www.agilis.dating/pl/business/guide/getting-started).

## 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

1. Proszę zalogować się do Portalu reklamowego jako Administrator organizacji lub Programista.
2. Proszę wybrać **Tryb testowy** lub tryb rzeczywisty za pomocą przełącznika u góry strony.
3. 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.
4. **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.

Source: https://www.agilis.dating/pl/business/guide/agencies-and-api