تقویم شمسی، قمری و میلادی را در وبسایت خود نمایش دهید
از API عمومی امروز برای کاتالوگهای تقویم، برچسبهای رویداد محلیسازیشده، فیدهای تعطیلات و ویجت تقویم قابل جاسازی استفاده کنید. کلیدهای توسعهدهنده محدودیت درخواست بالاتر و مدیریت وبهوک را فعال میکنند.
آدرس پایه
https://api.emrooz.app/api/v1ساخت کلید Developer API
curl -X POST https://api.emrooz.app/api/v1/developer/register \
-H "Content-Type: application/json" \
-d '{
"name": "Calendar Integration",
"email": "[email protected]",
"company": "Example Co",
"website": "https://example.com"
}'فراخوانی endpoint کاتالوگ عمومی با کلید توسعهدهنده
curl https://api.emrooz.app/api/v1/calendar/public-events?locale=en \
-H "X-API-Key: emz_your_api_key_here"| متد | مسیر | توضیح |
|---|---|---|
| POST | /developer/register | یک کلید Developer API میسازد. پاسخ شامل `api_key` فقط برای همان لحظه، پیشوند کلید، پلن و محدودیت درخواست است. |
| GET | /developer/plans | پلنهای توسعهدهنده، محدودیت درخواست و امکانات هر پلن را برمیگرداند. |
| GET | /developer/me | پروفایل کلید فعلی و وبهوکهای فعال را برمیگرداند. به کلید Developer API نیاز دارد. |
| POST | /developer/rotate-key | کلید فعلی را میچرخاند و `api_key` جدید را فقط یک بار برمیگرداند. به کلید Developer API نیاز دارد. |
| GET | /calendar/public-events/manifest | متادیتای کاتالوگ عمومی تقویم، شامل نسخه فعلی و دادههای offset تقویم را برمیگرداند. |
| GET | /calendar/public-events/tags | برچسبهای رویداد عمومی را به زبان انتخابشده برمیگرداند. از پارامتر `locale` پشتیبانی میکند. |
| GET | /calendar/public-events | کاتالوگ منتشرشده رویدادهای عمومی را برمیگرداند. از فیلترهای `locale`، `country_code`، `region` و `tag` پشتیبانی میکند. |
| GET | /feeds/holidays/{country}/{calendar}.ics | فید iCalendar تعطیلات را برمیگرداند. کلید توسعهدهنده فید ترکیبی `country=all` را فعال میکند. |
| POST | /embed/validate-key | یک کلید ویجت `emb_` را برای host اعتبارسنجی میکند و پلن، وضعیت white-label، رنگ accent و سهمیه باقیمانده را برمیگرداند. |
Backend در حال حاضر یک وبهوک تغییر کاتالوگ منتشر میکند. وقتی integration شما باید کش دادههای تقویم عمومی را پس از تغییر نسخه کاتالوگ تازه کند، به آن subscribe کنید.
نام رویداد
calendar.version_bumpزمان اجرا
وقتی نسخه کاتالوگ عمومی تقویم bump میشود اجرا میشود؛ از جمله تغییرات ادمین در کاتالوگ، تغییر offset تقویم قمری و انتشارهای زمانبندیشده.
ساخت subscription وبهوک
curl -X POST https://api.emrooz.app/api/v1/developer/webhooks \
-H "Content-Type: application/json" \
-H "X-API-Key: emz_your_api_key_here" \
-d '{
"url": "https://example.com/webhooks/emrooz",
"event": "calendar.version_bump"
}'نمونه payload ارسالی
{
"event": "calendar.version_bump",
"data": {
"version": 42,
"updated_at": "2026-06-12T15:30:00+00:00",
"events_count": 384
},
"timestamp": "2026-06-12T15:30:01+00:00"
}| متد | مسیر | توضیح |
|---|---|---|
| POST | /developer/webhooks | برای `calendar.version_bump` یک subscription وبهوک میسازد. به پلن توسعهدهنده `calendar_data` نیاز دارد. پاسخ مقدار `secret` را فقط یک بار برمیگرداند. |
| DELETE | /developer/webhooks/{webhook} | یک subscription وبهوک متعلق به کلید توسعهدهنده فعلی را حذف میکند. |
پس از دریافت کلید API، این کد را در هر جایی از صفحه HTML خود قرار دهید:
برای استفاده روی سایتهای دیگر، وجود data-key الزامی است. کلیدهای رایگان فوتر Emrooz را نگه میدارند و کلیدهای حرفهای وایتلیبل و رنگ سفارشی را از سمت سرور فعال میکنند.
<div id="emrooz-widget"></div>
<script src="https://emrooz.app/embed.js"
data-key="emb_your_api_key_here">
</script>ویجت از طریق ویژگیهای data-* و تنظیمات کلید API قابل تنظیم است:
| ویژگی | نوع | پیشفرض | توضیحات |
|---|---|---|---|
| data-theme | "light" | "dark" | "auto" | "auto" | تم رنگی ویجت |
| data-locale | "fa" | "en" | "ar" | "fa" | زبان و نوع ارقام |
| data-target | CSS selector | "#emrooz-widget" | محل نمایش ویجت |
| data-key | string | (required) | کلید API برای سهمیه ماهانه و امکانات ویژه (حذف برند، رنگ سفارشی) |
تم تاریک:
<div id="emrooz-widget"></div>
<script src="https://emrooz.app/embed.js"
data-key="emb_your_api_key_here"
data-theme="dark">
</script>زبان انگلیسی:
<div id="emrooz-widget"></div>
<script src="https://emrooz.app/embed.js"
data-key="emb_your_api_key_here"
data-locale="en"
data-theme="light">
</script>کلید حرفهای:
<div id="emrooz-widget"></div>
<script src="https://emrooz.app/embed.js"
data-key="emb_your_pro_key_here"
data-theme="auto">
</script>
<!-- White-label + accent color are configured on the API key -->ویجت زیر به صورت زنده از emrooz.app بارگذاری میشود:
پلن رایگان برای سایتهای شخصی و پلن حرفهای برای کسبوکارها
رایگان
حرفهای
پیشنهادیاستفاده با کلید API:
<div id="emrooz-widget"></div>
<script src="https://emrooz.app/embed.js"
data-key="emb_your_api_key_here"
data-theme="auto">
</script>