API баримт

Бүртгэл → Апп холболт хэсэгт брэнд сонгоод token үүсгэнэ. Тэр token-оор тухайн брэндийн төслүүдийн батлагдсан постеруудыг бүх хэмжээ (формат)-аар нь татна. Token нэг л удаа бүтнээрээ харагдана — алдвал цуцлаад шинээр үүсгэнэ.

Token-ыг зөвхөн өөрийн сервер дээр хадгална (browser, мобайл апп-ын кодонд бүү оруул).

Authorization: Bearer urk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
# эсвэл
X-Api-Key: urk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Хариу бүр { success, code, message, data } бүтэцтэй. Жагсаалтад нэмээд paginate ирнэ.

curl "https://api.urlan.ai/ai-poster/v1/approved?format=1:1,9:16&limit=50" \
  -H "Authorization: Bearer urk_live_…"

• format — хэмжээгээр шүүх, таслалаар олныг (1:1, 4:5, 9:16, 16:9, 300x250, 728x90). Өгөхгүй бол бүх хэмжээ.
• since — ISO огноо; үүнээс хойш батлагдсаныг л (синк хийхэд).
• project_id, page, limit (≤100).

{
  "success": true,
  "data": [{
    "id": "6ab6623f…",
    "project": { "id": "6ab661d9…", "name": "Намрын хямдрал" },
    "format": "1:1", "width": 1080, "height": 1080,
    "url": "https://…/1x1.png", "thumb_url": "https://…/1x1-thumb.webp",
    "headline": "Намрын хямдрал", "subheadline": "…", "cta": "Одоо захиал",
    "score": 87, "version": 2,
    "approved_at": "2026-09-25T08:12:00.000Z",
    "files": [{ "format": "1:1", "width": 1080, "height": 1080, "url": "…", "thumb_url": "…" }]
  }],
  "paginate": { "page": 1, "limit": 50, "total": 12, … }
}

format өгсөн үед дээд түвшний url/width/height нь эхний тохирсон хэмжээ; files-д тухайн постерын (шүүсэн) бүх хэмжээ байна.

Token-ий нэр, эрх, брэнд (нэр, лого, өнгө), батлагдсан зургийн тоо, хэмжээ бүрийн тоог буцаана. Апп-даа холбох үед token зөв эсэхийг үүгээр шалгана.

curl https://api.urlan.ai/ai-poster/v1/approved/me -H "Authorization: Bearer urk_live_…"

«Төслийн жагсаалт унших» эрхтэй token-д: нэр, төлөв, батлагдсан зургийн тоо, огноо.

• 1:1 — 1080×1080 — feed пост
• 4:5 — 1080×1350 — босоо пост
• 9:16 — 1080×1920 — story, reels
• 16:9 — 1920×1080 — хэвтээ, вэб
• 300x250 — 300×250 — баннер
• 728x90 — 728×90 — leaderboard

• 401 — token байхгүй, буруу эсвэл цуцлагдсан.
• 403 — token зогсоогдсон эсвэл тухайн эрх (scope) байхгүй.
• 429 — token тус бүрт минутад 120 хүсэлт.

Асуулт байвал hello@urlan.ai.