# Almani.center Open API

> Almani.center Open API lets customers manage connected commerce sites, sender profiles, Kakao message templates, campaigns, product filters, and delivery analytics. The API uses JSON over HTTPS and is documented primarily in Korean.

Base URL: `https://docs.almani-center.com/open/v1`

Use `Authorization: Bearer <API_KEY>` on every request. Call `GET /sites` first, then send the selected site ID in `X-Site-Id` on site-scoped requests. Never expose, log, or place a real API key in generated source code.

For write requests, read the current resource first. Send its `revision` in `If-Match` where required and use a unique `Idempotency-Key`. Never invent a site ID, campaign ID, product ID, variant ID, template code, cursor, or revision.

Successful responses use `code: "0000"`. On errors, inspect the HTTP status, `code`, `message`, and `meta.requestId`. The HTML API reference is the source of truth when this file and a reference page differ.

## Start Here

- [LLM-ready full API guide](https://docs.almani-center.com/llms-full.txt): Consolidated instructions, endpoint catalog, safe workflows, and request examples for coding agents.
- [Quickstart](https://docs.almani-center.com/guides/quickstart.html): First API calls and authentication walkthrough.
- [Common API rules](https://docs.almani-center.com/reference/index.html): Authentication, response envelope, errors, rate limits, cursors, revisions, and idempotency.
- [Sites](https://docs.almani-center.com/reference/sites.html): Discover site IDs before using site-scoped APIs.
- [Account and quota](https://docs.almani-center.com/reference/account.html): Verify the API key, scopes, plan, expiration, quota, and points.

## API Reference

- [Products](https://docs.almani-center.com/reference/products.html): Search products and retrieve option/variant IDs used by campaign filters.
- [Campaigns](https://docs.almani-center.com/reference/campaigns.html): Create inactive campaigns from approved templates; list and inspect campaigns; update status, title/settings, template, and product filters.
- [Templates](https://docs.almani-center.com/reference/templates.html): Validate, create, list, inspect, rename, submit, cancel, delete eligible REG drafts, and review template history.
- [Sender profiles](https://docs.almani-center.com/reference/sender-profile.html): Read a sender profile and complete sender-profile registration.
- [Send results](https://docs.almani-center.com/reference/send-results.html): Read delivery, open, click, daily campaign performance, exact hourly delivery counts, and per-button click metrics.

## Guides

- [Personalization variables](https://docs.almani-center.com/guides/personalization.html): Template variables and mapping guidance.
- [Template review guide](https://docs.almani-center.com/guides/template-review.html): Kakao template policy and review workflow.
- [Campaign operations guide](https://docs.almani-center.com/guides/campaign-operations.html): Operating and checking campaigns safely.
- [Sender-profile guide](https://docs.almani-center.com/guides/sender-profile.html): Console-based sender-profile setup.

## Optional

- [Almani.center Docs](https://docs.almani-center.com/index.html): Human-readable documentation home.
- [Almani.center usage guides](https://docs.almani-center.com/guides/index.html): Console and platform connection guides.