Adgora
Deweloperzy

Dokumentacja API

REST API v1: uwierzytelnianie, statystyki, kampanie, saldo i strefy, plus postbacki konwersji S2S i makra.

1 min czytania 207 słów
Artykuły pomocyDokumentacja API

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}
Kreator zapytań

Zbuduj zapytanie

Wybierz punkt końcowy i parametry — polecenie aktualizuje się na bieżąco. Klucze pozostają jako miejsca: nigdy nie wklejaj sekretu na stronę internetową.

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

PUBLICKEY:SECRET to miejsce na klucz. Utwórz klucz w swoim profilu i przechowuj sekret na swoim serwerze.

Wsparcie

Wciąż utknąłeś? Osoba odpowie

Biuro wsparcia zajmuje się kampaniami, stronami, wpłatami i wypłatami. Napisz z adresu e-mail swojego konta; w przypadku płatności dodaj hash transakcji — to oszczędza rundę pytań.

  1. Napisz z adresu e-mail swojego konta
  2. Nazwij kampanię, witrynę lub identyfikator strefy
  3. Aby dokonać płatności, dodaj hash transakcji

Darmowe narzędzia

Kalkulatory i narzędzia działające w Twojej przeglądarce — bez konta.

Dowiedz się więcej

Słownik

Proste definicje CPM, eCPM, wskaźnika wypełnienia i innych.

Dowiedz się więcej

Gotowy do rozpoczęcia?

Utwórz darmowe konto i wprowadź to w życie — reklamodawca, wydawca lub obie opcje.

What this page answers