ডেভেলপার: API, ওয়েবহুক আর ক্যারিয়ার এম্বেড

যা তৈরি করতে পারবেন

API রেফারেন্সপ্রতিটি এন্ডপয়েন্ট, তার স্কোপ, ফিল্ড আর একটি curl উদাহরণ সহ, OpenAPI ফাইল থেকে তৈরি।ওয়েবহুকতেরো ধরনের ইভেন্ট আর একটি টেস্ট পিং, HMAC-SHA256 দিয়ে সই করা, প্রায় দুই দিন ধরে আবার চেষ্টা করা হয়।ক্যারিয়ার এম্বেডএকটি script ট্যাগেই আপনার নিজের সাইটে খোলা পদ আর আবেদন ফর্ম।স্ট্যাটাসওয়েবসাইট, অ্যাপ ও API, ইন্টারভিউ আর ব্যাকগ্রাউন্ড জবের এই মুহূর্তের অবস্থা।

বেস URL আর কী

সব কল একটি হোস্টেই যায়। অন্য ডেটা অঞ্চলে রাখা ওয়ার্কস্পেসের নিজস্ব হোস্ট থাকে; ভুল হোস্টে কল গেলে সঠিক ঠিকানা সহ HTTP 308 উত্তর আসে।

বেস URL: https://app.seekiq.io/api/v1
ফরম্যাট: HTTPS-এর ওপর JSON, সময় UTC-তে
কী কোথায় পাবেন: সেটিংস > API আর ওয়েবহুক, মালিক তৈরি করেন
OpenAPI ফাইল: openapi.yaml

কী নিন

ওয়ার্কস্পেসের মালিক হিসেবে সাইন ইন করে সেটিংস > API আর ওয়েবহুক খুলুন।
একটি কী তৈরি করুন, যে সিস্টেম এটি ব্যবহার করবে তার নামে নাম দিন আর শুধু দরকারি স্কোপগুলো বেছে নিন।
কী দেখানোর সময়েই কপি করে নিন। SeekIQ শুধু একটি হ্যাশ আর দৃশ্যমান প্রিফিক্স রাখে, তাই কী একবারই দেখানো হয়।
আপনার সার্ভারে সিক্রেট হিসেবে রাখুন। ব্রাউজার, অ্যাপ বান্ডল বা পাবলিক রিপোজিটরিতে কখনো কী রাখবেন না।

অথেন্টিকেশন

প্রতিটি রিকোয়েস্টে কী-টি bearer টোকেন হিসেবে পাঠান। লাইভ কী শুরু হয় iq_live_ দিয়ে আর টেস্ট কী iq_test_ দিয়ে। দুটোই একই ওয়ার্কস্পেসের ডেটায় কাজ করে; টেস্ট কী-র শুধু রেট লিমিট কম।

curl

curl "https://app.seekiq.io/api/v1/jobs?status=open&limit=10" \
  -H "Authorization: Bearer $SEEKIQ_API_KEY"

কী দুই ধরনের। সার্ভিস কী পুরো ওয়ার্কস্পেসের হয়ে কাজ করে। ইউজার-অ্যাট্রিবিউটেড কী একজন নির্দিষ্ট সদস্যের হয়ে কাজ করে: প্রতিটি পরিবর্তন সেই ব্যক্তির নামে অডিট হয়, আর তাঁর বর্তমান রোল ঠিক করে কী-টি কতটা করতে পারবে।

প্রতিটি কী-র সঙ্গে স্কোপ থাকে, যেমন jobs:read, applications:write বা webhooks:manage। এর বাইরের রিকোয়েস্টে উত্তর আসে 403 insufficient_scope। রেফারেন্সে প্রতিটি এন্ডপয়েন্টের পাশে তার দরকারি স্কোপ লেখা আছে।

403 insufficient_scope

{
  "error": {
    "code": "insufficient_scope",
    "message": "This key does not have jobs:write",
    "details": null,
    "request_id": "req_01JB7X4M2Q8Z3K4P"
  }
}

