API রেফারেন্স

REST API
আপনার লিংকের ওপর গড়ে তুলুন।

একটি API টোকেন দিয়ে অথেনটিকেট করুন, লিংকের তালিকা দেখুন ও তৈরি করুন, ভিজিট পড়ুন এবং ওয়েবহুকে সাবস্ক্রাইব করুন।

বেস URL https://letl.ink/api/v1 শুধু HTTPS

প্ল্যান Growth Ultimate

এই পৃষ্ঠায়

শুরু করা

REST API Growth ও Ultimate প্ল্যানে পাওয়া যায়। অনুরোধগুলো HTTPS-এর মাধ্যমে https://letl.ink/api/v1-এ যায়। Free বা Solo প্ল্যানের ওয়ার্কস্পেস /api/v1 থেকে 403 plan_required পায়; MCP এন্ডপয়েন্ট আলাদাভাবে Ultimate প্ল্যানে সীমিত।

Integrations → REST API খুলুন (শুধু ওয়ার্কস্পেসের মালিক ও অ্যাডমিনরা)।
একটি টোকেন তৈরি করুন। এর মেয়াদ শেষ হয় না।
এটি পাসওয়ার্ডের মতো সংরক্ষণ করুন। একটি টোকেনই এই ওয়ার্কস্পেসের REST API, MCP সার্ভার ও যুক্ত সব অটোমেশন প্ল্যাটফর্মে কাজ করে, তাই এটি রিজেনারেট করলে সবগুলো একসাথে অকার্যকর হয়ে যায়।

টোকেন তৈরি করা থাকলে সদস্যরা তা কপি করতে পারেন; কেবল মালিক ও অ্যাডমিনরা এটি পরিবর্তন করতে পারেন।

টোকেন তৈরি করতে লগ ইন করুন

অথেনটিকেশন

টোকেনটি X-API-KEY অথবা Authorization: Bearer হিসেবে পাঠান। /api/v1 ও /mcp-এ দুটিই গ্রহণ করা হয়। কোনো টোকেন ছাড়া অনুরোধ করলে 401 unauthenticated ফেরত আসে।

GET আমি কে?

curl -H "X-API-KEY: YOUR_TOKEN" \
  https://letl.ink/api/v1/auth/me

সমতুল্য হেডার: Authorization: Bearer YOUR_TOKEN

রীতিনীতি

নিচের প্রতিটি এন্ডপয়েন্টে এগুলো প্রযোজ্য।

রেসপন্স এনভেলপ

প্রতিটি সফল রেসপন্স একটি JSON অবজেক্ট, যাতে একটি data কী থাকে, আর ফলাফল সম্পর্কে কিছু বলার থাকলে একটি meta কী — পেজিনেশন, নির্ধারিত তারিখের সময়সীমা, ভৌগোলিক তথ্য অন্তর্ভুক্ত কিনা। প্রতিটি ব্যর্থতা একটি অবজেক্ট, যাতে একটি error কী থাকে, যার মধ্যে একটি স্থির code, মানুষের পড়ার মতো message এবং কখনো কখনো details। মেসেজের লেখার ওপর নয়, সবসময় code-এর ওপর ভিত্তি করে শাখা তৈরি করুন।

আকার

// success
{ "data": { … }, "meta": { … } }

// failure
{ "error": { "code": "invalid_parameter",
             "message": "sort must be one of: created_at, clicks.",
             "details": { "parameter": "sort" } } }

পেজিনেশন

তালিকার এন্ডপয়েন্ট limit (1–200, ডিফল্ট 50) ও offset গ্রহণ করে। meta ব্লক total, has_more ও next_offset জানায়, তাই হিসাব না করেই পেজ করতে পারেন: has_more false না হওয়া পর্যন্ত offset = meta.next_offset দিয়ে কল করতে থাকুন।

সব লিংক পেজ ধরে দেখা

