Jedna reklama API pre váš kód a vašich agentov

REST API v1 a MCP server beží z rovnakého vk live ... kľúč a rovnaký súbor rozsahov: 31 nástrojov pre asistenta a koncových bodov pre kampane, analytika, Meta vedie a pravidlá. Kľúč môže byť vydaný len na čítanie, a každý písať bez jeho rozsahu odpovede 403.

Vytvoriť kľúč API

Prečo integrácia reklamy stojí viac, než sa zdá

Domáci obal na platformu

Google Ads a Meta hovorí rôznymi jazykmi: ich vlastné polia, statusy a limity. Shim napísané pre jednu správu prežíva správu bola napísaná pre.

Asistentka nemá kam zapnúť

Claude alebo ChatGPT môže uvažovať o kampaniach dokonale dobre, ale nemá ani prístup, ani hranice

Kľúč, na ktorý všetci zabudli

Symbol sedí v prostredí premennej bez vypršania, bez rozsahu a chodník: nikto nevie, kto ho používa, alebo čo sa stane v deň, keď unikne.

Tri kroky od kľúča k prvej výzve

  1. Vytvoriť kľúč

    V sekcii vývojárske kľúče, dajte jej názov, zaškrtnite rozsahy, ktoré potrebuje, a voliteľne vypršať v dňoch. Kľúč je zobrazený raz; iba SHA-256 hash je uložený.

  2. Nasmeruj na to klienta.

    REST hovory ísť na /api/v1 s povolením: Nosič, x-api-key alebo apikey hlavička. Asistent sa pripojí k MCP koncový bod /mcp s rovnakým kľúčom.

  3. Práca v rámci rámca kľúča

    Iba udelené rozsahy riešiť: bez kampaní:napísať zápis vracia 403 nedostatočné scope, a kampaň vytvorila týmto spôsobom pozemky ako návrh, nie žiť.

Čo dostane vývojár a čo dostane agent

31 nástrojov MCP

Kampane, analytika, Meta vedie, pravidlá, zdravotné skóre a generovanie kópií, vystavené asistentovi ako bežné nástroje za jedným kľúčom.

REST API v1

Kampaňe s pauzou, obnovovať, výkon a zdravotné skóre, plus analytika, Meta vedie, prehľad účtu a pravidlá automatizácie.

Deväť rozsahov prístupu

kampane, analytika, pravidlá, zdravie, vedenie a i generovať klávesy na palubnej doske sa dajú presne čítať len bez toho, aby ste niekedy otvorili zápis.

Kľúče, ktoré nestratíte stopu

Predpona v zozname, počítadlo žiadostí, posledná použitá časová pečiatka a platnosť; zrušenie jedného vypína naraz cez každú integráciu.

OpenAPI 3.0 špecifikácia

Schema sa podáva na /api/docs/openapi.json s interaktívnymi docs vedľa neho, takže klient je generovaný skôr ako ručne písaný.

Rovnaké bezpečnostné pravidlá

Kampane vytvorené prostredníctvom API alebo MCP prichádzajú ako návrhy, píše vyžaduje rozsah písma, a nič nedosiahne reklamnej platformy na vlastnú pódiu.

V číslach

31
Nástroje MCP dostupné za jedným developerským kľúčom
9
rozsahy prístupu, ktoré možno individuálne udeliť kľúču
100
žiadosti za minútu na kľúč štandardne

Otázky vývojárov

Ako mám dostať Valkiria API kľúč?

V sekcii vývojových kľúčov, stlačte tlačidlo Vytvárať kľúč, dajte mu názov, zaškrtnite rozsahy, ktoré potrebuje a voliteľne nastavte vypršanie platnosti v dňoch. Kľúč formulára vk live ... je zobrazený presne raz; iba jeho SHA-256 hash je uložený. Môžete odvolať kľúč kedykoľvek a zrušenie nadobúda účinnosť okamžite.

Ako sa pripojiť Valkiria do Claude alebo ChatGPT cez MCP?

Server MCP žije na /mcp koncového bodu a hovorí prenos Streamable HTTP. Vo vašom klientovi MCP, poukážte na túto adresu a pridajte autorizáciu: Hlavička Beader s kľúčom vk live .... Asistent potom vidí 31 nástrojov, ale len v rozsahu udeleného do tohto kľúča.

Môže agent UI začať kampaň sám?

Nie. Vytváranie kampane prostredníctvom API alebo MCP vracia návrh skôr ako živú kampaň a odpoveď priamo hovorí, že ľudský krok príde ďalej. Každý písať potrebuje kampaň:napísať rozsah; bez neho hovor vráti 403 nedostatočný scope. Kľúč môže byť vydaný iba na čítanie.

Ktoré koncové ukazovatele API v1 odhaľuje?

Kampaňe: zoznam, čítať, vytvárať, aktualizovať, pauzovať, pokračovať, vymazať, výkon a zdravotné skóre. Analytika: prístrojová doska, míňať, konverzie a generované správy. Meta vedie: vedenie formulárov, vedenie, synchronizácia a požitie. Plus prehľad účtu, zoznam pripojených platforiem, a pravidlá automatizácie so šablónami a históriou.

Existuje limit sadzby?

Predvolené je 100 žiadostí za minútu na kľúč, a hodnota je nastavená pri inštalácii je nakonfigurovaná, takže na vašom vlastnom serveri to môže byť zvýšená. Prechádzanie vracia rýchlosť-limit odpoveď

Sú všetky platformy ad dosiahnuteľné prostredníctvom API?

Kampaň v API patrí do platformy a môže byť vytvorená len tam, kde je už pripojený reklamný účet. inak odpoveď hovorí, že platforma potrebuje pripojenie ako prvý. Samostatné volanie vráti zoznam pripojených platforiem spolu s symbolickým stavom, takže si môžete skontrolovať pred prvým zápisom.

Vydajte svoj prvý kľúč za minútu

Kľúč je vytvorený s rozsahom a vypršaním času, ktorý si vyberiete a zrušíte jedným kliknutím. Začnite čítať iba a rozšírite rozsahy akonáhle sa budete pozerať na jeho správanie.

Začať zadarmo