রেট লিমিট

লিমিট প্রতিটি কী-র জন্য আলাদা, স্লাইডিং উইন্ডো হিসেবে। প্রতিটি রেসপন্সে RateLimit-Limit, RateLimit-Remaining আর RateLimit-Reset থাকে; HTTP 429 হলে সঙ্গে সেকেন্ডে Retry-After যোগ হয়।

লাইভ কী: মিনিটে ৬০০ রিকোয়েস্ট, যেকোনো ১০ সেকেন্ডে সর্বোচ্চ ১০০
টেস্ট কী: মিনিটে ১২০ রিকোয়েস্ট
রাইট: দুই ধরনের কী-তেই মিনিটে ১২০
বাদ দেওয়া: প্রতি কী-তে ঘণ্টায় ২০

HTTP

HTTP/1.1 200 OK
Content-Type: application/json
RateLimit-Limit: 600
RateLimit-Remaining: 587
RateLimit-Reset: 23
SeekIQ-Request-Id: req_01JB7X4M2Q8Z3K4P

POST রিকোয়েস্টে একটি Idempotency-Key হেডার (একটি UUID) পাঠান। একই কী দিয়ে আবার চেষ্টা করলে ২৪ ঘণ্টা পর্যন্ত দুবার কাজ না করে প্রথম উত্তরটিই ফেরত আসে।

ভার্সনিং

ভার্সন থাকে পাথে। নতুন ফিল্ড, এন্ডপয়েন্ট, ইভেন্ট টাইপ আর enum মান যেকোনো সময় আসতে পারে, তাই অচেনা ফিল্ড উপেক্ষা করুন আর নতুন মান মেনে নিন। কোনো ভাঙন ধরানো পরিবর্তন এলে নতুন ভার্সন হয়; যে এন্ডপয়েন্ট বন্ধ হতে যাচ্ছে সেটি অন্তত ছয় মাস আগে থেকে Deprecation আর Sunset হেডার পাঠায়।

প্রতিটি রেসপন্সে SeekIQ-Request-Id থাকে। সাপোর্টে লেখার সময় এটি উল্লেখ করুন।

সিদ্ধান্ত মানুষের হাতে

এগিয়ে নেওয়া, আটকে রাখা আর বাদ দেওয়া হয় decisions এন্ডপয়েন্টে ইউজার-অ্যাট্রিবিউটেড কী দিয়ে, তাই প্রতিটি সিদ্ধান্ত একজন মানুষের নামে রেকর্ড হয়। সার্ভিস কী সিদ্ধান্ত নিতে পারে না। এআই-এর মান সবসময় প্রমাণ সহ আসে, কখনো শুধু একটি সংখ্যা হিসেবে নয়।

এক্সটেনশন আর মোবাইল

ব্রাউজার এক্সটেনশন

রিক্রুটারদের জন্য SeekIQ, Chrome-এ চাকরির পোস্ট লেখায় সাহায্য আর এক ক্লিকে প্রার্থী সেভ করার সুবিধা যোগ করে। এটি রিক্রুটারের নিজের SeekIQ অ্যাকাউন্টে সাইন ইন করে, কোনো API কী লাগে না।

Chrome Web Store-এ খুলুন

রিক্রুটার অ্যাপ

রিক্রুটার অ্যাপ নিজস্ব ফার্স্ট-পার্টি API ব্যবহার করে। এটি অন্য ক্লায়েন্টের জন্য খোলা নয়; ইন্টিগ্রেশন তৈরি করুন এই পেজের পাবলিক API দিয়ে।

API নিয়ে প্রশ্ন আছে? support@fastflowup.com ঠিকানায় লিখুন।

SeekIQ-এর ওপর তৈরি করুন। চাকরি সিঙ্ক করুন, আবেদনকারী পাঠান আর নিয়োগের প্রতিটি ধাপে সাড়া দিন।