نحوه احراز هویت درخواستهای شما به API راهیانا با استفاده از کلیدهای API.
تمامی درخواستها به API راهیانا باید با استفاده از یک کلید API معتبر احراز هویت شوند. کلید API شما باید در هدر
Authorization
Bearer
Authorization: Bearer YOUR_API_KEY
شما میتوانید کلیدهای API خود را از بخش کلیدها در پنل کاربری خود دریافت و مدیریت کنید.
HTTP-Referer
X-Title
برای کمک به شناسایی، ردیابی بهتر درخواستهای برنامهتان، و اطمینان از سازگاری در آینده، به شدت توصیه میشود هدرهای زیر را در تمام درخواستهای API خود ارسال کنید:
HTTP-Referer
(مثال:
https://my-awesome-app.com
دلیل اهمیت: به ما در تشخیص منبع درخواستها، مانیتورینگ بهتر و ارائه پشتیبانی دقیقتر کمک میکند.
X-Title
(مثال:
My Awesome App v1.2
دلیل اهمیت: مشابه HTTP-Referer، این هدر به شناسایی و دستهبندی بهتر لاگها و درخواستها کمک کرده و در صورت نیاز به ارتباط با شما، مفید خواهد بود.
curl -X POST "https://rahyana.ir/api/v1/auth/token" -H "Content-Type: application/json" -d '{
"grant_type": "client_credentials",
"client_id": "YOUR_CLIENT_ID",
"client_secret": "YOUR_CLIENT_SECRET"
}'
شما میتوانید چندین کلید API برای حساب خود ایجاد کرده و هر کدام را با نامی دلخواه برای شناسایی بهتر مشخص کنید. هر کلید API ممکن است دارای محدودیتهای استفاده (مانند تعداد درخواست در دقیقه یا میزان مصرف توکن) باشد.
برای اطلاعات دقیقتر درباره محدودیتها، به صفحه محدودیتهای API مراجعه کنید.