POST/v2/auth/token

auth-token (API)

অ্যাকসেস কী ও সিক্রেটের বদলে বিয়ারার টোকেন নিন। রিফ্রেশ কুকি নেই।

টোকেন লাগে নাঅথরিটি: permitAllhttps://api1.vacaychi.com/user

এটি একটি API ইন্টিগ্রেশনের একমাত্র লগইন। ইমেইল ও পাসওয়ার্ড গ্রহণ করা হয় না। BlueTech অ্যাকসেস কী ও সিক্রেট একবার দেয়, এমন অ্যাকাউন্টের বিপরীতে যার একমাত্র রোল টাইপ API_CLIENT এবং যার কাছে B2C_API_LOGIN আছে। রিকোয়েস্ট অবশ্যই সেই ক্লায়েন্টের অ্যালাউ-লিস্টের আইপি থেকে আসতে হবে।

অ্যাকসেস টোকেন সেই যুক্ত ইউজারের একটি JWT। পরের প্রতিটি কলে Authorization: Bearer হিসেবে পাঠান। মেয়াদ শেষ হলে এই এন্ডপয়েন্ট আবার কল করুন। POST /v2/auth/refresh এই অ্যাকাউন্ট মানে না।

cURL

bash

curl -X POST https://api1.vacaychi.com/user/v2/auth/token \
  -H "Content-Type: application/json" \
  -d '{"accessKey":"ak_…","secret":"sk_…"}'

হেডার

Content-Typeapplication/json

আবশ্যক

JSON বডি

Content-Type

application/json

আবশ্যক

JSON বডি

রিকোয়েস্ট

JSON

{
  "accessKey": "ak_…",
  "secret": "sk_…"
}

বডি ফিল্ড

accessKeystring

আবশ্যক

ক্লায়েন্ট অ্যাকসেস কী, উপসর্গ ak_

secretstring

আবশ্যক

ক্লায়েন্ট সিক্রেট, উপসর্গ sk_। ক্লায়েন্ট তৈরির সময় একবার দেখানো হয়।

`accessKey` string আবশ্যক	ক্লায়েন্ট অ্যাকসেস কী, উপসর্গ ak_
`secret` string আবশ্যক	ক্লায়েন্ট সিক্রেট, উপসর্গ sk_। ক্লায়েন্ট তৈরির সময় একবার দেখানো হয়।

রেসপন্স

200

{
  "message": "Success",
  "data": {
    "accessToken": "eyJhbGciOiJSUzI1NiIs...",
    "expiresIn": 600
  },
  "error": null
}

রেসপন্স ফিল্ড

accessTokenstring

অন্য প্রতিটি এন্ডপয়েন্টের জন্য বিয়ারার টোকেন

expiresInnumber

অ্যাকসেস টোকেনের আয়ু সেকেন্ডে। শেষ হলে এই এন্ডপয়েন্ট আবার কল করুন। রিফ্রেশ টোকেন নেই।

`accessToken` string	অন্য প্রতিটি এন্ডপয়েন্টের জন্য বিয়ারার টোকেন
`expiresIn` number	অ্যাকসেস টোকেনের আয়ু সেকেন্ডে। শেষ হলে এই এন্ডপয়েন্ট আবার কল করুন। রিফ্রেশ টোকেন নেই।

বিজনেস রুল

সিক্রেট হ্যাশ হিসেবে রাখা হয়। ভুল কী ও ভুল সিক্রেট আলাদা চেনা যায় না।
allowedIps একটি হুবহু IPv4 বা IPv6 ঠিকানা, অথবা 203.0.113.0/24-এর মতো IPv4 CIDR। খালি তালিকা দিয়ে লগইন হয় না। 127.0.0.1 ও ::1 একই ঠিকানা।
এই অ্যাকসেস টোকেন পাঠানো পরের প্রতিটি /v2 কলে একই অ্যালাউ-লিস্ট চেক হয়, ইউজার সার্ভিস ও বুকিং সার্ভিস দুটোতেই। ক্লায়েন্ট নিষ্ক্রিয়, তালিকা বদল, বা আর অনুমোদিত নয় এমন আইপি থেকে কল — টোকেন মেয়াদোত্তীর্ণ না হলেও ৪০১।
B2C_API_LOGIN এই এন্ডপয়েন্টকে টোকেন ইস্যু করতে দেয়। এটি নিজে সার্চ, কার্ট বা টিকেটিং অনুমোদন করে না। সেই কলগুলোর জন্য একই রোলে মিলিত বি২সি অথরিটি লাগে।

এরর

400validation failed

accessKey বা secret নেই

401Invalid Credentials

অজানা কী, ভুল সিক্রেট, আইপি অনুমোদিত নয়, ক্লায়েন্ট বা যুক্ত ইউজার নিষ্ক্রিয়, ইউজার শুধু API_CLIENT নয়, অথবা ইউজারের B2C_API_LOGIN নেই। প্রতিটি ব্যর্থতা এই একটি বার্তা ব্যবহার করে।

HTTP	message	কখন
400	validation failed	accessKey বা secret নেই
401	Invalid Credentials	অজানা কী, ভুল সিক্রেট, আইপি অনুমোদিত নয়, ক্লায়েন্ট বা যুক্ত ইউজার নিষ্ক্রিয়, ইউজার শুধু API_CLIENT নয়, অথবা ইউজারের B2C_API_LOGIN নেই। প্রতিটি ব্যর্থতা এই একটি বার্তা ব্যবহার করে।