offset=0
while [ "$offset" != "null" ]; do
  page=$(curl -s -H "X-API-KEY: $TOKEN" \
    "https://letl.ink/api/v1/links?limit=200&offset=$offset")
  echo "$page" | jq -c '.data[]'
  offset=$(echo "$page" | jq -r '.meta.next_offset')
done

সর্টিং, ফিল্টারিং ও সার্চ

GET /links গ্রহণ করে sort (created_at, clicks, short_code, title, updated_at), direction (asc/desc), search (শর্ট কোড, টাইটেল ও গন্তব্যের সঙ্গে মেলায়), type, archived, favorite ও domain। অজানা মান চুপচাপ উপেক্ষা না করে invalid_parameter ও অনুমোদিত মানের তালিকাসহ প্রত্যাখ্যান করা হয়।

তারিখের সময়সীমা

start_date ও end_date YYYY-MM-DD ফরম্যাটে এবং দুটো দিনই অন্তর্ভুক্ত। সময়সীমা আপনার প্ল্যানের ডেটা সংরক্ষণের সীমার মধ্যে সীমিত করা হয় — 30 দিনের সংরক্ষণযুক্ত প্ল্যানে এক বছরের ইতিহাস চাইলে যে 30 দিন আছে তা-ই ফেরত আসে, এবং meta.date_range জানায় আসলে কোন সময়সীমা ব্যবহার হয়েছে।

রেট লিমিট

প্রতি অ্যাকাউন্টে প্রতি মিনিটে 600টি রিকোয়েস্ট, স্লাইডিং উইন্ডোতে। প্রতিটি রেসপন্সে থাকে X-RateLimit-Limit, X-RateLimit-Remaining ও X-RateLimit-Reset (একটি Unix টাইমস্ট্যাম্প)। সীমা ছাড়ালে সেকেন্ডে একটি Retry-After হেডারসহ 429 rate_limited ফেরত আসে। সঙ্গে সঙ্গে আবার চেষ্টা না করে Retry-After অনুযায়ী অপেক্ষা করুন।

প্রতিটি রেসপন্সের হেডার

X-RateLimit-Limit: 600
X-RateLimit-Remaining: 586
X-RateLimit-Reset: 1789000816

সংস্করণ

পাথেই সংস্করণ থাকে। রেসপন্সে একটি ফিল্ড বা নতুন ঐচ্ছিক প্যারামিটার যোগ করা ব্রেকিং পরিবর্তন নয় এবং যেকোনো সময় হতে পারে, তাই সতর্কভাবে পার্স করুন এবং অচেনা কী উপেক্ষা করুন। বিদ্যমান কোনো ফিল্ড বদলায় বা সরায় এমন যেকোনো কিছু নতুন সংস্করণ প্রিফিক্সের অধীনে আসে।

এন্ডপয়েন্ট

অ্যাকাউন্ট

GET /me সংযোগ পরীক্ষা

পরিচয়, ওয়ার্কস্পেস, প্ল্যান এবং সেই প্ল্যানের প্রতিটি সুবিধা। কোনো টোকেন যাচাই করার এবং চেষ্টা করার আগে অ্যাকাউন্ট কী কী করতে পারে তা জানার সবচেয়ে সহজ উপায়।

GET cURL

curl -H "X-API-KEY: YOUR_TOKEN" \
  https://letl.ink/api/v1/me

রেসপন্স 200

{
  "data": {
    "user": { "id": 1, "email": "[email protected]", "name": "You" },
    "workspace": { "id": 12, "name": "My Workspace", "block_bots": true },
    "plan": {
      "id": "growth",
      "name": "Growth",
      "limits": {
        "links": 200,
        "monthly_clicks": 100000,
        "custom_domains": 3,
        "qr_codes": 30,
        "retention_days": 365
      },
      "features": {
        "api": true,
        "webhooks": true,
        "integrations": true,
        "ai_access": false,
        "geo_analytics": false,
        "smart_link_types": true
      }
    },
    "base_domain": "letl.ink"
  }
}

