বিক্রি ও নিজস্ব ডেটা LinkHarbor-এ পাঠানো

LinkHarbor বাইরে থেকেও ডেটা নেয়। দুটি ক্ষেত্রের জন্য নিজস্ব সিক্রেটসহ আলাদা এন্ডপয়েন্ট আছে – এগুলোর জন্য API কী লাগে না: সেল কলব্যাক আপনার শপ থেকে বিক্রির খবর দেয়, যাতে পরিসংখ্যানে দেখতে পান কোন লিংক আয় এনেছে। “Custom (API)” ইন্টিগ্রেশন আপনার নিজের টুলের লাইভ ডেটা উইজেট হিসেবে আপনার পেজে আনে এবং পুশ নোটিফিকেশন চালু করতে পারে।

#সেল কলব্যাক: বিক্রি মেলানো

ক্লিক আইডি (lt_click_id), মেলানো আর রিপোর্টিং কীভাবে একসাথে কাজ করে তা ব্যাখ্যা করা আছে কনভার্সন ও বিক্রি যুক্ত করা-এ; এখানে ডেভেলপারদের জন্য সব ফিল্ড আর রেসপন্স পাবেন। সংক্ষেপে: LinkHarbor যখন গোনা একটি ক্লিককে http বা https টার্গেটে রিডাইরেক্ট করে, তখন lt_click_id প্যারামিটার যোগ করে; আপনার শপ এটি মনে রাখে এবং কেনাকাটার পর ফেরত পাঠায়।

কলব্যাক সিক্রেট তৈরি করুন

1. “কলব্যাক ও API” খুলুন
2. “কলব্যাক সিক্রেট” কার্ডে “+ নতুন সিক্রেট তৈরি করুন”-এ ক্লিক করুন
3. চাইলে একটি নাম দিন, যেমন “শপ কলব্যাক”, তারপর “সিক্রেট তৈরি করুন”-এ ক্লিক করুন
4. সিক্রেটটি সাথে সাথে কপি করুন – এটি শুধু একবারই দেখানো হয়

কে

মালিক আর অ্যাডমিন, Creator Pro থেকে। Creator Free-তে লেখা থাকে “কলব্যাক সিক্রেট Creator Pro থেকে পাওয়া যায়।”

কতগুলো

প্রতি ওয়ার্কস্পেসে সর্বোচ্চ ৫টি সিক্রেট, যেমন প্রতিটি শপের জন্য একটি।

“সম্পাদনা করুন”

নাম বদলান আর স্ট্যাটাস “সক্রিয়” বা “নিষ্ক্রিয়” করুন। সিক্রেট নিষ্ক্রিয় থাকলে API কলব্যাক প্রত্যাখ্যান করে।

“↺ রোটেট করুন”

একটি নতুন সিক্রেট তৈরি করে; পুরোনোটি সাথে সাথে কাজ করা বন্ধ করে।

“সর্বশেষ কলব্যাক:”

সিক্রেটটি শেষবার কখন সফলভাবে ব্যবহার হয়েছে তা দেখায়।

কলব্যাক পাঠান

curl -X POST https://dock.at-harbor.com/v1/callbacks/sale \
  -H "Content-Type: application/json" \
  -H "X-Callback-Secret: $LH_CALLBACK_SECRET" \
  -d '{
    "click_id": "3f1c2a9e-8d4b-4a51-9f0e-6b7c1d2e3f40",
    "order_id": "A-10023",
    "amount": "49.90",
    "currency": "EUR",
    "occurred_at": "2026-11-01T10:15:00Z"
  }'
# → {"ok":true,"conversion_id":123}

ঐচ্ছিক সিগনেচার

সিক্রেটের পাশাপাশি আপনি X-Callback-Signature হেডার পাঠাতে পারেন। এতে থাকে sha256= আর hex-এ কাঁচা বডির HMAC-SHA256 সিগনেচার। কী হিসেবে সিক্রেট নিজে নয়, বরং বাইনারি আকারে তার SHA-256 হ্যাশ ব্যবহার হয়। হেডার পাঠালে তা অবশ্যই সঠিক হতে হবে – নইলে কলব্যাক প্রত্যাখ্যাত হয়।

<?php
$body = json_encode($payload);
$key  = hash('sha256', getenv('LH_CALLBACK_SECRET'), true); // সিক্রেটের বাইনারি হ্যাশ
$sig  = 'sha256=' . hash_hmac('sha256', $body, $key);
// হেডার: X-Callback-Secret আর X-Callback-Signature: $sig, বডি: $body

