Developer API

ააწყვე linkz.ge-ზე

შექმენი და მართე ბმულები კოდიდან. REST API, JSON, Bearer token. მარტივი და სწრაფი.

მიიღე API გასაღები ფუნქციები

REST + JSON

ერთი POST — მოკლე ბმული.

უსაფრთხო

პირადი Bearer token თითო ანგარიშზე.

კვოტა

თვიური ლიმიტი გეგმის მიხედვით — header-ებში ჩანს.

curl -X POST https://linkz.ge/api/v1/shorten \
  -H "Authorization: Bearer lz_xxx" \
  -d '{"url":"https://example.com/page"}'

# → { "ok": true, "data": {
#     "short_url": "https://linkz.ge/abc123" } }

გამოყენების მაგალითი

წარმოიდგინე დეველოპერი, რომელიც თავის SaaS პროდუქტში ავტომატურად აგენერირებს მოკლე ბმულებს — მაგალითად, ყოველი ახალი მომხმარებლის რეფერალური ლინკისთვის. ის უბრალოდ აგზავნის ერთ POST მოთხოვნას linkz.ge API-ზე Bearer token-ით და მყისიერად იღებს მზა მოკლე ბმულს, რომლის ჩასმაც პროდუქტში ავტომატურად ხდება — ხელით არაფრის კეთება არ სჭირდება.

ხშირად დასმული კითხვები

სად ვიპოვი API დოკუმენტაციას?

Endpoint: POST /api/v1/shorten, header "Authorization: Bearer <API-გასაღები>" და JSON სხეული. სავალდებულოა url. ყველა გეგმაზე მუშაობს alias, title და monetize; ფასიან გეგმაზე (Pro/Business) დამატებით password, expires_at, url_mobile, og_title, og_description, og_image, ab_variants (A/B როტაცია) და link_targets (გეო/მოწყობილობის თარგეთინგი). პასუხი JSON-ია: ok და data ან error. იგივე მოკლე აღწერა იხილე /llms.txt-ზე.

არის თუ არა მოთხოვნების ლიმიტი (rate limit)?

დიახ, გეგმის მიხედვით თვიური ლიმიტია: Free — 200, Pro — 10 000, Business — 100 000 მოთხოვნა თვეში. ყოველი ავტორიზებული პასუხი შეიცავს X-RateLimit-Limit და X-RateLimit-Remaining header-ებს; ლიმიტის გადაჭარბებისას პასუხია HTTP 429.

შემიძლია ერთდროულად რამდენიმე Bearer token?

ამჟამად თითო ანგარიშზე ერთი აქტიური token გამოიყენება — ის ჩანს პროფილის გვერდზე. თუ გასაღები გაჟონა, დაგვიკავშირდი და გადავაბრუნებთ.

ნახე ასევე

A/B როტაცია

ერთი ბმული — რამდენიმე მისამართი

გეო და მოწყობილობის თარგეთინგი

სხვადასხვა გვერდი სხვადასხვა ვიზიტორს

მზად ხარ დასაწყებად?

უფასო ანგარიში წამებში. ბარათი არ სჭირდება.

მიიღე API გასაღები