GET /usage

এই বিলিং মাসে প্রতিটি বরাদ্দের কতটা ব্যবহৃত হয়েছে। ট্র্যাক করা ক্লিকের সীমায় পৌঁছানোর আগে গ্রাহককে সতর্ক করতে এটি ব্যবহার করুন — সীমা ছাড়ালে রিডাইরেক্ট চালু থাকে, কিন্তু ক্লিক রেকর্ড হওয়া বন্ধ হয়ে যায়।

রেসপন্স 200

{
  "data": {
    "links": { "used": 42, "limit": 200, "remaining": 158, "percent_used": 21.0 },
    "clicks_this_month": { "used": 8140, "limit": 100000, "remaining": 91860, "percent_used": 8.1 },
    "custom_domains": { "used": 1, "limit": 3, "remaining": 2, "percent_used": 33.3 },
    "qr_codes": { "used": 4, "limit": 30, "remaining": 26, "percent_used": 13.3 }
  },
  "meta": { "plan": "growth", "period": "2026-09" }
}

GET /domains

ওয়ার্কস্পেসের কাস্টম ডোমেইন এবং প্রতিটির DNS ভেরিফিকেশন সম্পন্ন হয়েছে কিনা। লিংক তৈরির সময় domain ফিল্ডে কেবল ভেরিফাইড ডোমেইন ব্যবহার করা যায়।

GET /integrations

প্রোডাক্টের প্রতিটি ইন্টিগ্রেশন, আপনার প্ল্যানে তা আছে কিনা, এই ওয়ার্কস্পেস তা সংযুক্ত করেছে কিনা, এবং ডেলিভারি কেমন চলছে — শেষ স্ট্যাটাস, শেষ ত্রুটি ও পরপর ব্যর্থতার সংখ্যা। অনেকগুলো ওয়ার্কস্পেস পর্যবেক্ষণে কাজের।

লিংক

GET /links পেজিনেটেড

ওয়ার্কস্পেসের লিংক, মোট ক্লিক all, ios, android ও desktop-এ ভাগ করা। শূন্য ক্লিকের লিংকও অন্তর্ভুক্ত।

কোয়েরি প্যারামিটার

domain string

একটি হোস্টনেমে সীমিত করুন। ওয়ার্কস্পেসের সব হোস্টনেম দেখাতে বাদ দিন।

ঐচ্ছিক
search string

শর্ট কোড, টাইটেল ও গন্তব্যের সঙ্গে মেলায়।

ঐচ্ছিক
type string

direct, utm, appstore, instagram, mobile বা device।

ঐচ্ছিক
archived boolean

ডিফল্ট false। এর বদলে আর্কাইভের তালিকা দেখতে true দিন।

ঐচ্ছিক
favorite boolean

শুধু স্টার দেওয়া লিংকে সীমিত করুন।

ঐচ্ছিক
sort string

created_at (ডিফল্ট), clicks, short_code, title বা updated_at।

ঐচ্ছিক
direction string

asc বা desc। ডিফল্ট desc।

ঐচ্ছিক
limit integer

1–200। ডিফল্ট 50।

ঐচ্ছিক
offset integer

ডিফল্ট 0।

ঐচ্ছিক
start_date date

YYYY-MM-DD। মোট ক্লিকের সময়সীমা নির্ধারণ করে, কোন লিংক ফেরত আসবে তা নয়।

ঐচ্ছিক
end_date date

YYYY-MM-DD, দিনটি অন্তর্ভুক্ত।

ঐচ্ছিক

GET cURL

curl -H "X-API-KEY: YOUR_TOKEN" \
  "https://letl.ink/api/v1/links?sort=clicks&limit=20"

রেসপন্স 200

