Revizija prihoda izdavača preko API-ja

Pokrenite javne provere prihoda izdavača, preuzmite Sulvo izveštaje i upravljajte odobrenim inventarom izdavača kroz isti API koji koriste CLI i MCP server.

Hostovana osnovna URL adresa

https://publisher-revenue-audit.sulvo.com/v1/publisher-revenue-auditsPodešavanje CLI-ja i MCP-a

Osnove

Osnovni URL-ovi

Javna krajnja tačka za reviziju namerno ne zahteva autentifikaciju. Za Sulvo izveštaje naloga i pozive koji se odnose na inventar potreban je API ključ generisan na kontrolnoj tabli.

Javni API za reviziju

POST

https://publisher-revenue-audit.sulvo.com/v1/publisher-revenue-audits

Sulvo API za naloge

API ključ Bearer formata

https://surge.sulvo.com/api

Hostovana MCP krajnja tačka

MCP

https://publisher-revenue-audit.sulvo.com/mcp

Javna krajnja tačka

Pokrenite reviziju prihoda

Koristite ovu krajnju tačku za orijentacionu proveru javno dostupnih dokaza o domenu izdavača. Odgovor nije dokaz gubitka prihoda niti garantovanog povećanja. Proverite nalaze pomoću izveštaja izdavača.

cURL

curl -X POST https://publisher-revenue-audit.sulvo.com/v1/publisher-revenue-audits \
  -H "content-type: application/json" \
  -d '{
    "tool": "run_publisher_revenue_audit",
    "input": {
      "domain": "example.com",
      "vertical": "news",
      "options": {
        "format": "json",
        "compact": true,
        "maxPages": 2,
        "enablePageSpeed": true
      }
    }
  }'

Polje	Napomene
input.domain	Obavezno. Domen izdavača ili javni host. Goli domeni automatski se pretvaraju u HTTPS. Privatni ciljevi, gole IP adrese, interni hostovi i nestandardni portovi se odbijaju.
input.vertical	Opciono. Prihvata news, sports, entertainment, technology, education, gaming ili other.
input.metrics	Opciono. Kontekst sa kontrolne table koji navodi izdavač, na primer stopa popunjenosti, vidljivost oglasa, prosečan CPM, prihod po sesiji, mesečni pregledi stranica ili broj mesečnih sesija.
input.options	Opciono. Kontrole izlaznog formata i prikupljanja, uključujući format, compact, maxPages, includeEvidence, enableBrowser, includeScreenshots, enablePageSpeed, pageSpeedStrategy, concurrency, whiteLabel i partnerId.

Autentifikacija

Za API-je naloga koristite Sulvo API ključ

Generišite API ključ u podešavanjima naloga na Sulvo kontrolnoj tabli. Šaljite ga kao Bearer token u zahtevima za Sulvo API naloga.

Zaglavlje Authorization

Authorization: Bearer $SULVO_API_KEY

reports:read

Potrebno za izvoz izveštaja i prikaz sačuvanih izveštaja.

reports:write

Potrebno za kreiranje, ažuriranje, pokretanje ili brisanje naprednih izveštaja.

inventory:write

Potrebno za kreiranje i brisanje oglasnih jedinica. Nalog mora biti odobren i posedovati inventar.

Izveštaji

Čitanje krajnjih tačaka za izveštaje

Za čitanje izveštaja šalju se GET zahtevi prema osnovnoj adresi Sulvo API-ja za naloge. Datumi bez vremena tumače se kao celodnevni intervali po UTC-u.

Zahtev za izveštaj

curl "https://surge.sulvo.com/api/v1/reports/by-date?start=2026-06-01&end=2026-06-07&domains=example.com" \
  -H "authorization: Bearer $SULVO_API_KEY" \
  -H "accept: application/json"

Method	Path	Notes
GET	/api/v1/reports/by-date	Dnevni pregled učinka. Podržava filtere za datum, domen, ad root i provajdera.
GET	/api/v1/reports/by-date-and-ad-unit	Dnevni učinak grupisan po oglasnoj jedinici.
GET	/api/v1/reports/by-domain-and-ad-unit	Pregled učinka po domenu i oglasnoj jedinici.
GET	/api/v1/reports/bot-filtering	Izveštaj o filtriranju botova za procenu kvaliteta saobraćaja naloga.
GET	/api/v1/reports/bot-scores	Izveštavanje o ocenama botova po datumu i povezanim dimenzijama.
GET	/api/v1/reports/invalid-activity	Izveštavanje o nevažećim aktivnostima. Nisu potrebni uobičajeni upiti za datum ili domen.
GET	/api/v1/reports/direct-bidder-analysis	Izveštaj o direktnom ponuđaču. Zahteva directBidder, a može da sadrži start/end.
GET	/api/v1/inventory/ad-units-by-domain	Inventar oglasnih jedinica grupisan po domenu.