বিক্রি কোথায় দেখবেন

রিপোর্ট করা বিক্রি আপনার পরিসংখ্যানে কনভার্সন হিসেবে দেখা যায়, দেখুন কনভার্সন ও বিক্রি যুক্ত করা। API দিয়ে এগুলো পড়েন read:stats দিয়ে, /v1/stats/…/conversions/breakdown-এর অধীনে।

#Custom (API): আপনার নিজের লাইভ ডেটা

“Custom (API)” ইন্টিগ্রেশনের মাধ্যমে HTTP রিকোয়েস্ট পাঠাতে পারে এমন যেকোনো প্রোগ্রাম – গেম সার্ভারের প্লাগইন, বট, ক্রন স্ক্রিপ্ট – LinkHarbor-এ ডেটা পাঠাতে পারে। তা আপনার পেজে একটি লাইভ উইজেট হয়ে যায়, আর পুশ রুল আপনার ফলোয়ারদের জানাতে পারে।

সংযুক্ত করুন

1. ওয়ার্কস্পেসে “ইন্টিগ্রেশন” খুলুন
2. “Custom (API)” বেছে নিয়ে একটি নাম দিন
3. সংযুক্ত হলে ডায়ালগে “Ingest URL” আর “সিক্রেট” দেখা যায় (“সিক্রেট দেখান” সহ)
4. দুটোই আপনার টুলে সংরক্ষণ করুন

ইন্টিগ্রেশন Creator Pro থেকে পাওয়া যায়। Ingest URL আর সিক্রেট শুধু মালিক আর অ্যাডমিনরা দেখতে পান, পরে ইন্টিগ্রেশনের বিস্তারিত ভিউতেও। সংযোগ বিচ্ছিন্ন করে আবার সংযুক্ত করলে নতুন সিক্রেট তৈরি হয়। সাধারণভাবে ইন্টিগ্রেশন কীভাবে সংযুক্ত করবেন তা ব্যাখ্যা করা আছে ইন্টিগ্রেশন সংযোগ, নবায়ন ও বিচ্ছিন্ন করা-এ।

ডেটা পাঠান

curl -X POST "$INGEST_URL" \
  -H "Authorization: Bearer $INGEST_SECRET" \
  -H "Content-Type: application/json" \
  -d '{
    "event": "player.joined",
    "event_id": "join-2026-11-01T20:01:02Z-steve",
    "data": { "player": "Steve" },
    "state": {
      "type": "game_server",
      "name": "Survival SMP",
      "online": true,
      "players_online": 3,
      "players_max": 20
    }
  }'
# → {"ok":true,"event_id":4711,"duplicate":false,"event_type":"player.joined"}

event

ইচ্ছেমতো ইভেন্টের নাম, যেমন player.joined। এটি ছোট হাতের অক্ষরে রূপান্তরিত হয়, আর পুশ রুল এই নামেই সাড়া দেয়। event না থাকলে ইভেন্টের নাম হয় state.updated।

event_id

ঐচ্ছিক কী, যা দুবার প্রসেস হওয়া ঠেকায়। একই event_id আবার পাঠালে LinkHarbor duplicate: true দিয়ে উত্তর দেয় এবং আর কিছু করে না।

data

পুশ টেক্সটের প্লেসহোল্ডারের মান, যেমন {player}। সর্বোচ্চ ৪০টি কী, শুধু সাধারণ মান।

state

উইজেটের সম্পূর্ণ অবস্থা। এটি আগেরটিকে পুরোপুরি প্রতিস্থাপন করে। type হলো game_server (গেম সার্ভার কার্ড) বা status (স্ট্যাটাস কার্ড)।

Authorization: Bearer-এর বদলে আপনি সিক্রেটটি X-LinkHarbor-Secret হেডারেও পাঠাতে পারেন। প্রতি IP ঠিকানায় মিনিটে ১২০টি কল অনুমোদিত। চাইলে বডিতে সাইন করতে পারেন: X-LinkHarbor-Signature হেডারে থাকে sha256= আর সিক্রেটকে কী হিসেবে নিয়ে কাঁচা বডির HMAC-SHA256 সিগনেচার। পাঠালে তা অবশ্যই সঠিক হতে হবে।