{
  "data": [
    {
      "id": 49,
      "short_code": "spring",
      "domain": "letl.ink",
      "url": "https://letl.ink/spring",
      "destination": "https://shop.example.com/spring",
      "title": "Spring sale",
      "type": "utm",
      "archived": false,
      "favorite": true,
      "created_at": "2026-08-01T09:14:00+00:00",
      "updated_at": "2026-09-02T11:00:00+00:00",
      "clicks": { "all": 650, "ios": 180, "android": 210, "desktop": 260 },
      "total_clicks": 650,
      "device_limit": null,
      "utm": { "source": "twitter", "medium": "social", "campaign": "spring" },
      "split_test": {
        "variations": [
          { "name": "control", "url": "https://example.com/a", "weight": 2 },
          { "name": "variant-b", "url": "https://example.com/b", "weight": 1 }
        ]
      }
    }
  ],
  "meta": {
    "total": 42, "limit": 20, "offset": 0,
    "has_more": true, "next_offset": 20,
    "sort": "clicks", "direction": "desc",
    "date_range": { "start_date": null, "end_date": null },
    "domain": "all"
  }
}

GET /links/{id}

id অনুযায়ী একটি লিংক, তালিকার এন্ডপয়েন্ট যে গঠনে দেয় সেভাবেই।

POST /links

একটি শর্ট লিংক তৈরি করুন। র‍্যান্ডম কোডের জন্য short_code বাদ দিন। গন্তব্যের কোনো title না থাকলে আমরা ব্যাকগ্রাউন্ডে পৃষ্ঠার টাইটেল নিয়ে আসি।

JSON বডি

destination

যে URL-এ রিডাইরেক্ট করা হবে। direct ও utm লিংকের জন্য আবশ্যক। original_url-কে বিকল্প নাম হিসেবে গ্রহণ করা হয়।

আবশ্যক
short_code

সর্বোচ্চ 20 অক্ষর: অক্ষর, সংখ্যা, হাইফেন ও আন্ডারস্কোর, বিভাজক দিয়ে শুরু বা শেষ নয়। প্রতিটি হোস্টনেমে অনন্য হতে হবে।

ঐচ্ছিক
title

ড্যাশবোর্ডে প্রদর্শিত নাম।

ঐচ্ছিক
domain

একটি ভেরিফাইড কাস্টম ডোমেইন, অথবা বেস ডোমেইন। ডিফল্ট বেস ডোমেইন।

ঐচ্ছিক
type

direct (ডিফল্ট), utm, appstore, instagram, mobile বা device। direct ও utm ছাড়া বাকি সবকিছুর জন্য Solo, Growth বা Ultimate প্ল্যান দরকার।

ঐচ্ছিক
utm_source, utm_medium, utm_campaign

utm লিংকের জন্য; type যখন utm, তখন utm_source আবশ্যক।

ঐচ্ছিক
ios_url, android_url

appstore ও mobile লিংকের জন্য প্ল্যাটফর্মভিত্তিক গন্তব্য।

ঐচ্ছিক
desktop_url, mobile_url

device লিংকের জন্য দুটোই আবশ্যক।

ঐচ্ছিক
instagram_username

instagram লিংকের জন্য।

ঐচ্ছিক
split_variations

{name, url, weight} অবজেক্টের একটি অ্যারে — অন্তত দুটি — কোনো direct বা utm লিংকে ওয়েটেড স্প্লিট টেস্ট চালানোর জন্য।

ঐচ্ছিক
limit_visits_per_device

true সেট করুন এবং প্রতিটি ডিভাইসের ঘণ্টাপ্রতি ভিজিট সীমিত করতে visit_limit_per_device দিন।

ঐচ্ছিক

POST cURL

curl -X POST https://letl.ink/api/v1/links \
  -H "X-API-KEY: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
        "destination": "https://shop.example.com/spring",
        "short_code": "spring",
        "title": "Spring sale",
        "type": "utm",
        "utm_source": "twitter",
        "utm_campaign": "spring"
      }'

রেসপন্স 201

The created link, in the shape shown above.

POST /links/bulk সর্বোচ্চ 50 জন