Uobičajeni parametri upita: start, end, ponovljivi domains, ponovljivi adRoots i adProvider. Analiza direktnog ponuđača zahteva i directBidder.

Napredni izveštaji

Kreirajte zakazane izveštaje ili ih odmah pošaljite e-poštom

Napredni izveštaji mogu da se pokrenu odmah ili periodično prema rasporedu. Šalju se e-poštom, a ne kao sadržaj odgovora.

Sačuvajte napredni izveštaj

curl -X POST https://surge.sulvo.com/api/v2/reports/save-advanced-report \
  -H "authorization: Bearer $SULVO_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "reportType": "dimensions",
    "toAddress": "publisher@example.com",
    "immediateRun": true,
    "domains": ["example.com"],
    "dimensions": ["country", "device"],
    "start": "2026-06-01",
    "end": "2026-06-07"
  }'

Method	Path	Notes
GET	/api/v2/reports/advanced-reports	Prikažite sačuvane napredne izveštaje za autentifikovani nalog.
POST	/api/v2/reports/save-advanced-report	Kreirajte ili ažurirajte napredni izveštaj. Zahteva reportType, toAddress, immediateRun i najmanje jedan cilj naveden u adRoots ili domains.
DELETE	/api/v2/reports/delete-advanced-report/{reportId}	Obrišite sačuvani napredni izveštaj pomoću polja id.

Vrste izveštaja

adUnit, dimensions, customData

Dimenzije

country, device, os

Učestalost

daily, weekly, biweekly, monthly

Inventar

Kreirajte i brišite odobrene oglasne jedinice

Za izmene inventara potreban je odobren Sulvo nalog i API ključ koji je generisao vlasnik, sa opsegom inventory:write.

Kreirajte oglasnu jedinicu

curl -X PUT https://surge.sulvo.com/api/v2/inventory/unit \
  -H "authorization: Bearer $SULVO_API_KEY" \
  -H "content-type: application/json" \
  -d '{
    "domain": "example.com",
    "type": "display",
    "size": { "width": 300, "height": 250 }
  }'

Method	Path	Notes
PUT	/api/v2/inventory/unit	Kreirajte jednu oglasnu jedinicu pomoću polja domain, type, placement, custom name i focusedAd, uz opciono polje size.
PUT	/api/v2/inventory/interstitial-units	Kreirajte interstitial jedinice za računar, mobilne uređaje ili obe vrste za jedan domen.
PUT	/api/v2/inventory/auto-sticky-units	Kreirajte sticky display jedinice, sticky mobilne jedinice ili obe vrste za jedan domen.
DELETE	/api/v2/inventory/unit/{adId}	Obrišite oglasnu jedinicu u vlasništvu autentifikovanog naloga.

Podržani tipovi oglasnih jedinica

displaynative_multisticky_displaysticky_mobilesticky_display_customsticky_mobile_customsticky_videointerstitial_desktopinterstitial_mobileofferwall

Greške

Obrada grešaka

Odgovori revizije koji nisu 2xx i greške Sulvo API-ja za naloge vraćaju JSON sadržaj namenjen agentima i CLI klijentima.

401

API ključ nedostaje, nije važeći ili je istekao za API pozive naloga. Za javnu krajnju tačku revizije ključ nije potreban.

403

Autentifikacija ključa je uspela, ali mu nedostaje potreban opseg, nalog nije odobren ili resurs pripada drugom nalogu.

503 / 504

Javna usluga za reviziju je preopterećena ili je isteklo vreme za reviziju. Pokušajte ponovo kasnije i poštujte Retry-After ako je naveden.

Struktura odgovora sa greškom revizije

{
  "error": {
    "code": "audit_capacity_exceeded",
    "message": "Audit capacity is currently exhausted. Retry later."
  }
}

Više vam odgovara klijent spreman za korišćenje?

Paket npm i podešavanje MCP-a pozivaju ove krajnje tačke umesto vas i omogućavaju kompatibilnim AI klijentima da koriste iste tokove rada za reviziju, izveštaje i inventar.

Pogledajte podešavanje