دریافت API Key
برای دریافت کلید API ابتدا وارد شوید.
📡 نحوه استفاده از API Key
برای استفاده از API، شما نیاز به یک API Key دارید که مشابه یک رمز عبور عمل میکند و دسترسی شما به سرویس را تأیید میکند. این کلید به شما اجازه میدهد که به دادهها و ویژگیهای مختلف سرویس دسترسی پیدا کنید و تمامی درخواستها باید با استفاده از آن انجام شوند.
📌 چرا از X-API-Key استفاده کنیم؟
X-API-Key یک روش استاندارد برای ارسال کلید احراز هویت است که بسیاری از API ها از آن پشتیبانی میکنند. این روش:
- امنتر از ارسال کلید در پارامترهای URL است.
- درخواستها را سادهتر و خواناتر میکند.
- در بسیاری از API های مدرن توصیه میشود.
🚀 نحوه ارسال API Key در درخواست HTTP
برای ارسال API Key در X-API-Key، کافی است مقدار آن را در بخش headers قرار دهید:
📝 نمونه کد درخواست:
fetch("https://www.world-api.ir/api/v1/countries", {
method: "GET",
headers: {
"X-API-Key": "your-api-key", // 🔴 جایگزینی کلید شما در اینجا
"Accept-Language" : "fa" // en , ar or fa
}
})
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error("Error:", error));
⚠️ نکات امنیتی مهم در استفاده از API Key
- هرگز API Key را در کدهای عمومی (مانند GitHub) قرار ندهید.
- از متغیرهای محیطی (.env) برای نگهداری کلید استفاده کنید.