একটি রিকোয়েস্টে অনেকগুলো লিংক তৈরি করুন। প্রতিটি সারি আলাদাভাবে চেষ্টা করা হয়: সঠিক সারিগুলো তৈরি হয় এবং ব্যর্থতাগুলো ইনডেক্স অনুযায়ী জানানো হয়, তাই একটি ভুল URL-এর কারণে বাকি ব্যাচ বাতিল হয় না। কিছু তৈরি হলে 201, কিছুই না হলে 422 ফেরত দেয়।

POST cURL

curl -X POST https://letl.ink/api/v1/links/bulk \
  -H "X-API-KEY: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"links":[
        {"destination":"https://example.com/1","short_code":"one"},
        {"destination":"https://example.com/2"}
      ]}'

রেসপন্স 201

{
  "data": [ { "id": 51, "short_code": "one", … } ],
  "meta": {
    "requested": 2,
    "created": 1,
    "failed": 1,
    "errors": [
      { "index": 1,
        "code": "invalid_request",
        "message": "This shortcode is already taken.",
        "short_code": "two" }
    ]
  }
}

PATCH /links/{id}

PATCH একীভূত করে: কেবল আপনার পাঠানো ফিল্ডগুলো বদলায়, বাকি সব বর্তমান মান ধরে রাখে। PUT প্রতিস্থাপন করে: যা বাদ দেবেন তা মুছে যায়। তৈরি করার মতোই একই ফিল্ড গ্রহণ করে।

PATCH আর কিছু না ছুঁয়ে নাম বদলান

curl -X PATCH https://letl.ink/api/v1/links/49 \
  -H "X-API-KEY: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"title": "Spring sale — extended"}'

DELETE /links/{id}

লিংকটি আর্কাইভ করে: এটি আর রিজলভ হয় না এবং বরাদ্দের একটি জায়গা খালি হয়, তবে এর ক্লিকের ইতিহাস রাখা হয়। API-তে ইচ্ছাকৃতভাবেই স্থায়ীভাবে মোছার অপশন নেই — একটি লিংক ও এর ইতিহাস ধ্বংস করা ড্যাশবোর্ডের কাজ, স্পষ্ট নিশ্চিতকরণের পরে।

POST /links/{id}/restore

একটি আর্কাইভ করা লিংককে আবার সক্রিয় করে। ওয়ার্কস্পেস ইতিমধ্যে সক্রিয় লিংকের বরাদ্দ পূর্ণ করে থাকলে 403 plan_required ফেরত দেয়।

GET /links/{id}/events পেজিনেটেড

একটি লিংকের আলাদা আলাদা ভিজিট, নতুনগুলো আগে। limit ও offset গ্রহণ করে। প্রতিটি প্ল্যানে দেশ অন্তর্ভুক্ত।

অ্যানালিটিক্স

GET /analytics/summary

পুরো ওয়ার্কস্পেসের মূল সংখ্যাগুলো: সর্বমোট ও নির্বাচিত সময়সীমার ক্লিক, ইউনিক ভিজিটর, QR স্ক্যান, সর্বোচ্চ দিন, এবং দিনের ঘণ্টা ও সপ্তাহের দিন অনুযায়ী বণ্টন। days গ্রহণ করে (ডিফল্ট 30, আপনার সংরক্ষণকালের মধ্যে সীমিত)।

রেসপন্স 200 (সংক্ষেপিত)

{
  "data": {
    "window_days": 30,
    "clicks": {
      "total": 24592, "window": 8140, "last_7_days": 2103,
      "daily_average": 271,
      "peak_day": { "date": "Sep 02", "clicks": 612 }
    },
    "visitors": { "unique_total": 18204, "unique_window": 6021 },
    "qr": { "scans_total": 940, "scans_window": 310 },
    "timing": {
      "by_hour": [12, 4, 2, …],
      "by_weekday": [1420, 1610, 1585, 1490, 1310, 480, 245],
      "peak_hour": { "peakHour": 14, "peakValue": 812, "label": "14:00–14:59" },
      "peak_weekday": { "peakDay": 1, "peakValue": 1610, "label": "Tuesday" }
    },
    "links": { "active": 42, "limit": 200 }
  },
  "meta": { "plan": "growth", "geo_included": true, "retention_days": 365 }
}

