Adgora
Entwickler

API-Referenz

REST API v1: Authentifizierung, Statistiken, Kampagnen, Guthaben und Zonen, plus S2S-Konversions-Postbacks und Makros.

1 Min. Lesezeit 207 Wörter
HilfeartikelAPI-Referenz

The Adgora REST API lets you read stats, list and pause campaigns, check balances and list zones programmatically. Base URL: https://api.adgora.net. All responses are JSON.

Authentication

Create a key pair in your profile (the secret is shown once). Send it on every /v1 request:

http
Authorization: Bearer {public_key}:{secret}

Requests are rate-limited to 120 per minute per account; over the limit returns 429 with a Retry-After header. Keys carry scopes (stats, campaigns, balance, zones); a missing scope returns 403.

Endpoints

Method & pathScopeReturns
GET /v1/balancebalanceadvertiser & publisher USD balances
GET /v1/stats?days=7statsdaily rows (add role=publisher for the publisher view)
GET /v1/campaignscampaignsyour campaigns
POST /v1/campaigns/{id}/pausecampaignspauses a campaign
POST /v1/campaigns/{id}/resumecampaignsresumes a campaign
GET /v1/zoneszonesyour publisher zones

Example

curl
curl -H "Authorization: Bearer PUBLICKEY:SECRET" \
  "https://api.adgora.net/v1/stats?days=30"

S2S conversion postback

To track CPA conversions, call the postback URL from your advertiser's server when a conversion happens. The {clickid} macro is passed to your landing page on the click URL — capture it and send it back:

url
https://api.adgora.net/s2s?clickid={clickid}&status=confirmed&secret=YOUR_OFFER_SECRET&order_ref=ORDER123

status may be confirmed, delivered, rejected or returned; order_ref is your optional order id. Find the offer secret on the offer page.

Landing URL macros

Add these to a creative's landing URL — Adgora substitutes them at click time:

{ }
{clickid} {zoneid} {campaignid} {creativeid} {geo} {country} {device} {sub1}…{sub5}
Anforderungsbuilder

Eine Anfrage erstellen

Wählen Sie einen Endpunkt und Parameter – der Befehl aktualisiert sich, während Sie fortfahren. Schlüssel bleiben Platzhalter: niemals ein Geheimnis in eine Webseite einfügen.

Rolle
GEThttps://api.adgora.net/v1/balance
curl
curl -H "Authorization: Bearer PUBLICKEY:SECRET" "https://api.adgora.net/v1/balance"

PUBLICKEY:SECRET ist ein Platzhalter. Erstellen Sie einen Schlüssel in Ihrem Profil und bewahren Sie das Geheimnis auf Ihrem Server auf.

Unterstützung

Immer noch festgefahren? Eine Person wird antworten

Der Supportdesk kümmert sich um Kampagnen, Seiten, Einzahlungen und Auszahlungen. Schreiben Sie von Ihrer Kontomail; für eine Zahlung fügen Sie den Transaktionshash hinzu – das spart eine Runde Fragen.

  1. Schreiben Sie von der E-Mail Ihres Kontos
  2. Nennen Sie die Kampagne, die Site oder die Zonen-ID
  3. Fügen Sie für eine Zahlung den Transaktions-Hash hinzu

Kostenlose Werkzeuge

Rechner und Prüfer, die in Ihrem Browser laufen – kein Konto erforderlich.

Mehr erfahren

Glossar

Einfache Definitionen von CPM, eCPM, Auslastungsrate und dem Rest.

Mehr erfahren

Bereit, loszulegen?

Erstellen Sie ein kostenloses Konto und setzen Sie dies in die Praxis um – Werbetreibender, Publisher oder beides.

What this page answers