BlizPromo dokumentation
Registrer produktmetadata, generer marketingtekst til gennemgang, godkend den i CMS'et, og publicer SEO-klare produktsider.
OpenAPI
Maskinlæsbar API-kontrakt.
CMS
Gennemgå, rediger, godkend og publicer indhold.
Katalog
Offentlige produktsider.
Produkt-API
| Metode | Sti | Formål |
|---|---|---|
| POST | /api/v1/products | Opret eller opdater idempotent et produkt via externalId. |
| GET | /api/v1/products | List produkter, der er synlige for API-nøglen. |
| GET | /api/v1/products/{id} | Læs et produkt og dets sidestatus for hvert sprog. |
| PATCH | /api/v1/products/{id} | Opdater produktmetadata og asset-URL'er. |
| POST | /api/v1/products/{id}/generate | Generer AI-kladder til produktsider for understøttede sprog. |
| POST | /api/v1/products/{id}/publish | Publicer godkendt indhold og genvalider offentlige sider. |
| POST | /api/v1/products/{id}/unpublish | Flyt et produkt tilbage til review-status. |
| POST | /api/v1/analytics/events | Registrer sidevisninger, CTA-klik eller egne analyseevents uden at gemme IP eller user-agent. |
Autentificering
API-ruter bruger Authorization: Bearer API_KEY. CMS-ruter bruger BlizSSO OAuth2 Authorization Code + PKCE og en signeret CMS-sessioncookie.
Send gode produktdata
Marketingtekst er kun så god som de data, du sender. Hver USP (benefits[]) skal have et konkret outcome eller navngivne capabilities — et navn med en vag tagline alene afvises (422). Tilføj en valueProposition for produktet, og beskriv for hver USP problemet, resultatet, hvem det er til, og de reelle capabilities ved navn. Undgå fyldord som 'med fire funktioner' eller 'styrk engagement'. Opret-svaret returnerer inputQuality.warnings, så du kan se tynde data.
Godt
{ "name": "Investor Portal", "outcome": "Investorer henter selv live porteføljedata i stedet for at maile efter opdateringer", "capabilities": ["live NAV", "dokumentarkiv", "capital-call tracking", "in-app-beskeder"], "audience": "IR-teams" }For vagt
{ "name": "Investor Portal", "tagline": "et dashboard med fire funktioner, der styrker engagement og gennemsigtighed" }