GET /analytics/timeseries

দৈনিক ক্লিকের সংখ্যা, চার্টের জন্য প্রস্তুত। একটি লিংকে সীমিত করতে link_id এবং সময়সীমা নির্ধারণ করতে days দিন। ট্রাফিক না থাকা দিনগুলো বাদ না দিয়ে শূন্য হিসেবে ফেরত দেওয়া হয়, তাই সিরিজটি সবসময় ধারাবাহিক থাকে।

রেসপন্স 200

{
  "data": [
    { "date": "Sep 04", "clicks": 22 },
    { "date": "Sep 05", "clicks": 11 }
  ],
  "meta": { "window_days": 7, "total": 33, "link_id": null }
}

GET /analytics/breakdown

একটি মাত্রা অনুযায়ী ভাগ করা ক্লিক, প্রতিটি সারির মোটের অংশসহ।

কোয়েরি প্যারামিটার

dimension string

channel, referrer, device, browser, os, brand, variation বা country। browser, os, brand ও variation-এর জন্য একটি link_id দরকার।

আবশ্যক
link_id integer

একটি লিংকে সীমিত করুন। পুরো ওয়ার্কস্পেসের জন্য বাদ দিন।

ঐচ্ছিক
limit integer

1–100। ডিফল্ট 10।

ঐচ্ছিক

রেসপন্স 200

{
  "data": [
    { "label": "Search", "value": 215, "share": 33.1 },
    { "label": "Social", "value": 201, "share": 30.9 },
    { "label": "Direct / none", "value": 142, "share": 21.8 }
  ],
  "meta": { "dimension": "channel", "link_id": 49, "total": 650 }
}

GET /analytics/links/{id} সবকিছু

একটি লিংকের জন্য ড্যাশবোর্ড যা দেখায় তার সবকিছু এক কলে: লিংকটি নিজে, মোট ক্লিক, ইউনিক ও ফিরে আসা ভিজিটর, দৈনিক সিরিজ, ঘণ্টা ও বারের বণ্টন, সব ব্রেকডাউন, এবং লিংকে স্প্লিট টেস্ট চললে তার স্কোরবোর্ড।

রেসপন্স 200 (split_test অংশ)

"split_test": {
  "active": true,
  "conclusive": true,
  "minClicks": 100,
  "leader": "control",
  "totalClicks": 650,
  "totalVisitors": 172,
  "arms": [
    { "name": "control", "isControl": true, "weight": 2,
      "clicks": 357, "visitors": 60,
      "expectedShare": 50.0, "actualShare": 54.9, "drift": 4.9 },
    { "name": "variant-b", "isControl": false, "weight": 1,
      "clicks": 146, "visitors": 57,
      "expectedShare": 25.0, "actualShare": 22.5, "drift": -2.5 }
  ]
}

GET /events পেজিনেটেড

ওয়ার্কস্পেসের সব লিংকের কাঁচা ভিজিট ফিড, নতুনগুলো আগে। এটি GET /visits-এর আধুনিক বিকল্প: একই ডেটা, মানক এনভেলপ, limit ও offset সমর্থন।

রেসপন্স 200

{
  "data": [
    {
      "id": 2691,
      "link_id": 49,
      "short_code": "spring",
      "occurred_at": "2026-09-10T22:45:33+00:00",
      "ip_address": "203.0.113.7",
      "referrer": "https://twitter.com/",
      "browser": "Chrome",
      "os": "iOS",
      "device_type": "mobile",
      "device_brand": "Apple",
      "country": "US",
      "variation": "control"
    }
  ],
  "meta": { "limit": 50, "returned": 50, "geo_included": true }
}

