Баримт бичиг / Гарын авлага

API-аар холбоос удирдах

Өөрийн кодоос холбоос үүсгэх, унших, засах, олноор үүсгэх.

links.read, links.write хүрээтэй API түлхүүр хэрэгтэй (Ажлын орчин үз). Бүх жишээ https://api.a-z.mn ашиглана.

Холбоос үүсгэх

curl -X POST https://api.a-z.mn/v1/workspaces/WORKSPACE/links \
  -H "Authorization: Bearer az_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.mn/summer-sale",
    "key": "sale",
    "utm_source": "sms",
    "tagNames": ["summer"]
  }'

Хариу нь id, shortLink, qrCode бүхий холбоос. Домэйн, түлхүүр эзэмшигдсэн бол 409 буцна.

Холбоос жагсаах

curl "https://api.a-z.mn/v1/workspaces/WORKSPACE/links?pageSize=50" \
  -H "Authorization: Bearer az_YOUR_KEY"

Жагсаалт cursor хуудаслалт ашиглана: бүртгэлийн id-тай startingAfter эсвэл endingBefore дамжуул. Link толгой дараагийн хуудсыг зааж өгнө.

Очих хаяг солих

Холбоос дээр PATCH ашигла. Богино холбоос хэвээр үлдэнэ.

Олныг нэг дор үүсгэх

POST /v1/workspaces/WORKSPACE/links/bulk 100 хүртэл холбоос авна. Скриптийг давхардалгүй хэд ч ажиллуулахын тулд очих хаягаар таарах PUT .../links/upsert ашигла.

Алдаа боловсруулах

Алдаа бүр ижил бүтэцтэй, API танилцуулга үз. 429 хариуг Retry-After-д заасан секундын дараа дахин оролд.