# Bureaus, teams en de API

Hoe bureaus voor klanten adverteren op Agilis onder hun naam, hoe rollen, tegoeden en facturen werken, en hoe u de Agilis REST API gebruikt.

**In het kort:** een bureau registreert zich één keer, onder de eigen juridische naam, en adverteert voor klanten door bij elke advertentie de naam van de klant in te vullen bij **Weergavenaam voor leden**. Het bureau betaalt, beheert de tegoeden en ontvangt de facturen. Ontwikkelaars kunnen aanbiedingen en evenementen maken en beheren via de **Agilis REST API** (https://ads.agilis.dating) met API-sleutels uit het Advertentieportaal; testsleutels zijn gratis en worden nooit aan leden getoond.

## Voor bureaus

1. **Registreer het bureau** onder de eigen juridische naam. → [Zo registreert u zich](https://www.agilis.dating/nl/business/guide/register)
2. Vul bij het maken van een aanbieding of evenement de **naam van uw klant** in bij **Weergavenaam voor leden**. Leden zien de naam van de klant, niet die van u.
3. U moet door elke klant gemachtigd zijn om namens hen te adverteren. Volgens de Advertentievoorwaarden is het bureau hiervoor verantwoordelijk.

**Wie betaalt en wie ontvangt de factuur**

- Het account van uw bureau betaalt, in de factuurvaluta van uw bureau.
- Iedere medewerker van uw bureau heeft een eigen tegoed en betaalt daaruit. Het Organisatietegoed is het totaal. → [Zo werken tegoeden](https://www.agilis.dating/nl/business/guide/pricing)
- Facturen en resultaten staan op naam van uw bureau, één factuur per betaling, zodat u elke klant kunt doorbelasten.
- Wilt u de uitgaven per klant gescheiden houden, gebruik dan per klant een aparte aanbieding of een apart evenement en belast door op basis van de bijbehorende factuur.

## Teamrollen

Organisatiebeheerders en Adverteerders werken in het Advertentieportaal; Ontwikkelaars werken via de API. Ontwikkelaars kunnen geen aanbiedingen of evenementen maken in het Advertentieportaal, maar met hun API-sleutels kunnen ze die via de API wel maken, publiceren en betalen. Uw bedrijf is verantwoordelijk voor het gebruik van de eigen sleutels. Het volledige overzicht staat in [Teamrollen en rechten](https://www.agilis.dating/nl/business/guide/getting-started).

## De Agilis REST API

- **Basis-URL:** https://ads.agilis.dating
- **Documentatie:** www.agilis.dating/api-doc, met voorbeelden in cURL, Python, Node.js en PHP, en een API-assistent
- **Machineleesbaar:** OpenAPI 3.1 op www.agilis.dating/openapi.json, Markdown op www.agilis.dating/api-doc.md en de volledige tekst voor AI-tools op www.agilis.dating/llms-full.txt
- **Aanbiedingen:** uw categorieën en de interesses opvragen; de prijs van een aanbieding berekenen voordat u die maakt; aanbiedingen maken, opvragen, pauzeren, hervatten en verwijderen; de resultaten van elke aanbieding bekijken
- **Evenementen:** evenementen bekijken als voorbeeld, publiceren, opvragen, bewerken, verplaatsen, annuleren en verwijderen; de resultaten van elk evenement bekijken

### Een API-sleutel aanvragen

1. Log in op het Advertentieportaal als Organisatiebeheerder of Ontwikkelaar.
2. Kies **Testmodus** of Live met de schakelaar boven aan de pagina.
3. Ga naar **API-sleutels** → **Nieuwe sleutel maken**, geef de sleutel een naam en eventueel een vervaldatum.
4. **Kopieer de sleutel meteen.** U kunt hem daarna niet meer bekijken.

Testsleutels beginnen met `pk_test_`; livesleutels beginnen met `pk_live_`. Iedere persoon kan per modus maximaal 10 sleutels hebben. **Vernieuwen** vervangt een sleutel direct, dus werk eerst uw systemen bij. Stuur de sleutel mee in de request-header `x-api-key`: `x-api-key: pk_test_…`.

### Veilig ontwikkelen

- Ontwikkel en test met een `pk_test_`-sleutel: testaanbiedingen en testevenementen zijn gratis en worden nooit aan leden getoond.
- Bereken de prijs van een aanbieding met het prijsschatting-endpoint voordat u die maakt.
- Houd sleutels uit coderepository's en browsers; roep de API aan vanaf uw server.

## Vragen

### Kan een bureau meerdere klanten vanuit één account beheren?

Ja. Registreer het bureau één keer en vermeld de klant bij elke aanbieding of elk evenement.

### Kan elke klant een eigen factuur krijgen?

Facturen worden aan uw bureau uitgereikt, één per betaling. Op basis daarvan kunt u uw klanten doorbelasten.

### Is er een testomgeving?

Ja. De Testmodus, met `pk_test_`-sleutels, is een volledige testomgeving. Er wordt niets in rekening gebracht en niets aan leden getoond.

### Kan ik AI-programmeertools koppelen?

Ja. Verwijs uw tool naar www.agilis.dating/api-doc.md of www.agilis.dating/openapi.json.

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