ওয়েবহুক

GET /hooks

এই অ্যাকাউন্টে নিবন্ধিত ওয়েবহুক এন্ডপয়েন্ট।

POST /hooks

প্রতিটি রেকর্ড করা ক্লিকে JSON পেলোড পেতে একটি HTTPS এন্ডপয়েন্ট নিবন্ধন করুন। প্রতি অ্যাকাউন্টে সর্বোচ্চ 25টি। ব্যর্থ ডেলিভারি স্বয়ংক্রিয়ভাবে আবার চেষ্টা করা হয়।

JSON বডি

target_url

অবশ্যই https:// হতে হবে।

আবশ্যক
event

ডিফল্ট link_visited, যা বর্তমানে একমাত্র ইভেন্ট।

ঐচ্ছিক

POST cURL

curl -X POST https://letl.ink/api/v1/hooks \
  -H "X-API-KEY: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"target_url": "https://example.com/hooks/clicks"}'

DELETE /hooks/{id}

একটি ওয়েবহুক এন্ডপয়েন্ট সরান। Zapier-এর REST Hook ফ্লোর জন্য POST /hooks/subscribe ও DELETE /hooks/unsubscribe/{id} চালু থাকে।

পুরোনো

GET /auth/me পুরোনো

মূল সংযোগ পরীক্ষা: আপনার ইউজার id, ইমেইল এবং ওয়ার্কস্পেসের id/নাম একটি ফ্ল্যাট অবজেক্ট হিসেবে ফেরত দেয়। GET /me একই পরিচয়ের সাথে আপনার প্ল্যানের সীমা ও ফিচার ফ্ল্যাগও ফেরত দেয়, এবং নতুন কোডের জন্য এটিই ভালো পছন্দ।

GET cURL

curl -H "X-API-KEY: YOUR_TOKEN" \
  https://letl.ink/api/v1/auth/me

রেসপন্স 200

{
  "id": 1,
  "email": "[email protected]",
  "workspace_id": 12,
  "workspace_name": "My Workspace"
}

GET /stats পুরোনো

একটি লিংকের মোট ক্লিক, id-এর বদলে domain ও slug দিয়ে নির্দিষ্ট করা। দুটো প্যারামিটারই আবশ্যক। id জানা থাকলে GET /links/{id} ও GET /analytics/links/{id} একই তথ্য দেয়।

কোয়েরি প্যারামিটার

domain string

মূল ডোমেইন অথবা আপনার যাচাইকৃত কাস্টম ডোমেইনগুলোর একটি।

আবশ্যক
slug string

শর্ট কোড, শুরুতে স্ল্যাশ ছাড়া।

আবশ্যক
start_date date

YYYY-MM-DD, আপনার প্ল্যানের ডেটা সংরক্ষণের সীমার মধ্যে।

ঐচ্ছিক
end_date date

YYYY-MM-DD, দিনটি অন্তর্ভুক্ত।

ঐচ্ছিক

GET /visits পুরোনো

পুরো ওয়ার্কস্পেসের সর্বশেষ 50টি ভিজিট, একটি খালি JSON অ্যারে হিসেবে — কোনো এনভেলপ ছাড়া — visit_id, visit_time, link_shortcode এবং visitor_* ফিল্ড নাম ব্যবহার করে। Zapier-এর REST Hook-এর “perform list” ধাপ এটিই পড়ে, তাই এর গঠন স্থির রাখা হয়েছে। নতুন কাজের জন্য GET /events ব্যবহার করুন।

GET /links/{id}/visits পুরোনো

একটি লিংকের সর্বশেষ 50টি ভিজিট, একটি খালি অ্যারে হিসেবে, যাতে থাকে created_at, ip_address, country, device_type, browser, os এবং referrer। /visits-এর সাথে এটিও স্থির রাখা হয়েছে; নতুন কাজের জন্য GET /links/{id}/events ব্যবহার করুন।

