Domácí obal na plošinu
Google Ads a Meta mluví různými jazyky: jejich vlastní pole, statusy a limity. Shim napsaný pro jednu zprávu přežívá zprávu byla napsána pro.
Jeden reklamní API pro váš kód a vaše agenty
Rest API v1 a MCP server běží od stejného vk _ live _... klíč a stejný soubor skopů:31 nástrojů pro asistenta a koncové body pro kampaně, analytiky, Meta vede a pravidla. Klíč může být vydán pouze pro čtení, a jakýkoli zápis bez jeho rozsahu odpovědi403.
Proč reklamní integrace stojí víc, než se zdá
Asistent nemá kam se připojit.
Claude nebo ChatGPT může o kampaních uvažovat naprosto dobře, ale nemá přístup ani hranice - obvyklá volba je klíčem ke všemu nebo ničemu.
Klíč, na který všichni zapomněli.
Znak sedí v proměnné prostředí bez vypršení, bez rozsahu a bez stopy: nikdo neví, kdo ho používá, nebo co se stane v den, kdy unikne.
Tři kroky od klíče k prvnímu volání
Vytvořit klíč
V sekci vývojářské klávesy, dejte mu jméno, zaškrtněte, co potřebuje, a volitelně vyprší ve dnech. Klíč je zobrazen jednou, pouze SHA-256 hash je uložen.
Namiř na to klienta.
Rest hovory jít do / api / v1 s Autorizací: Nositel, x- api- key nebo apikey hlavička. Asistent se připojí k MCP endpointu / mcp se stejným klíčem.
Pracovat uvnitř mikroskopů klíče
Pouze udělené mikroskopy řešení: bez kampaní: napsat text vrací 403 nedostatečný _ scope, a kampaň vytvořená tímto způsobem země jako návrh, ne žít.
Co dostane developer a co dostane agent
31 MCP nářadí
Kampaň, analytika, Meta vede, pravidla, zdravotní skóre a kopírování generace, vystavený asistentovi jako běžné nástroje za jedním klíčem.
REST API v1
Kampaň s pauzou, životopisem, výkonností a skóre zdraví, plus analytika, Meta vede, přehled účtů a pravidla automatizace.
Devět přístupových dalekohledů
kampaně, analytika, pravidla, zdraví, vedení a ai: generovat - klávesa palubní desky může být přísně read- pouze bez kdy otevřít píše.
Klíče, které neztratíte
Prefix v seznamu, čítač požadavků, poslední použité časové razítko a vypršení platnosti; zrušení jednoho vypne to přes každou integraci najednou.
OpenAPI 3.0 spektrometr
Schéma se podává na / api / docs / openapi.json s interaktivními dokumenty vedle něj, takže klient je generován spíše než ručně psaný.
Stejná bezpečnostní pravidla
Kamery vytvořené prostřednictvím API nebo MCP dorazí jako návrhy, píše vyžadují rozsah zápisu, a nic se dostane na ad platformu sám.
V číslech
- 31
- MCP nástroje k dispozici za jedním vývojářským klíčem
- 9
- přístupové dalekohledy, které mohou být uděleny klíči jednotlivě
- 100
- žádosti za minutu na klíč ve výchozím nastavení
Otázky vývojářů
Jak dostanu Valkiria Klíč API?
V sekci vývojářské klávesy stiskněte klávesu Vytvořit, dejte mu jméno, zaškrtněte si, které potřebuje, a volitelně nastavit vypršení ve dnech. Klíč formuláře vk _ live _... je zobrazen přesně jednou, pouze jeho SHA-256 hash je uložen. Můžete zrušit klíč v každém okamžiku a zrušení nabude účinnosti okamžitě.
Jak se spojím Valkiria do Claude nebo ChatGPT nad MCP?
MCP server žije v / mcp endpointu a hovoří o Streamable HTTP transportu. Ve vašem MCP klientovi, bod na tuto adresu a přidat Autorizaci: Záhlaví nosiče s Vaším vk _ live _... klíč. Asistent pak vidí 31 nástrojů - ale pouze v rámci mikroskopů udělených na tento klíč.
Může agent AI spustit kampaň sám?
Ne. Vytvoření kampaně prostřednictvím API nebo MCP vrací návrh spíše než živý kampaň, a odpověď říká jasně, že lidský krok přichází dál. Každý zápis potřebuje kampaně: psát rozsah, aniž by volání vrátí 403 nedostatečný _ scope. Klíč může být také vydán read- only.
Které koncové body API v1 odhalí?
Kamery: seznam, čtení, vytváření, aktualizace, pauza, obnovit, smazat, výkon a zdravotní skóre. Analytika: palubní deska, utrácení, konverze a generované zprávy. Meta vede: hlavní formy, vedení, synchronizace a pohlcení. Plus přehled účtů, seznam připojených platforem a pravidla automatizace se šablonami a historií.
Je tam limit?
Výchozí je 100 požadavků za minutu na klíč a hodnota je nastavena při konfiguraci instalace, takže na vašem vlastním serveru může být zvýšena. Přejít vrací odpověď rate- limit - klíč sám není zablokován a pracuje v dalším okně.
Jsou všechny reklamní platformy dostupné přes API?
Kampaň v API patří k platformě a lze ji vytvořit pouze tam, kde je již tento reklamní účet připojen - jinak odpověď říká, že platforma potřebuje připojit první. Samostatný hovor vrací seznam připojených platforem spolu s token stavu, takže si můžete zkontrolovat před prvním zadáním.
Vydejte první klíč za minutu.
Klíč je vytvořen s mikroskopy a vypršení si vybrat a zrušit v jednom kliknutí. Začněte číst pouze a rozšiřovat mikroskopy, jakmile jste sledovali, jak se chová.