API কী দিয়ে ব্যবহার করা যায় এমন প্রতিটি এন্ডপয়েন্ট – ক্ষেত্র অনুযায়ী সাজানো, মেথড, পাথ, দরকারি স্কোপ আর কাজের বিবরণসহ।
এই তালিকায় সেই সব এন্ডপয়েন্ট আছে যা API কী থেকে পাওয়া টোকেন দিয়ে কাজ করে। সব পাথ শুরু হয় https://dock.at-harbor.com দিয়ে। প্রতিটি এন্ডপয়েন্টের সঠিক ফিল্ডগুলো আছে https://dock.at-harbor.com/openapi.yaml-এর OpenAPI বিবরণে।
বর্তমান খসড়া: template_key, config, theme_config, custom_css, seo, ছবির অ্যাসাইনমেন্ট আর লিংক
PATCH /v1/pages/{id}/draft
write:pages
অন্তত একটি: config (JSON হিসেবে সর্বোচ্চ ৬৪ KB, প্রতিটি টেক্সট সর্বোচ্চ ৫,০০০ অক্ষর), theme_config, custom_css (সর্বোচ্চ ৫০,০০০ অক্ষর আর ৬৫,৫৩৫ বাইট), seo, template_key, template_asset_bindings
যে ধরনগুলো তৈরি করা যায়: text, image, embed, spacer, social_links, form, integration, donation, modal, heading, notice, coupon, contact, opening_hours, tour, file, vcard, countdown আর gallery। লিংক ব্লক স্থায়ী এবং এই এন্ডপয়েন্ট দিয়ে তৈরি হয় না। আপনার প্ল্যানের বাইরের ব্লকের ধরন API 403 block_type_requires_plan দিয়ে প্রত্যাখ্যান করে। একটি ব্লকের config JSON হিসেবে সর্বোচ্চ ১২৮ KB হতে পারে, আর এর প্রতিটি টেক্সট সর্বোচ্চ ১০,০০০ অক্ষর; তথ্য মোডালে modal_body_html সর্বোচ্চ ৫০,০০০ অক্ষর এবং সর্বোচ্চ ৬৫,৫৩৫ বাইট হতে পারে।
লিংক তৈরি; আবশ্যক: title (১–২০০) আর target_url_template (৮–২০৪৮)
GET /v1/pages/{id}/links/{linkId}
read:links
একটি লিংক
PATCH /v1/pages/{id}/links/{linkId}
write:links
লিংক সম্পাদনা
DELETE /v1/pages/{id}/links/{linkId}
write:links
লিংক মোছা
POST /v1/pages/{id}/links/reorder
write:links
ক্রম ঠিক করা: {"order":[IDs]}
তৈরি আর সম্পাদনার সময় ঐচ্ছিক ফিল্ড: enabled, geo (allowlist বা denylist মোড আর countries সহ দেশের নিয়ম), device (ডিভাইস অনুযায়ী আলাদা টার্গেট), starts_at আর ends_at (সময়সূচি), protection_tier (বট সুরক্ষা) আর age_restriction। সময়সূচি, দেশ আর ডিভাইসের নিয়ম Creator Pro থেকে পাওয়া যায়। ক্রম বদলানোর সময় শুধু সেই আইডিগুলো পাঠানোই যথেষ্ট যেগুলো সামনে আসবে – বাকি সব লিংক আগের ক্রমে তাদের পরে থাকে। পেজের নয় এমন আইডি API 422 validation_failed দিয়ে প্রত্যাখ্যান করে; details.missing_link_ids-এ সেগুলোর তালিকা থাকে।
সব সাবমিশন একটি CSV ফাইল হিসেবে, নতুনগুলো আগে, প্ল্যানের এক্সপোর্ট সীমা পর্যন্ত (Creator Pro থেকে); X-Export-Truncated হেডার দেখায় তা কেটে ছোট করা হয়েছে কি না
সময়কাল বেছে নেন পেজিনেশন-এ যেমন বলা আছে, period দিয়ে অথবা from আর to দিয়ে। কতদিন পেছনে দেখা যাবে তা প্ল্যানের ওপর নির্ভর করে: Creator Pro আর Agency-তে ৩৬৫ দিন, Enterprise-এ ৭৩০ দিন। এর চেয়ে পুরোনো সময়কাল এই সীমা পর্যন্ত কেটে ছোট করা হয়।
একটি কলব্যাক সিক্রেট (প্লেইন-টেক্সট সিক্রেট ছাড়া)
GET /v1/templates
read:workspaces
সব টেমপ্লেট
GET /v1/templates/available
read:workspaces
বৈধ template_key মানসহ বিল্ট-ইন আর সক্রিয় ওয়ার্কস্পেস টেমপ্লেট; ওয়ার্কস্পেস টেমপ্লেটের কী ws:<key> আর type workspace
GET /v1/templates/{key}
read:workspaces
একটি টেমপ্লেট
GET /v1/workspaces/me/templates
read:workspaces
আপনার নিজের ওয়ার্কস্পেস টেমপ্লেট
GET /v1/workspaces/me/templates/{id}
read:workspaces
একটি ওয়ার্কস্পেস টেমপ্লেট
POST, PATCH, DELETE /v1/workspaces/me/templates[/{id}]
write:templates
ওয়ার্কস্পেস টেমপ্লেট তৈরি, সম্পাদনা, মোছা; html সর্বোচ্চ ৬০,০০০ বাইট (নইলে details.reason maxBytes সহ 422 validation_failed), সর্বোচ্চ ৩২টি asset_slots
ওয়েবহুক, কলব্যাক সিক্রেট তৈরি ও পরিচালনা, ইন্টিগ্রেশন, পুশ নোটিফিকেশন পাঠানো, ডোমেইন পরিচালনা, সদস্য, বিলিং আর পেজ মোছা শুধু ড্যাশবোর্ডেই পাওয়া যায়; কলব্যাক সিক্রেটের তালিকা দেখা ও পড়া (প্লেইন-টেক্সট সিক্রেট ছাড়া) read:workspaces দিয়ে কাজ করে। সম্পূর্ণ তালিকা আছে স্কোপের বিস্তারিত-এ। বাইরে থেকে আসা ডেটা – বিক্রি আর আপনার নিজের লাইভ ডেটা – আপনি আলাদা সিক্রেট দিয়ে কলব্যাক-এ বর্ণিত এন্ডপয়েন্টে পাঠান।
