ডকুমেন্টেশন

Postline দিয়ে নিরাপদে শুরু করুন

ডোমেইন যাচাই, API অ্যাক্সেস, sandbox পাঠানো, suppression এবং ডেলিভারি ইভেন্ট।

২৪ জুলাই ২০২৬ তারিখে আপডেট হয়েছেAPI রেফারেন্স খুলুন

Production চেকলিস্ট

From ডোমেইনের মালিকানা যাচাই করুন।
প্রদত্ত DKIM রেকর্ড প্রকাশ করুন এবং SPF-এর মাধ্যমে return-path ইনফ্রাস্ট্রাকচার অনুমোদন করুন।
DMARC alignment কনফিগার করুন এবং production sending চালু করার আগে ফলাফল পর্যালোচনা করুন।
production key সঙ্গে সঙ্গে পাওয়া যায়; domain verification-এর আগে sandbox@srs-postline.com শুধু project member-এর জন্য ব্যবহার করুন।
bounce এবং complaint webhook idempotent ভাবে প্রক্রিয়া করুন এবং suppression সিদ্ধান্ত মেনে চলুন।

POST /v1/emails

অনুরোধ / প্রতিক্রিয়া

curl --request POST 'https://api.srs-postline.com/v1/emails' \
  --header 'Authorization: Bearer srs_live_...' \
  --header 'Idempotency-Key: order_4821' \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "from": "Postline <info@example.com>",
    "to": ["user@example.net"],
    "subject": "Your order is ready",
    "html": "<p>Order #4821 is ready.</p>",
    "text": "Order #4821 is ready."
  }'

HTTP/1.1 202 Accepted
Content-Type: application/json

{
  "id": "msg_01JPOSTLINEEXAMPLE",
  "status": "queued",
  "created_at": "2026-08-22T12:00:00Z"
}

ইনপুট প্যারামিটার

প্যারামিটার	ধরন	আবশ্যক	বিবরণ	উদাহরণ
`Authorization`	`header · string`	হ্যাঁ	Bearer টোকেন হিসেবে ড্যাশবোর্ড থেকে ইস্যু করা scoped API কী।	`Bearer srs_live_…`
`Idempotency-Key`	`header · string`	না	একটি যৌক্তিক প্রেরণের স্থিতিশীল শনাক্তকারী; দৃঢ়ভাবে সুপারিশ করা হয়।	`order_4821`
`from`	`string`	হ্যাঁ	যাচাইকৃত ডোমেইনে প্রেরকের নাম ও ঠিকানা।	`Postline <info@example.com>`
`to`	`string[]`	হ্যাঁ	এক থেকে 100টি প্রাপকের ইমেইল ঠিকানা।	`["user@example.net"]`
`subject`	`string`	হ্যাঁ	বার্তার বিষয়।	`আপনার অর্ডার প্রস্তুত`
`html`	`string`	না	HTML বডি। html বা text-এর একটি আবশ্যক।	`<p>…</p>`
`text`	`string`	না	সাধারণ টেক্সট বডি। text বা html-এর একটি আবশ্যক।	`অর্ডার #4821…`

প্রতিক্রিয়া কোড

স্ট্যাটাস	HTTP	বিবরণ
`202`	Accepted	বার্তাটি কিউতে আছে; এর অর্থ ইনবক্সে ডেলিভারি নয়।
`400`	Bad Request	অবৈধ JSON বা অসমর্থিত ফিল্ড।
`401`	Unauthorized	API কী অবৈধ, মেয়াদোত্তীর্ণ বা প্রত্যাহার করা হয়েছে।
`403`	Forbidden	scope অনুপস্থিত অথবা প্রেরকের ডোমেইন যাচাই করা হয়নি।
`422`	Unprocessable Entity	প্রাপক suppression তালিকায় আছেন।
`429`	Too Many Requests	প্রকল্পের অনুরোধ সীমা অতিক্রম করা হয়েছে।

HTTP/1.1 422 Unprocessable Entity
Content-Type: application/json

{
  "error": "recipient suppressed"
}

প্রমাণীকরণ পরিভাষা

Postline বার্তাগুলিতে DKIM স্বাক্ষর করে। SPF হলো DNS-এ প্রকাশিত একটি অনুমোদন নীতি। DMARC দৃশ্যমান From ডোমেইন এবং একটি প্রমাণীকৃত SPF বা DKIM identity-র মধ্যে alignment মূল্যায়ন করে; SPF এবং DMARC বার্তার স্বাক্ষর হিসেবে প্রয়োগ করা হয় না।

TLS সমর্থিত hop-গুলোর মধ্যে ট্রানজিটে থাকা ডেটা সুরক্ষিত করে। সাধারণ ইমেইল end-to-end এনক্রিপ্টেড নয়, এবং প্রাপক প্রদানকারী বার্তার বিষয়বস্তু প্রক্রিয়া করতে পারে।

ডেলিভারি ফলাফল

প্রাপক সার্ভার একটি বার্তা গ্রহণ করলেই তা ইনবক্সে পৌঁছানোর প্রমাণ নয়। accepted, deferred, hard bounce, soft bounce, complaint, suppressed, spam placement এবং inbox placement-কে আলাদা আলাদা ফলাফল হিসেবে বিবেচনা করুন।

বর্তমান access model

বর্তমান key srs_live_ ব্যবহার করে। From domain যাচাইয়ের আগে shared sandbox sender শুধু project member-কে পাঠাতে পারে। এরপর plan quota, suppression, recipient throttling ও abuse control প্রযোজ্য। 202 মানে queued, delivered নয়।

ইন্টিগ্রেশন রিসোর্স

মানুষ ও AI agent-এর step-by-step guide ব্যবহার করুন; field-এর source of truth হলো OpenAPI।