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
- Registreer het bureau onder de eigen juridische naam. → Zo registreert u zich
- 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.
- 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
- 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.
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
- Log in op het Advertentieportaal als Organisatiebeheerder of Ontwikkelaar.
- Kies Testmodus of Live met de schakelaar boven aan de pagina.
- Ga naar API-sleutels → Nieuwe sleutel maken, geef de sleutel een naam en eventueel een vervaldatum.
- 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.