DELETE /hooks/unsubscribe/{id} Zapier

REST Hook আনসাবস্ক্রাইব, যা {"success": true} ফেরত দেয়। স্ট্যান্ডার্ড রূপে এর সমতুল্য হলো DELETE /hooks/{id}।

ত্রুটি

400 invalid_request
বডি কোনো JSON অবজেক্ট ছিল না, অথবা একটি আবশ্যক ফিল্ড অনুপস্থিত ছিল।
400 invalid_parameter
একটি কোয়েরি প্যারামিটার ভুল ফরম্যাটে ছিল বা অনুমোদিত মানের বাইরে ছিল। details.parameter সমস্যাযুক্ত প্যারামিটারের নাম জানায়।
401 unauthenticated
কোনো টোকেন পাঠানো হয়নি। X-API-KEY বা Authorization: Bearer যোগ করুন।
401 invalid_token
টোকেনটি কোনো অ্যাকাউন্টের সাথে মেলে না। হয়তো এটি নতুন করে তৈরি করা হয়েছে।
403 plan_required
অ্যাকাউন্টের প্ল্যানে এই এন্ডপয়েন্ট বা ফিচার অন্তর্ভুক্ত নেই। details.upgrade_url বিলিং পৃষ্ঠার দিকে নির্দেশ করে।
403 forbidden
অথেনটিকেটেড, কিন্তু অনুমতি নেই — যেমন কোনো সদস্য শুধু মালিকের জন্য নির্ধারিত কাজ করার চেষ্টা করলে।
404 not_found
এই ওয়ার্কস্পেসে এমন কোনো রিসোর্স নেই। অন্য ওয়ার্কস্পেসের id নিষিদ্ধ নয়, বরং পাওয়া যায়নি হিসেবে জানানো হয়।
409 conflict
অনুরোধটি বর্তমান অবস্থার সাথে সাংঘর্ষিক — ওয়েবহুকের সীমা পূর্ণ, অথবা অ্যাকাউন্টে এখনো কোনো ওয়ার্কস্পেস নেই।
422
ব্যাচের প্রতিটি সারি ব্যর্থ হলে POST /links/bulk এটি ফেরত দেয়। meta.errors দেখুন।
429 rate_limited
গত এক মিনিটে 600-এর বেশি অনুরোধ। Retry-After সেকেন্ড অপেক্ষা করুন।

পুরোনো GET /visits ও GET /links/{id}/visits এন্ডপয়েন্ট নিজস্ব ফিল্ড নামসহ একটি খালি JSON অ্যারে ফেরত দেয় এবং এগুলোর ওপর ইতিমধ্যে তৈরি Zapier ইন্টিগ্রেশনের জন্য স্থির রাখা হয়েছে। নতুন কোডে GET /events ও GET /links/{id}/events ব্যবহার করা উচিত, যেগুলো মানক এনভেলপ ব্যবহার করে এবং পেজিনেশন সমর্থন করে।

আরও প্রশ্ন আছে?

আমরা সাহায্য করতে এখানে আছি। যোগাযোগ করুন, যত দ্রুত সম্ভব আমরা উত্তর দেব।

সাপোর্টে যোগাযোগ করুন হেল্প সেন্টার

REST API আপনার লিংকের ওপর গড়ে তুলুন।

শুরু করা

অথেনটিকেশন

রীতিনীতি

রেসপন্স এনভেলপ

পেজিনেশন

সর্টিং, ফিল্টারিং ও সার্চ

তারিখের সময়সীমা

রেট লিমিট

সংস্করণ

এন্ডপয়েন্ট

কোয়েরি প্যারামিটার

JSON বডি

কোয়েরি প্যারামিটার

JSON বডি

কোয়েরি প্যারামিটার

ত্রুটি

সম্পর্কিত আর্টিকেল

আরও প্রশ্ন আছে?

REST API
আপনার লিংকের ওপর গড়ে তুলুন।