BlizPromo Docs
Register product metadata, generate reviewable marketing copy, approve it in the CMS, and publish SEO-ready product pages.
OpenAPI
Machine-readable API contract.
CMS
Review, edit, approve and publish content.
Catalog
Public product pages.
Product API
| Method | Path | Purpose |
|---|---|---|
| POST | /api/v1/products | Create or idempotently update a product by externalId. |
| GET | /api/v1/products | List products visible to the API key. |
| GET | /api/v1/products/{id} | Read one product and its locale page states. |
| PATCH | /api/v1/products/{id} | Update product metadata and asset URLs. |
| POST | /api/v1/products/{id}/generate | Generate AI draft page content for supported locales. |
| POST | /api/v1/products/{id}/publish | Publish approved content and revalidate public pages. |
| POST | /api/v1/products/{id}/unpublish | Move a product back to review state. |
| POST | /api/v1/analytics/events | Record page view, CTA click, or custom analytics events without storing IP or user-agent. |
Authentication
API routes use Authorization: Bearer API_KEY. CMS routes use BlizSSO OAuth2 Authorization Code + PKCE and a signed CMS session cookie.