تطبیق تاریخ و تقویم · زیرساخت زمان برای توسعه‌دهندگان

تطبیق تاریخ و زمان؛ یک روز، چند تقویم، بدون مغایرت.

تاریخ‌های شمسی، میلادی و قمری را فقط تبدیل نکنید؛ روزها را تطبیق دهید، اختلاف‌ها را تشخیص دهید و روز هفته، تعطیلات و روز کاری را با دادهٔ نسخه‌دار بررسی کنید.

تطبیق تاریخ از API و SDK با شناسهٔ درخواست و نسخهٔ داده؛ برای ساخت و یکپارچه‌سازی می‌توانید همین حالا ثبت‌نام کنید و پس از تأیید ایمیل، کلید تست ۳۰روزه بگیرید. ویجت‌های نمایشی سایت هنوز جایگزین اتصال واقعی API نیستند.

بدون کارت بانکی · ثبت‌نام مستقیم · کلید تست ۳۰روزه پس از تأیید ایمیل

آزمایشگاه تاریخ را باز کنید

کنسول زیرساخت زمان
خواندن تاریخموتور تقویم
۱۴۰۵/۰۷/۱۹، ساعت ۱۰:۰۰به وقت تهران۳ روز کاری بعد

روی زبانه‌ها بزنید یا عبارت را خودتان بنویسید.

چرا به ما بسپارید؟

مدیریت تاریخ و زمان در یک محصول واقعی، پیچیده‌تر از چیزی است که به نظر می‌رسد.

هر تیمی که برای کاربران ایرانی نرم‌افزار می‌سازد، زود با این پرسش‌های تکراری روبه‌رو می‌شود:

  • آیا این دو تاریخ شمسی و میلادی واقعاً به یک روز اشاره دارند؟
  • اگر منبع تقویم یا نسخهٔ داده عوض شد، مغایرت تاریخ و روز هفته را چطور تشخیص دهیم؟
  • فهرست تعطیلات را به‌روز نگه دار.
  • روز کاری را درست بشمار.
  • منطقهٔ زمانی را فراموش نکن.
  • رویدادهای تکرارشونده را پیاده کن.
  • اجازه نده یک نوبت هم‌زمان به دو نفر اختصاص یابد.
  • اگر سررسید به تعطیلی خورد، چه باید کرد؟
  • از ارسال دوبارهٔ یک یادآور جلوگیری کن.
  • اگر وب‌هوک به مقصد نرسید، ارسال دوباره را مدیریت کن.
  • عامل هوشمند فقط در حد اختیارش کار کند.

همین نیازهای به‌ظاهر کوچک، به‌مرور به سامانه‌ای پیچیده تبدیل می‌شوند که به نگهداری مداوم نیاز دارد.

زیرساخت زمانِ دست‌ساز

قبل

محصول شما
  • کتابخانهٔ تاریخ شمسی
  • فایل دستی تعطیلات
  • کارهای زمان‌بندی‌شدهٔ سرور
  • جدول‌های رزرو
  • سرویس یادآور
  • همگام‌سازی تقویم
  • منطق سررسید سفارشی
  • زمان‌بندی عامل‌ها

بعد

محصول شما
تقویم.dev™
  • تقویم
  • زمان‌بندی
  • سررسید
  • رزرو
  • عامل‌ها

زیرساخت زمان

نه فقط «API تقویم»؛ زیرساخت زمان.

تبدیل تاریخ فقط آغاز کار است. هدف ما ارائهٔ مدلی هماهنگ برای تقویم، روزهای کاری و زمان‌بندی در محصول شماست.

تقویم.dev™زیرساخت زمان

تقویم

نمونهتاریخ نمونه۳۰ آبان ۱۴۰۵

زمان‌بندی

نمونهنخستین روز کاری پیش رویکشنبه ۱ آذر ۱۴۰۵

اجرا

نمونهاجرای بعدی «هر روز کاری، ساعت ۱۸»۱۴۰۵/۰۹/۰۱، ساعت ۱۸:۰۰

روی هر قابلیت بزنید تا نمونهٔ تعاملی آن را ببینید.

یک مدل زمانی و چند رابط؛ بی‌آنکه منطق زمان در هر محصول از نو نوشته شود.

رابط‌ها

یک موتور، با هر رابطی که لازم دارید.

API

REST API نسخه‌دار برای همهٔ اجزای پایهٔ زمان و زمان‌بندی.

http
POST /v1/dates/resolve
POST /v1/business-days/add
POST /v1/deadlines
POST /v1/schedules/preview
پاسخ موتور
مرجع تعاملی API

SDK

نمونه‌کدهای JavaScript و Python برای شروع فراهم‌اند؛ عرضهٔ SDK رسمی و نسخه‌دار به تکمیل آزمون‌ها وابسته است.

ts
import { createTestClient } from "@taghvim/sdk";
const client = createTestClient({ apiKey: process.env.TAGHVIM_TEST_API_KEY });
const result = await client.addBusinessDays({date: "1405-07-15", days: 30});
console.log(result.data.result.jalali);
پاسخ موتور
ویرایشگر نمونه

CLI

رابط خط فرمان در نقشهٔ محصول قرار دارد؛ وضعیت عرضهٔ آن پیش از استفادهٔ عملی اعلام می‌شود.

bash
taghvim date resolve "سه روز کاری بعد"
taghvim availability find
taghvim sandbox clock advance 3d
پاسخ موتور
خط فرمان نمونه

MCP

ابزارهای برنامه‌ریزی‌شده برای عامل‌های هوشمند، با اختیار و دامنهٔ دسترسی مشخص.

text
taghvim_find_availability
taghvim_create_reservation
taghvim_create_deadline
taghvim_create_schedule
پاسخ موتور
عامل را امتحان کنید

ویجت‌ها

اجزای آمادهٔ راست‌به‌چپ با تقویم شمسی، برای جاسازی مستقیم در محصول.

  • انتخابگر تاریخ
  • ویجت رزرو
  • ویجت سررسید
ویجت‌ها را ببینید

وب‌هوک‌ها

ارسال رویدادهای زمانی با امضا، پیگیری تحویل و تلاش دوباره؛ استفادهٔ عملیاتی به فعال‌سازی مجاز نیاز دارد.

json
{
  "id": "evtlog_…",
  "type": "taghvim.event.reservation.confirmed.v1"
}
پاسخ موتور
رویدادها و وب‌هوک‌ها

ویجت‌ها

رابط کاربری آماده، و کنترل همچنان در دست شما.

ویجت‌ها را در همین صفحه امتحان کنید. برای اتصال به محصول خودتان، پس از دریافت دسترسی تأییدشده می‌توانید از API استفاده کنید. وضعیت عرضهٔ ویجت‌های قابل‌نصب و SDK جداگانه اعلام می‌شود.

انتخابگر تاریخنمونهٔ تعاملی با موتور تقویم

ویجت الف: انتخاب تاریخ شمسی؛ روز انتخاب‌شده اناری است و تعطیلی با نقطه نشان داده می‌شود.

رزرو نوبتنمونه

روزهای کاری پیش روموتور تقویم

تاریخ۱۴۰۵/۰۹/۰۱

  1. آزاد
  2. رزرو موقت ۱۰:۰۰
  3. تأیید
  4. رسید

ویجت ب: روزها را موتور تقویم می‌دهد و تعطیلی‌ها کنار می‌روند؛ ساعت‌های آزاد نمونه‌اند.

محاسبهٔ سررسیدنمونهٔ تعاملی با موتور تقویم
۱۵ مهر ۱۴۰۵

نتیجه۲۰ آبان ۱۴۰۵

ویجت ج: با موتور تقویم؛ تاریخ و فاصله را تغییر دهید.

ساعت‌های کاری هفتهنمونه
  • شنبه۰۹:۰۰۱۷:۰۰
  • یکشنبه۰۹:۰۰۱۷:۰۰
  • دوشنبهتعطیل
  • سه‌شنبه۱۰:۰۰۱۴:۰۰
  • چهارشنبه۰۹:۰۰۱۷:۰۰

ویجت د: ساعت‌های در دسترس هر روز (نمونه).

برنامهٔ زمانی عاملنمونهٔ تعاملی با موتور تقویم
تکرار
هر روز کاری
ساعت
۱۸:۰۰
منطقهٔ زمانی
تهران
مقصد
عامل تطبیق حساب‌ها
سقف مصرف
۱٬۰۰۰ عملیات در هر اجرا

اجرای بعدی۱۴۰۵/۰۸/۳۰، ساعت ۱۸:۰۰

ویجت هـ: اجرای بعدی را موتور روز کاری حساب می‌کند.

نشان‌های کوچکنمونهٔ تعاملی با موتور تقویم

امروزشنبه ۳۰ آبان ۱۴۰۵روز کاری

شمسی، میلادی و قمری (ام‌القری)۳۰ آبان ۱۴۰۵۲۱ نوامبر ۲۰۲۶۱۱ جمادی‌الثانی ۱۴۴۸

تعطیلی رسمی بعدی۳۲ روز دیگر: ولادت امام علیچهارشنبه ۲ دی ۱۴۰۵ (پیش‌بینی)

نمونهٔ اتصال SDK
import { createBrowserWidgetClient } from "@taghvim/sdk/widgets";
// Requires an authorized same-origin application gateway.
const result = await createBrowserWidgetClient().invoke("business-day-badge",
  {date: "1405-07-15"});

ویجت و: سه نشان زنده برای کنار فرم‌ها و فاکتورها، با دادهٔ موتور تقویم.

موتور تقویم

هسته‌ای مطمئن برای تاریخ‌های ایران.

موتور تقویم پایهٔ همه‌چیز است، نه فقط ابزاری برای قالب‌بندی تاریخ.

  • شمسی، میلادی، قمری
  • حساب تاریخ
  • قالب‌بندی فارسی
  • ارقام فارسی
  • منطقهٔ زمانی ایران
  • قاعدهٔ سال کبیسه
  • تعطیلات و مناسبت‌ها
  • شمارش روز کاری
  • تقویم اختصاصی سازمان
  • بسته‌های تقویم
  • پروفایل‌های مالی، حقوق و بانکی
مبدل تاریخموتور تقویم
شمسی

۱۵ مهر ۱۴۰۵

میلادی

۷ اکتبر ۲۰۲۶

قمری (ام‌القری)

۲۶ ربیع‌الثانی ۱۴۴۸

روز هفته
چهارشنبه
وضعیت
روز کاری
تاریخ میلادی (ISO)
۲۰۲۶-۱۰-۰۷
منطقهٔ زمانی
تهران
بستهٔ تقویم
iran-2026.10.01

هر یک از سه تاریخ را تغییر دهید تا موتور دو تای دیگر را حساب کند. تاریخ قمری به روش ام‌القری است؛ تعطیلات قمری ایران تا اعلام رسمی پیش‌بینی‌اند و ممکن است یک روز جابه‌جا شوند.

آزمایشگاه تاریخموتور تقویم

    نتیجه

    ۱۴۰۵/۰۷/۱۹، ساعت ۱۰:۰۰

    یکشنبه ۱۹ مهر ۱۴۰۵

    2026-10-11T10:00:00+03:30[Asia/Tehran]

    تبدیل تاریخ میان شمسی، میلادی و قمری (با ارقام فارسی یا لاتین) کار خود موتور تقویم است. موتور هنوز زبان طبیعی فارسی را کامل نمی‌فهمد؛ این آزمایشگاه فقط این الگوها را روی آن می‌سازد: «N روز (کاری) بعد/قبل از …»، «امروز/فردا/پس‌فردا/دیروز» و «ساعت HH:MM». هر عبارت دیگری را صادقانه «نامفهوم» اعلام می‌کند.

    روزهای کاری

    «۳۰ روز بعد» و «۳۰ روز کاری بعد» یک چیز نیستند.

    وقتی پای قرارداد، پرداخت، SLA، تسویه، حقوق یا مقررات در میان است، شمردن روز کاری دیگر یک تابع کمکی ساده نیست.

    ۳۰ روز بعدشنبه ۱۶ آبان ۱۴۰۵
    ۳۰ روز کاری بعدچهارشنبه ۲۰ آبان ۱۴۰۵

    روز کاریجمعهتعطیل رسمیسررسید

    نمونهٔ درخواست API
    POST /v1/business-days/add
    {
      "date": "1405-07-15",
      "days": 30
    }
    • سررسیدهای کم‌خطاتر
    • حذف منطق تکراری از سرویس‌ها
    • تغییر قاعده‌ها بی‌آنکه محصول بازنویسی شود
    • محاسبه‌های حساس، قابل حسابرسی

    تعطیلات و مناسبت‌ها

    موتور تقویم

    اکتبر تا نوامبر ۲۰۲۶۲۴ روز کاری، ۱ تعطیل رسمی

    آبان ۱۴۰۵
    شیدسچپج
    ۱
    ۲۳۴۵۶۷۸
    ۹۱۰۱۱۱۲۱۳۱۴۱۵
    ۱۶۱۷۱۸۱۹۲۰۲۱۲۲
    ۲۳۲۴۲۵۲۶۲۷۲۸۲۹
    ۳۰
    1. ۲۳شهادت حضرت فاطمه زهرا (پیش‌بینی)

    تعطیل رسمیتعطیلی قمری (پیش‌بینی)جمعهامروز

    دریافت تعطیلات ۱۴۰۵ (فایل ICS)

    موتور زمان‌بندی

    زمان‌بندی برای همه‌چیز، نه فقط جلسه‌ها.

    «منبع» می‌تواند شخص، اتاق، خودرو، دستگاه یا سرویس باشد؛ هر چیزی که برای آن ظرفیت و بازهٔ زمانی تعریف می‌شود.

    1. منبع
    2. قاعده‌های دسترس‌پذیری
    3. نوبت‌های پیشنهادی
    4. محدودیت‌ها
    5. رزرو موقت
    6. رزرو
    7. رویداد
    • تقویم هر منبع
    • ظرفیت
    • فاصله میان نوبت‌ها
    • بازه‌های بسته
    • هم‌پوشانی چند منبع
    • رزرو موقت
    • جلوگیری از تداخل
    • دسترس‌پذیری تکرارشونده
    • جابه‌جایی نوبت
    • قاعده‌های لغو
    نوبت۱۰:۰۰
    کاربر الفرزرو موقت را گرفت
    کاربر باین نوبت گرفته شده استگزینه‌های بعدی: ۱۰:۳۰ ۱۱:۳۰
    درخواست‌های هم‌زمان نباید به دو رزرو برای یک نوبت برسند.
    سازندهٔ قاعدهٔ تکرارموتور تقویم

    آخرین روز کاری هر ماه، ساعت ۰۹:۰۰

    شش نوبت بعدی

    1. شنبه ۳۰ آبان ۱۴۰۵
    2. دوشنبه ۳۰ آذر ۱۴۰۵
    3. چهارشنبه ۳۰ دی ۱۴۰۵
    4. پنجشنبه ۲۹ بهمن ۱۴۰۵۱ روز زودتر، به‌خاطر تعطیلی
    5. پنجشنبه ۲۷ اسفند ۱۴۰۵۲ روز زودتر، به‌خاطر تعطیلی
    6. سه‌شنبه ۳۱ فروردین ۱۴۰۶
    درخواست API (JSON)
    POST /v1/schedules/preview
    {
      "rule": "last-business",
      "from": "1405-08-30",
      "count": 6
    }

    موتور سررسید

    سررسید فقط یک ستون تاریخ در جدول نیست.

    سررسید را می‌شود از یک تاریخ ثابت، یک رویداد، شمار روزهای کاری، سیاست سازمان یا حتی یک سند ورودی حساب کرد.

    1. رویداد مبنا۱۴۰۵/۰۷/۱۵
    2. فاصله۳۰ روز کاری
    3. بستهٔ تقویم ایرانiran-2026.10.01
    4. اگر تعطیل بودروز کاری بعد
    5. سررسید نهایی۱۴۰۵/۰۸/۲۰

    کاربردها

    • سررسید صورت‌حساب
    • مهلت‌های SLA
    • تمدید قرارداد
    • مهلت‌های قانونی
    • مهلت بستن حقوق
    • بازه‌های تسویه
    • تاریخ بازبینی انطباق
    • مرحله‌های درمان و کارآزمایی
    مهلت SLA به ساعت کاریموتور تقویم

    پایان مهلتدوشنبه ۲۰ مهر ۱۴۰۵، ساعت ۱۰:۰۰

    ساعت‌ها نمونه‌اند و تغییرپذیر؛ روزهای کاری و تعطیلات از موتور تقویم (پروفایل بانکی، جمعه تعطیل).

    پیش‌نمایش یادآورهاموتور تقویم
    یادآورها

      یادآوری که به روز تعطیل بخورد، به روز کاری قبل می‌رود؛ هیچ یادآوری دو بار فرستاده نمی‌شود.

      گردش‌کارها

      چند قدم، یک تقویم؛ تاریخ همهٔ قدم‌ها با هم جابه‌جا می‌شود.

      هر قدم نسبت به قدمی دیگر تعریف می‌شود: چند روز کاری پس از تأیید، یا ده روز تقویمی پس از آن. تاریخ شروع، فاصله‌ها یا قاعدهٔ تعطیلی را تغییر دهید و «اجرا» را بزنید تا موتور تقویم همهٔ قدم‌ها را دوباره بچیند.

      سازنده‌ی گردش‌کار: از تأیید قرارداد تا تسویهموتور تقویم
      1. ۱
        تأیید قراردادروز شروع؛ اگر تعطیل باشد، روز کاری بعد.
        دوشنبه ۱۲ بهمن ۱۴۰۵
      2. ۲
        سررسید پرداختده روز تقویمی پس از تأیید؛ اگر به تعطیلی بخورد، طبق قاعده جابه‌جا می‌شود.
        نسبت به: تأیید قرارداد
        شنبه ۲۴ بهمن ۱۴۰۵۲۲ بهمن ۱۴۰۵ تعطیل است (پیروزی انقلاب اسلامی)؛ به شنبه ۲۴ بهمن ۱۴۰۵ منتقل شد
      3. ۳
        یادآوردو روز کاری پیش از سررسید.
        نسبت به: سررسید پرداخت
        سه‌شنبه ۲۰ بهمن ۱۴۰۵
      4. ۴
        تسویهیک روز کاری پس از سررسید.
        نسبت به: سررسید پرداخت
        یکشنبه ۲۵ بهمن ۱۴۰۵

      همان درخواست به API
      POST /v1/workflow-runs/preview
      {
        "start": "1405-11-12",
        "roll": "following",
        "steps": [
          {
            "id": "approve",
            "offset": 0,
            "unit": "business"
          },
          {
            "id": "due",
            "offset": 10,
            "unit": "calendar",
            "relative_to": "approve"
          },
          {
            "id": "remind",
            "offset": -2,
            "unit": "business",
            "relative_to": "due"
          },
          {
            "id": "settle",
            "offset": 1,
            "unit": "business",
            "relative_to": "due"
          }
        ]
      }

      زمان‌بندی عامل‌ها و MCP

      عامل‌های هوشمند هم به زمان‌بندی درست نیاز دارند.

      برای فعالیت زمان‌بندی‌شدهٔ عامل‌های هوشمند باید بتوان برنامه، سطح دسترسی، سقف مصرف و سابقهٔ اجرا را مشاهده و بررسی کرد.

      خودکارسازی با عامل‌ها بدون زمان‌بندی قابل نظارت، زیرساخت عملیاتی نیست.

      عامل
      پیگیری وصول مطالبات
      برنامه
      هر روز کاری، ساعت ۰۹:۰۰
      دامنه
      فضای کاری وصول مطالبات
      ابزارها
      ۴
      سقف مصرف
      ۵۰۰ عملیات در هر اجرا
      آخرین اجرا
      موفق
      اجرای بعدی
      ۱۴۰۵/۰۸/۳۰، ساعت ۰۹:۰۰
      1. زمان اجرا رسید
      2. بررسی سیاست
      3. کنترل سقف مصرف
      4. محیط اجرای عامل
      5. ابزارهای MCP
      6. رسید اجرا

      دادهٔ نمایشی؛ اجرای بعدی را موتور روز کاری حساب می‌کند.

      گفت‌وگو با عامل (نمونه)نمونه

      یکی از درخواست‌ها را انتخاب کنید تا فراخوانی ابزارها را ببینید.

        رویدادها و وب‌هوک‌ها

        وقتی زمانِ چیزی تغییر می‌کند، سامانهٔ شما هم باید باخبر شود.

        هر تغییر مهم زمانی می‌تواند رویدادی قابل‌پیگیری ایجاد کند و در صورت فعال‌بودن اتصال، به سامانهٔ شما اعلام شود.

        تقویم.dev™
        • ERP
        • CRM
        • پرداخت
        • عامل هوشمند
        • انبار داده
        • اپلیکیشن داخلی
        روی هر رویداد بزنید تا ببینید به کجا می‌رسد.
        • تحویل امضاشده
        • تلاش دوباره
        • سابقهٔ تحویل
        • بازپخش
        • ایمن در برابر تکرار
        • محتوای نسخه‌دار
        سابقهٔ تحویل یک وب‌هوکنمونه

          نمونه؛ زمان‌ها به وقت تهران، از همین لحظه

          خط پردازش رویدادها

          هر رویداد اول از قاعده‌های تقویم می‌گذرد، بعد به مقصد می‌رسد.

          رویدادها از فرم، API یا وب‌هوک ورودی می‌رسند؛ موتور تقویم منطقهٔ زمانی، تعطیلات و روز کاری را بررسی می‌کند و بعد اعلان، وب‌هوک یا رویداد تقویم ساخته می‌شود. یک رویداد بفرستید و مسیرش را دنبال کنید.

          خط پردازشموتور تقویم

          گزارش اجرا

          1. هنوز رویدادی فرستاده نشده است.
          رویداد در دقیقهتأخیر (میلی‌ثانیه)

          نمونه: تصمیم‌های زمانی را موتور تقویم می‌گیرد؛ بار و تأخیر نمایشی‌اند.

          مرکز اعلان‌ها

          اعلانی که تقویم را می‌شناسد.

          یادآورها، سررسیدها و تحویل وب‌هوک‌ها، با تاریخ‌هایی که موتور تقویم حساب می‌کند. هر دکمه یک اعلان واقعی روی همین صفحه می‌سازد.

          یک اعلان بسازیدموتور تقویم

          اعلان‌ها واقعی‌اند؛ متن و شماره‌ها نمونه‌اند.

            پیش‌نمایش روی گوشی

            تاریخچه‌ی اعلان‌ها
            1. هنوز اعلانی نیامده است. یکی از دکمه‌ها را بزنید.

            جست‌وجو، شواهد و رسیدها

            بدانید چه شد، چرا شد، و بر پایهٔ چه.

            ثبت رسید، سابقه و شواهد برای عملیات حساس در طراحی پیش‌بینی شده است؛ فعال‌بودن آن باید در محیط واقعی تأیید شود.

            جست‌وجونمونه

            فیلترها

            فضای کاری
            حقوقی
            نوع
            سررسید
            وضعیت
            فعال
            موعد
            این هفته

            سابقه‌ی رویدادهای یک رزرو

            1. رزرو موقت ساعت ۱۰:۰۰ گرفته شدtaghvim.event.reservation.held.v1
            2. رزرو تأیید شدtaghvim.event.reservation.confirmed.v1
            3. رسید صادر شدtaghvim.event.receipt.issued.v1
            4. یادآور برای روز کاری قبل تنظیم شدtaghvim.event.reminder.scheduled.v1
            5. وب‌هوک به سامانه‌ی کلینیک تحویل شدtaghvim.event.webhook.delivered.v1
            رسید رزرونمونه
            وضعیت
            تأییدشده
            انجام‌دهنده
            usr_123
            سیاست
            booking-v3
            منبع
            doctor_1
            زمان
            ۱۰:۰۰ تا ۱۰:۳۰
            رویداد
            evtlog_7f3a…
            رسید
            rcpt_92c1…

            یکپارچه‌سازی

            به سامانه‌های موجود وصل شوید، بی‌آنکه به آن‌ها گره بخورید.

            مدل زمانی مشترک، مبنای اتصال سامانه‌های مختلف است؛ هر اتصال‌دهنده باید جداگانه آزموده و تأیید شود.

            تقویم.dev™
            مدل مرجع
            ICSوضعیت: فعال

            خروجی یک‌طرفه؛ فایل تعطیلات ۱۴۰۵ همین حالا با موتور تقویم ساخته شده و دریافت‌شدنی است.

            روی هر اتصال بزنید تا جزئیاتش را ببینید.

            نخستین یکپارچه‌سازی‌ها

            • ICS
            • CalDAV
            • تقویم گوگل
            • تقویم مایکروسافت (Outlook)
            • وب‌هوک‌ها
            • اعلان ایمیلی
            • درگاه پرداخت برای صورت‌حساب‌های ما
            فایل ICS واقعی: تعطیلات رسمی ۱۴۰۵همین حالا با موتور تقویم ساخته شده؛ در هر برنامهٔ تقویمی وارد کنید.

            اتصال‌دهنده‌ها، بسته‌های تقویم، گردش‌کارها و ویجت‌های بیشتر از بازارچه نصب می‌شوند؛ اما برای شروع به بازارچه نیازی نیست.

            یک‌بار بسازید

            یک‌بار تعریف کنید، همه‌جا به کار ببرید.

            مدل مرجع زمان
            REST API
            POST /v1/business-days/add
            { "date": "1405-08-30", "days": 3 }

            همه یک پاسخ می‌گیرند: سه‌شنبه ۳ آذر ۱۴۰۵

            روی هر رابط بزنید تا همان کار را در آن رابط ببینید.

            API، MCP و ویجت سه محصول جدا نیستند؛ سه رابط روی یک موتورند. برای همین رفتار و معنای هر عملیات همه‌جا یکسان است.

            شروع برای توسعه‌دهندگان

            سه قدم تا نخستین پاسخ.

            1. ۱پروژه بسازید

              text
              Project: my-app
              Environment: sandbox
              Locale: fa-IR
              Timezone: Asia/Tehran
            2. ۲کلید را تنظیم کنید

              bash
              export TAGHVIM_API_KEY=tgv_test_...
            3. ۳نخستین درخواست

              bash
              curl https://api.taghvim.dev/v1/dates/resolve \
                -H "Authorization: Bearer $TAGHVIM_API_KEY" \
                -H "Content-Type: application/json" \
                -d '{
                  "text":"سه روز کاری بعد",
                  "locale":"fa-IR"
                }'
            پاسخ
            {
              "status": "resolved",
              "jalali": "1405-09-03",
              "business_day": true
            }

            پاسخ نمونه؛ تاریخ‌ها هنگام اجرای ابزارهای تعاملی دوباره محاسبه می‌شوند.

            خط فرمانموتور تقویم
            
                    
            خط فرمان نمونه؛ خروجی هر فرمان را همین موتور تقویم می‌سازد.
            ویرایشگر SDKdue-date.tsموتور تقویم
            1. import { createTestClient } from "@taghvim/sdk";
            2. // Server-side code: the trial API key never enters a browser bundle.
            3. const client = createTestClient({ apiKey: process.env.TAGHVIM_TEST_API_KEY });
            4. // 30 business days after today, Iranian bank calendar
            5. const due = await client.addBusinessDays({
            6. date: "1405-08-30",
            7. days: 30,
            8. });
            9. console.log(due.data.result.jalali);
            خروجی
            کد نمونه با SDK؛ «اجرا» همان عملیات را روی موتور تقویم در مرورگر انجام می‌دهد.

            ثبت‌نام رایگان و مستقیم از طریق API عمومی است: ایمیل خود را تأیید کنید تا برای Tenant مستقل محیط تست، کلید API آزمایشی ۳۰روزه دریافت کنید. کلید فقط برای محیط تست است و پرداختی انجام نمی‌شود.

            مرجع تعاملی API

            همهٔ عملیات‌ها، با امکان امتحان روی همین صفحه.

            مشخصات هر عملیات و نمونه‌کد آن را ببینید. نمونه‌های تقویم در مرورگر اجرا می‌شوند؛ درخواست‌های محافظت‌شده فقط با کلید معتبرِ صادرشده قابل آزمایش‌اند.

            ۶۷ عملیاتدریافت مشخصات (OpenAPI ۳٫۱)
            فقط برای فراخوانی واقعی لازم است. کلید تنها به api.taghvim.dev فرستاده می‌شود و هیچ‌جا ذخیره نمی‌شود.

            نشانی سرویس: https://api.taghvim.dev · احراز هویت: Authorization: Bearer tgv_test_…

            سامانه و قراردادسلامت سرویس، آمادگی، نسخه‌ها و خود قرارداد API.

            GET/v1/healthسلامت سرویسبدون کلید

            پاسخ‌ها

            • ۲۰۰Health
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/health" \
              -H "Accept: application/json"
            GET/v1/readinessآمادگی سرویسبدون کلید

            پاسخ‌ها

            • ۲۰۰Readiness
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.
            • ۵۰۳Readiness

            امتحان کنید

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/readiness" \
              -H "Accept: application/json"
            GET/v1/versionsنسخه‌هابدون کلید

            پاسخ‌ها

            • ۲۰۰Versions
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/versions" \
              -H "Accept: application/json"
            GET/openapi.jsonهمین سند OpenAPIبدون کلید

            پاسخ‌ها

            • ۲۰۰
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/openapi.json" \
              -H "Accept: application/json"

            تقویم و تبدیل تاریختقویم‌ها و تبدیل تاریخ.

            GET/v1/calendars/systemsتقویم‌های پشتیبانی‌شدهاجرا در مرورگر

            پاسخ‌ها

            • ۲۰۰CalendarSystems
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۲۹quota_exceededسهمیه‌ی ماهانه‌ی عملیات پلن شما تمام شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: ۲۰۰ Taghvim-Request-Id: req_example

            پاسخ موتور در مرورگر
            {
              "systems": [
                {
                  "id": "jalali",
                  "name": "Solar Hijri (Jalali)",
                  "name_fa": "هجری شمسی",
                  "year_range": [
                    1300,
                    1499
                  ]
                },
                {
                  "id": "gregorian",
                  "name": "Gregorian",
                  "name_fa": "میلادی",
                  "year_range": [
                    1921,
                    2121
                  ]
                },
                {
                  "id": "hijri",
                  "name": "Hijri (Umm al-Qura)",
                  "name_fa": "هجری قمری (ام‌القری)",
                  "year_range": [
                    1343,
                    1500
                  ],
                  "note": "Lunar holidays are predicted until officially announced."
                }
              ],
              "business_day_profile": {
                "id": "bank",
                "weekend": [
                  5
                ],
                "description_fa": "تقویم بانکی ایران: جمعه و تعطیلات رسمی، روز غیرکاری هستند."
              },
              "timezone": "Asia/Tehran",
              "calendar_data_version": "iran-2026.10.01"
            }
            curl
            curl "https://api.taghvim.dev/v1/calendars/systems" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"
            POST/v1/dates/convertتبدیل تاریخاجرا در مرورگر

            یک تاریخ شمسی، میلادی یا قمری را می‌گیرد و همان روز را در هر سه تقویم، همراه با وضعیت روز کاری، برمی‌گرداند.

            بدنه‌ی درخواست

            نامنوعالزامتوضیح
            dateDateInputالزامی
            calendar_systemobjectاختیاریمقدارها: jalali، gregorian، hijri

            پاسخ‌ها

            • ۲۰۰ConvertResponse
            • ۴۰۰invalid_jsonبدنه‌ی درخواست JSON معتبر نیست.validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۱۳payload_too_largeحجم بدنه‌ی درخواست بیش از حد مجاز است.
            • ۴۱۵unsupported_media_typeبدنه‌ی درخواست را با نوع application/json بفرستید.
            • ۴۲۲invalid_dateتاریخ واردشده تاریخ شمسی، میلادی یا قمری معتبری نیست.out_of_rangeمقدار واردشده بیرون از بازه‌ی پشتیبانی‌شده است.
            • ۴۲۹quota_exceededسهمیه‌ی ماهانه‌ی عملیات پلن شما تمام شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: ۲۰۰ Taghvim-Request-Id: req_example

            پاسخ موتور در مرورگر
            {
              "input": {
                "text": "1405-07-15",
                "calendar_system": "jalali"
              },
              "date": {
                "iso": "2026-10-07",
                "jalali": "1405-07-15",
                "hijri": "1448-04-26",
                "weekday": 3,
                "weekday_fa": "چهارشنبه",
                "jalali_text_fa": "۱۵ مهر ۱۴۰۵",
                "business_day": true,
                "holidays": [],
                "predicted_holiday": false
              },
              "leap_year": false,
              "calendar_data_version": "iran-2026.10.01"
            }
            curl
            curl -X POST "https://api.taghvim.dev/v1/dates/convert" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Content-Type: application/json" \
              -d '{"date":"1405-07-15"}'
            POST/v1/dates/reconcileتطبیق مستند تاریخ‌ها بین تقویم‌هانیازمند کلید API

            تاریخ‌های صریح شمسی، میلادی یا قمری را با موتور واحد به روز تقویمی معادل تبدیل می‌کند؛ اختلاف روز، روز هفته، روز کاری، تعطیلی احتمالی و مغایرت با ادعاهای ورودی را با نسخهٔ داده و شناسهٔ درخواست گزارش می‌دهد. این عملیات تطبیق لحظهٔ زمانی یا تعطیلات دیگر کشورها نیست.

            بدنه‌ی درخواست

            نامنوعالزامتوضیح
            leftReconcileDateAssertionالزامی
            left.dateDateInputالزامی
            left.calendar_systemobjectالزامیمقدارها: jalali، gregorian، hijri
            left.expectedobjectاختیاری
            left.expected.isostringاختیاری
            left.expected.weekdayintegerاختیاریبازه: ۱…۷
            left.expected.business_daybooleanاختیاری
            left.expected.calendar_data_versionstringاختیاری
            rightReconcileDateAssertionالزامی
            right.dateDateInputالزامی
            right.calendar_systemobjectالزامیمقدارها: jalali، gregorian، hijri
            right.expectedobjectاختیاری
            right.expected.isostringاختیاری
            right.expected.weekdayintegerاختیاریبازه: ۱…۷
            right.expected.business_daybooleanاختیاری
            right.expected.calendar_data_versionstringاختیاری

            پاسخ‌ها

            • ۲۰۰ReconcileResponse
            • ۴۰۰invalid_jsonبدنه‌ی درخواست JSON معتبر نیست.validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۱۳payload_too_largeحجم بدنه‌ی درخواست بیش از حد مجاز است.
            • ۴۱۵unsupported_media_typeبدنه‌ی درخواست را با نوع application/json بفرستید.
            • ۴۲۲invalid_dateتاریخ واردشده تاریخ شمسی، میلادی یا قمری معتبری نیست.out_of_rangeمقدار واردشده بیرون از بازه‌ی پشتیبانی‌شده است.
            • ۴۲۹quota_exceededسهمیه‌ی ماهانه‌ی عملیات پلن شما تمام شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl -X POST "https://api.taghvim.dev/v1/dates/reconcile" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Content-Type: application/json" \
              -d '{"left":{"date":"1405-07-15","calendar_system":"jalali"},"right":{"date":"2026-10-07","calendar_system":"gregorian"}}'
            POST/v1/dates/resolveخواندن تاریخ از متن فارسیاجرا در مرورگر

            تاریخ صریح (مانند «۱۵ مهر ۱۴۰۵») یا عبارت نسبی فارسی (مانند «سه روز کاری بعد از ۱۵ مهر ساعت ۱۰»، «فردا» یا «۵ روز قبل») را با روزهای کاری تقویم بانکی به تاریخ دقیق تبدیل می‌کند و مراحل و فرض‌ها را نشان می‌دهد. عبارتی را که بدون حدس قابل خواندن نباشد، رد می‌کند.

            بدنه‌ی درخواست

            نامنوعالزامتوضیح
            textstringالزامی
            localeobjectاختیاریپیش‌فرض: "fa-IR"
            timezoneobjectاختیاریپیش‌فرض: "Asia/Tehran"
            calendar_systemobjectاختیاریپیش‌فرض: "jalali"
            reference_instantstringاختیاری
            ambiguity_policyAmbiguityPolicyاختیاریمقدارها: assume_and_report، return_candidates، reject

            پاسخ‌ها

            • ۲۰۰ResolveResponse
            • ۴۰۰invalid_jsonبدنه‌ی درخواست JSON معتبر نیست.validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۱۳payload_too_largeحجم بدنه‌ی درخواست بیش از حد مجاز است.
            • ۴۱۵unsupported_media_typeبدنه‌ی درخواست را با نوع application/json بفرستید.
            • ۴۲۲unresolved_expressionاین عبارت بدون حدس‌زدن به تاریخ تبدیل نشد.
            • ۴۲۹quota_exceededسهمیه‌ی ماهانه‌ی عملیات پلن شما تمام شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: ۲۰۰ Taghvim-Request-Id: req_example

            پاسخ موتور در مرورگر
            {
              "resolution_id": "resolv_01M7Y77M9REWEYD4YFDBBMVV7Y",
              "status": "ambiguous",
              "normalized_expression": {
                "type": "business_day_offset",
                "anchor": {
                  "kind": "explicit_date",
                  "calendar_system": "jalali"
                },
                "offset_business_days": 3,
                "local_time": "10:00:00"
              },
              "resolved": {
                "instant": "2026-10-11T06:30:00.000Z",
                "timezone": "Asia/Tehran",
                "jalali": "1405-07-19 10:00",
                "gregorian": "2026-10-11 10:00"
              },
              "confidence": 0.9,
              "jalali": "1405-07-19",
              "iso": "2026-10-11",
              "time": "10:00",
              "timezone": "Asia/Tehran",
              "date": {
                "iso": "2026-10-11",
                "jalali": "1405-07-19",
                "hijri": "1448-04-30",
                "weekday": 7,
                "weekday_fa": "یکشنبه",
                "jalali_text_fa": "۱۹ مهر ۱۴۰۵",
                "business_day": true,
                "holidays": [],
                "predicted_holiday": false
              },
              "business_day": true,
              "depends_on_predicted_holiday": false,
              "assumptions": [
                {
                  "kind": "year",
                  "value": "1405"
                }
              ],
              "candidates": [
                {
                  "jalali": "1405-07-19",
                  "iso": "2026-10-11",
                  "time": "10:00",
                  "resolved": {
                    "instant": "2026-10-11T06:30:00.000Z",
                    "timezone": "Asia/Tehran",
                    "jalali": "1405-07-19 10:00",
                    "gregorian": "2026-10-11 10:00"
                  },
                  "assumptions": [
                    {
                      "kind": "year",
                      "value": "1405"
                    }
                  ],
                  "business_day": true
                },
                {
                  "jalali": "1406-07-19",
                  "iso": "2027-10-11",
                  "time": "10:00",
                  "resolved": {
                    "instant": "2027-10-11T06:30:00.000Z",
                    "timezone": "Asia/Tehran",
                    "jalali": "1406-07-19 10:00",
                    "gregorian": "2027-10-11 10:00"
                  },
                  "assumptions": [
                    {
                      "kind": "year",
                      "value": "1406"
                    }
                  ],
                  "business_day": true
                }
              ],
              "ambiguity_policy": "return_candidates",
              "reference_instant": "2026-09-29T20:00:00.000Z",
              "steps": [
                {
                  "step": "متن ورودی",
                  "value": "سه روز کاری بعد از 15 مهر ساعت 10"
                },
                {
                  "step": "ساعت",
                  "value": "۱۰:۰۰"
                },
                {
                  "step": "تعداد روز",
                  "value": "۳"
                },
                {
                  "step": "نوع روز",
                  "value": "روز کاری"
                },
                {
                  "step": "جهت",
                  "value": "بعد"
                },
                {
                  "step": "مبنا",
                  "value": "شمسی"
                },
                {
                  "step": "تقویم کاری",
                  "value": "بانکی"
                },
                {
                  "step": "فرض",
                  "value": "سال ۱۴۰۵ (سال جاری)"
                },
                {
                  "step": "تاریخ شمسی",
                  "value": "۱۹ مهر ۱۴۰۵"
                },
                {
                  "step": "روز هفته",
                  "value": "یکشنبه"
                }
              ],
              "calendar_data_version": "iran-2026.10.01"
            }
            curl
            curl -X POST "https://api.taghvim.dev/v1/dates/resolve" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Content-Type: application/json" \
              -d '{"text":"سه روز کاری بعد از ۱۵ مهر ساعت ۱۰","locale":"fa-IR","calendar_system":"jalali","timezone":"Asia/Tehran","reference_instant":"2026-09-29T20:00:00Z","ambiguity_policy":"return_candidates"}'

            روز کاریمحاسبه‌ی روز کاری بر پایه‌ی تقویم بانکی ایران.

            POST/v1/business-days/addافزودن روز کاریاجرا در مرورگر

            چند روز کاری به یک تاریخ اضافه یا از آن کم می‌کند؛ جمعه‌ها و تعطیلات رسمی شمرده نمی‌شوند.

            بدنه‌ی درخواست

            نامنوعالزامتوضیح
            dateDateInputالزامی
            daysintegerالزامیبازه: -۳۶۵۰…۳۶۵۰

            پاسخ‌ها

            • ۲۰۰BusinessDaysAddResponse
            • ۴۰۰invalid_jsonبدنه‌ی درخواست JSON معتبر نیست.validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۱۳payload_too_largeحجم بدنه‌ی درخواست بیش از حد مجاز است.
            • ۴۱۵unsupported_media_typeبدنه‌ی درخواست را با نوع application/json بفرستید.
            • ۴۲۲invalid_dateتاریخ واردشده تاریخ شمسی، میلادی یا قمری معتبری نیست.out_of_rangeمقدار واردشده بیرون از بازه‌ی پشتیبانی‌شده است.
            • ۴۲۹quota_exceededسهمیه‌ی ماهانه‌ی عملیات پلن شما تمام شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: ۲۰۰ Taghvim-Request-Id: req_example

            پاسخ موتور در مرورگر
            {
              "from": {
                "iso": "2026-10-07",
                "jalali": "1405-07-15",
                "hijri": "1448-04-26",
                "weekday": 3,
                "weekday_fa": "چهارشنبه",
                "jalali_text_fa": "۱۵ مهر ۱۴۰۵",
                "business_day": true,
                "holidays": [],
                "predicted_holiday": false
              },
              "days": 30,
              "result": {
                "iso": "2026-11-11",
                "jalali": "1405-08-20",
                "hijri": "1448-06-01",
                "weekday": 3,
                "weekday_fa": "چهارشنبه",
                "jalali_text_fa": "۲۰ آبان ۱۴۰۵",
                "business_day": true,
                "holidays": [],
                "predicted_holiday": false
              },
              "calendar_days": 35,
              "depends_on_predicted_holiday": false,
              "calendar_data_version": "iran-2026.10.01"
            }
            curl
            curl -X POST "https://api.taghvim.dev/v1/business-days/add" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Content-Type: application/json" \
              -d '{"date":"1405-07-15","days":30}'
            POST/v1/business-days/diffشمارش روزهای کاری میان دو تاریخاجرا در مرورگر

            روزهای کاری و روزهای تعطیل میان دو تاریخ را می‌شمارد (روز آغاز شمرده نمی‌شود، روز پایان شمرده می‌شود).

            بدنه‌ی درخواست

            نامنوعالزامتوضیح
            fromDateInputالزامی
            toDateInputالزامی

            پاسخ‌ها

            • ۲۰۰BusinessDaysDiffResponse
            • ۴۰۰invalid_jsonبدنه‌ی درخواست JSON معتبر نیست.validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۱۳payload_too_largeحجم بدنه‌ی درخواست بیش از حد مجاز است.
            • ۴۱۵unsupported_media_typeبدنه‌ی درخواست را با نوع application/json بفرستید.
            • ۴۲۲invalid_dateتاریخ واردشده تاریخ شمسی، میلادی یا قمری معتبری نیست.out_of_rangeمقدار واردشده بیرون از بازه‌ی پشتیبانی‌شده است.
            • ۴۲۹quota_exceededسهمیه‌ی ماهانه‌ی عملیات پلن شما تمام شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: ۲۰۰ Taghvim-Request-Id: req_example

            پاسخ موتور در مرورگر
            {
              "from": {
                "iso": "2026-10-07",
                "jalali": "1405-07-15"
              },
              "to": {
                "iso": "2026-11-06",
                "jalali": "1405-08-15"
              },
              "calendar_days": 30,
              "business_days": 25,
              "days_off": [
                {
                  "jalali": "1405-07-17",
                  "iso": "2026-10-09",
                  "reason": "weekend",
                  "titles": []
                },
                {
                  "jalali": "1405-07-24",
                  "iso": "2026-10-16",
                  "reason": "weekend",
                  "titles": []
                },
                {
                  "jalali": "1405-08-01",
                  "iso": "2026-10-23",
                  "reason": "weekend",
                  "titles": []
                },
                {
                  "jalali": "1405-08-08",
                  "iso": "2026-10-30",
                  "reason": "weekend",
                  "titles": []
                },
                {
                  "jalali": "1405-08-15",
                  "iso": "2026-11-06",
                  "reason": "weekend",
                  "titles": []
                }
              ],
              "depends_on_predicted_holiday": false,
              "calendar_data_version": "iran-2026.10.01"
            }
            curl
            curl -X POST "https://api.taghvim.dev/v1/business-days/diff" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Content-Type: application/json" \
              -d '{"from":"1405-07-15","to":"1405-08-15"}'
            POST/v1/business-days/is-business-dayآیا این روز کاری است؟اجرا در مرورگر

            بدنه‌ی درخواست

            نامنوعالزامتوضیح
            dateDateInputالزامی

            پاسخ‌ها

            • ۲۰۰BusinessDayStatus
            • ۴۰۰invalid_jsonبدنه‌ی درخواست JSON معتبر نیست.validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۱۳payload_too_largeحجم بدنه‌ی درخواست بیش از حد مجاز است.
            • ۴۱۵unsupported_media_typeبدنه‌ی درخواست را با نوع application/json بفرستید.
            • ۴۲۲invalid_dateتاریخ واردشده تاریخ شمسی، میلادی یا قمری معتبری نیست.out_of_rangeمقدار واردشده بیرون از بازه‌ی پشتیبانی‌شده است.
            • ۴۲۹quota_exceededسهمیه‌ی ماهانه‌ی عملیات پلن شما تمام شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: ۲۰۰ Taghvim-Request-Id: req_example

            پاسخ موتور در مرورگر
            {
              "date": {
                "iso": "2026-10-07",
                "jalali": "1405-07-15",
                "hijri": "1448-04-26",
                "weekday": 3,
                "weekday_fa": "چهارشنبه",
                "jalali_text_fa": "۱۵ مهر ۱۴۰۵",
                "business_day": true,
                "holidays": [],
                "predicted_holiday": false
              },
              "business_day": true,
              "reason": null,
              "predicted": false,
              "previous_business_day": {
                "iso": "2026-10-06",
                "jalali": "1405-07-14"
              },
              "next_business_day": {
                "iso": "2026-10-08",
                "jalali": "1405-07-16"
              },
              "calendar_data_version": "iran-2026.10.01"
            }
            curl
            curl -X POST "https://api.taghvim.dev/v1/business-days/is-business-day" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Content-Type: application/json" \
              -d '{"date":"1405-07-15"}'
            GET/v1/business-days/checkآیا این روز کاری است؟ (با پارامتر)اجرا در مرورگر

            پارامترها

            نامجایگاهنوعالزامتوضیح
            dateپرس‌وجوDateInputالزامی

            پاسخ‌ها

            • ۲۰۰BusinessDayStatus
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۲۲invalid_dateتاریخ واردشده تاریخ شمسی، میلادی یا قمری معتبری نیست.out_of_rangeمقدار واردشده بیرون از بازه‌ی پشتیبانی‌شده است.
            • ۴۲۹quota_exceededسهمیه‌ی ماهانه‌ی عملیات پلن شما تمام شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: ۲۰۰ Taghvim-Request-Id: req_example

            پاسخ موتور در مرورگر
            {
              "date": {
                "iso": "2026-10-07",
                "jalali": "1405-07-15",
                "hijri": "1448-04-26",
                "weekday": 3,
                "weekday_fa": "چهارشنبه",
                "jalali_text_fa": "۱۵ مهر ۱۴۰۵",
                "business_day": true,
                "holidays": [],
                "predicted_holiday": false
              },
              "business_day": true,
              "reason": null,
              "predicted": false,
              "previous_business_day": {
                "iso": "2026-10-06",
                "jalali": "1405-07-14"
              },
              "next_business_day": {
                "iso": "2026-10-08",
                "jalali": "1405-07-16"
              },
              "calendar_data_version": "iran-2026.10.01"
            }
            curl
            curl "https://api.taghvim.dev/v1/business-days/check?date=1405-07-15" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"
            GET/v1/business-days/nextروز کاری بعدیاجرا در مرورگر

            پارامترها

            نامجایگاهنوعالزامتوضیح
            dateپرس‌وجوDateInputالزامی

            پاسخ‌ها

            • ۲۰۰AdjacentBusinessDay
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۲۲invalid_dateتاریخ واردشده تاریخ شمسی، میلادی یا قمری معتبری نیست.out_of_rangeمقدار واردشده بیرون از بازه‌ی پشتیبانی‌شده است.
            • ۴۲۹quota_exceededسهمیه‌ی ماهانه‌ی عملیات پلن شما تمام شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: ۲۰۰ Taghvim-Request-Id: req_example

            پاسخ موتور در مرورگر
            {
              "from": {
                "iso": "2027-02-10",
                "jalali": "1405-11-21"
              },
              "direction": "next",
              "result": {
                "iso": "2027-02-13",
                "jalali": "1405-11-24",
                "hijri": "1448-09-06",
                "weekday": 6,
                "weekday_fa": "شنبه",
                "jalali_text_fa": "۲۴ بهمن ۱۴۰۵",
                "business_day": true,
                "holidays": [],
                "predicted_holiday": false
              },
              "calendar_days": 3,
              "calendar_data_version": "iran-2026.10.01"
            }
            curl
            curl "https://api.taghvim.dev/v1/business-days/next?date=1405-11-21" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"
            GET/v1/business-days/previousروز کاری قبلیاجرا در مرورگر

            پارامترها

            نامجایگاهنوعالزامتوضیح
            dateپرس‌وجوDateInputالزامی

            پاسخ‌ها

            • ۲۰۰AdjacentBusinessDay
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۲۲invalid_dateتاریخ واردشده تاریخ شمسی، میلادی یا قمری معتبری نیست.out_of_rangeمقدار واردشده بیرون از بازه‌ی پشتیبانی‌شده است.
            • ۴۲۹quota_exceededسهمیه‌ی ماهانه‌ی عملیات پلن شما تمام شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: ۲۰۰ Taghvim-Request-Id: req_example

            پاسخ موتور در مرورگر
            {
              "from": {
                "iso": "2027-02-13",
                "jalali": "1405-11-24"
              },
              "direction": "previous",
              "result": {
                "iso": "2027-02-10",
                "jalali": "1405-11-21",
                "hijri": "1448-09-03",
                "weekday": 3,
                "weekday_fa": "چهارشنبه",
                "jalali_text_fa": "۲۱ بهمن ۱۴۰۵",
                "business_day": true,
                "holidays": [],
                "predicted_holiday": false
              },
              "calendar_days": -3,
              "calendar_data_version": "iran-2026.10.01"
            }
            curl
            curl "https://api.taghvim.dev/v1/business-days/previous?date=1405-11-24" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"

            تعطیلاتتعطیلات رسمی ایران؛ تعطیلات قمری پیش‌بینی‌شده جدا مشخص می‌شوند.

            GET/v1/holidaysتعطیلات رسمی یک سال یا ماه شمسیاجرا در مرورگر

            تعطیلات قمری تا اعلام رسمی «پیش‌بینی» هستند و ممکن است یک روز جابه‌جا شوند.

            پارامترها

            نامجایگاهنوعالزامتوضیح
            yearپرس‌وجوintegerالزامی
            monthپرس‌وجوintegerاختیاری

            پاسخ‌ها

            • ۲۰۰HolidayList
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۲۲out_of_rangeمقدار واردشده بیرون از بازه‌ی پشتیبانی‌شده است.
            • ۴۲۹quota_exceededسهمیه‌ی ماهانه‌ی عملیات پلن شما تمام شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: ۲۰۰ Taghvim-Request-Id: req_example

            پاسخ موتور در مرورگر
            {
              "year": 1405,
              "month": 11,
              "count": 2,
              "holidays": [
                {
                  "jalali": "1405-11-04",
                  "iso": "2027-01-24",
                  "title": "ولادت حضرت قائم",
                  "kind": "lunar",
                  "status": "predicted"
                },
                {
                  "jalali": "1405-11-22",
                  "iso": "2027-02-11",
                  "title": "پیروزی انقلاب اسلامی",
                  "kind": "solar",
                  "status": "official"
                }
              ],
              "calendar_data_version": "iran-2026.10.01"
            }
            curl
            curl "https://api.taghvim.dev/v1/holidays?year=1405&month=11" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"
            GET/v1/holidays/{date}تعطیلات یک روزاجرا در مرورگر

            پارامترها

            نامجایگاهنوعالزامتوضیح
            dateمسیرDateInputالزامی

            پاسخ‌ها

            • ۲۰۰HolidayDay
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۲۲invalid_dateتاریخ واردشده تاریخ شمسی، میلادی یا قمری معتبری نیست.out_of_rangeمقدار واردشده بیرون از بازه‌ی پشتیبانی‌شده است.
            • ۴۲۹quota_exceededسهمیه‌ی ماهانه‌ی عملیات پلن شما تمام شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: ۲۰۰ Taghvim-Request-Id: req_example

            پاسخ موتور در مرورگر
            {
              "date": {
                "iso": "2027-02-11",
                "jalali": "1405-11-22",
                "hijri": "1448-09-04",
                "weekday": 4,
                "weekday_fa": "پنجشنبه",
                "jalali_text_fa": "۲۲ بهمن ۱۴۰۵",
                "business_day": false,
                "holidays": [
                  "پیروزی انقلاب اسلامی"
                ],
                "predicted_holiday": false
              },
              "holiday": true,
              "holidays": [
                {
                  "jalali": "1405-11-22",
                  "iso": "2027-02-11",
                  "title": "پیروزی انقلاب اسلامی",
                  "kind": "solar",
                  "status": "official"
                }
              ],
              "calendar_data_version": "iran-2026.10.01"
            }
            curl
            curl "https://api.taghvim.dev/v1/holidays/1405-11-22" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"

            سررسید و مهلتسررسیدها، مهلت بر حسب ساعت کاری و یادآورها.

            POST/v1/deadlinesساختن سررسیداجرا در مرورگر

            سررسیدی بر پایه‌ی تاریخ مبنا، تعداد روز (کاری یا تقویمی) و قاعده‌ی جابه‌جایی در روز تعطیل می‌سازد و نگه می‌دارد.

            بدنه‌ی درخواست

            نامنوعالزامتوضیح
            anchorDateInputالزامی
            daysintegerالزامیبازه: ۰…۳۶۵۰
            typeobjectاختیاریمقدارها: business، calendar؛ پیش‌فرض: "business"
            rollRollاختیاریمقدارها: following، modified_following، preceding، modified_preceding، nearest، none
            titlestringاختیاری
            subject_refstringاختیاری

            پاسخ‌ها

            • ۲۰۱Deadline
            • ۴۰۰invalid_jsonبدنه‌ی درخواست JSON معتبر نیست.validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۰۹idempotency_conflictاین Idempotency-Key پیش‌تر با درخواست دیگری به کار رفته است.idempotency_in_progressدرخواستی با همین Idempotency-Key هنوز در حال پردازش است.
            • ۴۱۳payload_too_largeحجم بدنه‌ی درخواست بیش از حد مجاز است.
            • ۴۱۵unsupported_media_typeبدنه‌ی درخواست را با نوع application/json بفرستید.
            • ۴۲۲invalid_dateتاریخ واردشده تاریخ شمسی، میلادی یا قمری معتبری نیست.out_of_rangeمقدار واردشده بیرون از بازه‌ی پشتیبانی‌شده است.
            • ۴۲۹quota_exceededسهمیه‌ی ماهانه‌ی عملیات پلن شما تمام شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: ۲۰۱ Taghvim-Request-Id: req_example

            پاسخ موتور در مرورگر
            {
              "id": "ddl_01M7Y77M9RCHSB2EG3DJG32AXY",
              "status": "active",
              "title": null,
              "subject_ref": null,
              "anchor": {
                "iso": "2026-10-07",
                "jalali": "1405-07-15",
                "hijri": "1448-04-26",
                "weekday": 3,
                "weekday_fa": "چهارشنبه",
                "jalali_text_fa": "۱۵ مهر ۱۴۰۵",
                "business_day": true,
                "holidays": [],
                "predicted_holiday": false
              },
              "rule": {
                "days": 10,
                "type": "business",
                "roll": "following"
              },
              "due": {
                "iso": "2026-10-19",
                "jalali": "1405-07-27",
                "hijri": "1448-05-08",
                "weekday": 1,
                "weekday_fa": "دوشنبه",
                "jalali_text_fa": "۲۷ مهر ۱۴۰۵",
                "business_day": true,
                "holidays": [],
                "predicted_holiday": false
              },
              "moved_days": 0,
              "depends_on_predicted_holiday": false,
              "created_at": {
                "iso": "2026-11-21T04:53:31.064Z",
                "local": "2026-11-21T08:23:31+03:30",
                "jalali": "1405-08-30 08:23:31",
                "timezone": "Asia/Tehran"
              },
              "calendar_data_version": "iran-2026.10.01"
            }
            curl
            curl -X POST "https://api.taghvim.dev/v1/deadlines" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Idempotency-Key: $(uuidgen)" \
              -H "Content-Type: application/json" \
              -d '{"anchor":"1405-07-15","days":10,"type":"business"}'
            GET/v1/deadlines/{id}دریافت سررسیداجرا در مرورگر

            پارامترها

            نامجایگاهنوعالزامتوضیح
            idمسیرstringالزامی

            پاسخ‌ها

            • ۲۰۰Deadline
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/deadlines/{id}" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"
            POST/v1/sla/dueمهلت بر حسب ساعت کاریاجرا در مرورگر

            پایان یک مهلت را با شمردن فقط ساعت‌های کاری حساب می‌کند؛ روزهای تعطیل و ساعت‌های بیرون از وقت اداری شمرده نمی‌شوند.

            بدنه‌ی درخواست

            نامنوعالزامتوضیح
            startDateInputالزامی
            timestringاختیاریپیش‌فرض: "09:00"
            hoursnumberالزامیبازه: ……۲۰۰۰
            openstringاختیاریپیش‌فرض: "08:00"
            closestringاختیاریپیش‌فرض: "16:00"
            thursday_closestring | nullاختیاری

            پاسخ‌ها

            • ۲۰۰SlaResponse
            • ۴۰۰invalid_jsonبدنه‌ی درخواست JSON معتبر نیست.validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۱۳payload_too_largeحجم بدنه‌ی درخواست بیش از حد مجاز است.
            • ۴۱۵unsupported_media_typeبدنه‌ی درخواست را با نوع application/json بفرستید.
            • ۴۲۲invalid_dateتاریخ واردشده تاریخ شمسی، میلادی یا قمری معتبری نیست.invalid_timeساعت واردشده معتبر نیست.out_of_rangeمقدار واردشده بیرون از بازه‌ی پشتیبانی‌شده است.
            • ۴۲۹quota_exceededسهمیه‌ی ماهانه‌ی عملیات پلن شما تمام شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: ۲۰۰ Taghvim-Request-Id: req_example

            پاسخ موتور در مرورگر
            {
              "start": {
                "iso": "2026-10-07T11:30:00.000Z",
                "local": "2026-10-07T15:00:00+03:30",
                "jalali": "1405-07-15 15:00:00",
                "timezone": "Asia/Tehran"
              },
              "hours": 24,
              "due": {
                "iso": "2026-10-12T06:30:00.000Z",
                "local": "2026-10-12T10:00:00+03:30",
                "jalali": "1405-07-20 10:00:00",
                "timezone": "Asia/Tehran"
              },
              "calendar_days": 5,
              "timezone": "Asia/Tehran",
              "calendar_data_version": "iran-2026.10.01"
            }
            curl
            curl -X POST "https://api.taghvim.dev/v1/sla/due" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Content-Type: application/json" \
              -d '{"start":"1405-07-15","time":"15:00","hours":24,"open":"08:00","close":"16:00","thursday_close":"13:00"}'
            POST/v1/reminders/previewپیش‌نمایش یادآورهااجرا در مرورگر

            زمان یادآورها را پیش از سررسید حساب می‌کند؛ یادآوری که به روز تعطیل بخورد به روز کاری قبل می‌رود.

            بدنه‌ی درخواست

            نامنوعالزامتوضیح
            dueDateInputالزامی
            timestringاختیاریپیش‌فرض: "09:00"
            offsetsobject[]الزامی
            offsets[].nintegerالزامیبازه: ۰…۳۶۵
            offsets[].unitobjectالزامیمقدارها: business، calendar

            پاسخ‌ها

            • ۲۰۰RemindersResponse
            • ۴۰۰invalid_jsonبدنه‌ی درخواست JSON معتبر نیست.validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۱۳payload_too_largeحجم بدنه‌ی درخواست بیش از حد مجاز است.
            • ۴۱۵unsupported_media_typeبدنه‌ی درخواست را با نوع application/json بفرستید.
            • ۴۲۲invalid_dateتاریخ واردشده تاریخ شمسی، میلادی یا قمری معتبری نیست.invalid_timeساعت واردشده معتبر نیست.
            • ۴۲۹quota_exceededسهمیه‌ی ماهانه‌ی عملیات پلن شما تمام شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: ۲۰۰ Taghvim-Request-Id: req_example

            پاسخ موتور در مرورگر
            {
              "due": {
                "iso": "2026-11-11",
                "jalali": "1405-08-20"
              },
              "reminders": [
                {
                  "offset": {
                    "n": 7,
                    "unit": "calendar"
                  },
                  "at": {
                    "iso": "2026-11-04T05:30:00.000Z",
                    "local": "2026-11-04T09:00:00+03:30",
                    "jalali": "1405-08-13 09:00:00",
                    "timezone": "Asia/Tehran"
                  },
                  "moved_days": 0,
                  "depends_on_predicted_holiday": false
                },
                {
                  "offset": {
                    "n": 3,
                    "unit": "business"
                  },
                  "at": {
                    "iso": "2026-11-08T05:30:00.000Z",
                    "local": "2026-11-08T09:00:00+03:30",
                    "jalali": "1405-08-17 09:00:00",
                    "timezone": "Asia/Tehran"
                  },
                  "moved_days": 0,
                  "depends_on_predicted_holiday": false
                },
                {
                  "offset": {
                    "n": 0,
                    "unit": "calendar"
                  },
                  "at": {
                    "iso": "2026-11-11T05:30:00.000Z",
                    "local": "2026-11-11T09:00:00+03:30",
                    "jalali": "1405-08-20 09:00:00",
                    "timezone": "Asia/Tehran"
                  },
                  "moved_days": 0,
                  "depends_on_predicted_holiday": false
                }
              ],
              "calendar_data_version": "iran-2026.10.01"
            }
            curl
            curl -X POST "https://api.taghvim.dev/v1/reminders/preview" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Content-Type: application/json" \
              -d '{"due":"1405-08-20","time":"09:00","offsets":[{"n":7,"unit":"calendar"},{"n":3,"unit":"business"},{"n":0,"unit":"calendar"}]}'

            تکرارتکرار: نوبت‌های بعدی یک قاعده.

            POST/v1/schedules/previewنوبت‌های بعدی یک قاعده‌ی تکراراجرا در مرورگر

            نوبت‌های بعدی یک قاعده‌ی تکرار را حساب می‌کند؛ مثلاً «آخرین روز کاری هر ماه».

            بدنه‌ی درخواست

            نامنوعالزامتوضیح
            ruleobjectالزامیمقدارها: last-business، first-business، day-of-month، weekly، every-business
            fromDateInputالزامی
            countintegerاختیاریپیش‌فرض: 6؛ بازه: ۱…۲۴
            dayintegerاختیاریبازه: ۱…۳۱
            weekdayintegerاختیاریبازه: ۱…۷
            rollobjectاختیاریمقدارها: following، preceding، skip؛ پیش‌فرض: "following"

            پاسخ‌ها

            • ۲۰۰SchedulePreview
            • ۴۰۰invalid_jsonبدنه‌ی درخواست JSON معتبر نیست.validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۱۳payload_too_largeحجم بدنه‌ی درخواست بیش از حد مجاز است.
            • ۴۱۵unsupported_media_typeبدنه‌ی درخواست را با نوع application/json بفرستید.
            • ۴۲۲invalid_dateتاریخ واردشده تاریخ شمسی، میلادی یا قمری معتبری نیست.
            • ۴۲۹quota_exceededسهمیه‌ی ماهانه‌ی عملیات پلن شما تمام شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: ۲۰۰ Taghvim-Request-Id: req_example

            پاسخ موتور در مرورگر
            {
              "rule": "last-business",
              "rule_fa": "آخرین روز کاری هر ماه",
              "from": {
                "iso": "2026-09-23",
                "jalali": "1405-07-01"
              },
              "occurrences": [
                {
                  "jalali": "1405-07-30",
                  "iso": "2026-10-22",
                  "scheduled_iso": "2026-10-22",
                  "moved_days": 0,
                  "depends_on_predicted_holiday": false
                },
                {
                  "jalali": "1405-08-30",
                  "iso": "2026-11-21",
                  "scheduled_iso": "2026-11-21",
                  "moved_days": 0,
                  "depends_on_predicted_holiday": false
                },
                {
                  "jalali": "1405-09-30",
                  "iso": "2026-12-21",
                  "scheduled_iso": "2026-12-21",
                  "moved_days": 0,
                  "depends_on_predicted_holiday": false
                },
                {
                  "jalali": "1405-10-30",
                  "iso": "2027-01-20",
                  "scheduled_iso": "2027-01-20",
                  "moved_days": 0,
                  "depends_on_predicted_holiday": false
                }
              ],
              "calendar_data_version": "iran-2026.10.01"
            }
            curl
            curl -X POST "https://api.taghvim.dev/v1/schedules/preview" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Content-Type: application/json" \
              -d '{"rule":"last-business","from":"1405-07-01","count":4}'

            حساب و کلیدحساب‌ها و کلیدهای API.

            POST/v1/tenantsساختن حساب و نخستین کلید API (ویژه‌ی اپراتور)نیازمند توکن اپراتور

            بدنه‌ی درخواست

            نامنوعالزامتوضیح
            namestringالزامی
            billing_emailstringاختیاری
            environmentEnvironmentاختیاریمقدارها: live، test

            پاسخ‌ها

            • ۲۰۱TenantCreated
            • ۴۰۰invalid_jsonبدنه‌ی درخواست JSON معتبر نیست.validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳forbiddenاین اعتبارنامه اجازه‌ی انجام این کار را ندارد.
            • ۴۰۹idempotency_conflictاین Idempotency-Key پیش‌تر با درخواست دیگری به کار رفته است.idempotency_in_progressدرخواستی با همین Idempotency-Key هنوز در حال پردازش است.
            • ۴۱۳payload_too_largeحجم بدنه‌ی درخواست بیش از حد مجاز است.
            • ۴۱۵unsupported_media_typeبدنه‌ی درخواست را با نوع application/json بفرستید.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            این عملیات ویژه‌ی اپراتور سرویس است و توکن اپراتور لازم دارد.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl -X POST "https://api.taghvim.dev/v1/tenants" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_OPERATOR_TOKEN" \
              -H "Idempotency-Key: $(uuidgen)" \
              -H "Content-Type: application/json" \
              -d '{"name":"Acme Clinic","billing_email":"billing@example.com","environment":"test"}'
            GET/v1/meحساب و کلیدی که این درخواست را فرستاده استنیازمند کلید API

            پاسخ‌ها

            • ۲۰۰Me
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/me" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"
            POST/v1/keysساختن کلید APIنیازمند کلید API

            بدنه‌ی درخواست

            نامنوعالزامتوضیح
            namestringاختیاری
            environmentEnvironmentاختیاریمقدارها: live، test

            پاسخ‌ها

            • ۲۰۱ApiKeyWithSecret
            • ۴۰۰invalid_jsonبدنه‌ی درخواست JSON معتبر نیست.validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۹idempotency_conflictاین Idempotency-Key پیش‌تر با درخواست دیگری به کار رفته است.idempotency_in_progressدرخواستی با همین Idempotency-Key هنوز در حال پردازش است.
            • ۴۱۳payload_too_largeحجم بدنه‌ی درخواست بیش از حد مجاز است.
            • ۴۱۵unsupported_media_typeبدنه‌ی درخواست را با نوع application/json بفرستید.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl -X POST "https://api.taghvim.dev/v1/keys" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Idempotency-Key: $(uuidgen)" \
              -H "Content-Type: application/json" \
              -d '{"name":"server","environment":"live"}'
            GET/v1/keysفهرست کلیدهای APIنیازمند کلید API

            پاسخ‌ها

            • ۲۰۰ApiKeyList
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/keys" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"
            DELETE/v1/keys/{id}باطل کردن کلید APIنیازمند کلید API

            پارامترها

            نامجایگاهنوعالزامتوضیح
            idمسیرstringالزامی

            پاسخ‌ها

            • ۲۰۰ApiKey
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۴۰۹idempotency_conflictاین Idempotency-Key پیش‌تر با درخواست دیگری به کار رفته است.idempotency_in_progressدرخواستی با همین Idempotency-Key هنوز در حال پردازش است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl -X DELETE "https://api.taghvim.dev/v1/keys/{id}" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Idempotency-Key: $(uuidgen)"

            مصرف و پلنپلن‌ها، مصرف اندازه‌گیری‌شده و خروجی صورت‌حساب.

            GET/v1/usageمصرف در یک دورهنیازمند کلید API

            پارامترها

            نامجایگاهنوعالزامتوضیح
            periodپرس‌وجوstringاختیاری

            پاسخ‌ها

            • ۲۰۰Usage
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۲۲out_of_rangeمقدار واردشده بیرون از بازه‌ی پشتیبانی‌شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/usage?period=1405-07" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"
            GET/v1/usage/exportخروجی صورت‌حساب یک دورهنیازمند کلید API

            پارامترها

            نامجایگاهنوعالزامتوضیح
            periodپرس‌وجوstringاختیاری
            formatپرس‌وجوobjectاختیاری

            پاسخ‌ها

            • ۲۰۰UsageExport
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۲۲out_of_rangeمقدار واردشده بیرون از بازه‌ی پشتیبانی‌شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/usage/export?period=1405-07&format=json" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"
            GET/v1/plansپلن‌ها و قیمت‌هانیازمند کلید API

            پاسخ‌ها

            • ۲۰۰PlanList
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/plans" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"
            GET/v1/subscriptionاشتراک فعلینیازمند کلید API

            پاسخ‌ها

            • ۲۰۰Subscription
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/subscription" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"
            GET/v1/admin/billing-exportخروجی صورت‌حساب همه‌ی حساب‌ها (ویژه‌ی اپراتور)نیازمند توکن اپراتور

            پارامترها

            نامجایگاهنوعالزامتوضیح
            periodپرس‌وجوstringاختیاری

            پاسخ‌ها

            • ۲۰۰BillingExport
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳forbiddenاین اعتبارنامه اجازه‌ی انجام این کار را ندارد.
            • ۴۲۲out_of_rangeمقدار واردشده بیرون از بازه‌ی پشتیبانی‌شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            این عملیات ویژه‌ی اپراتور سرویس است و توکن اپراتور لازم دارد.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/admin/billing-export?period=1405-07" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_OPERATOR_TOKEN"

            خرید پلنخرید پلن: پرداخت، تأیید پرداخت و رسید.

            POST/v1/payment-intentsساختن درخواست پرداخت برای خرید پلننیازمند کلید API

            برای پلن انتخاب‌شده درخواست پرداخت می‌سازد و نشانی صفحه‌ی پرداخت را برمی‌گرداند. تا پیش از راه‌اندازی پرداخت آنلاین، پاسخ خطای payments_not_configured است.

            بدنه‌ی درخواست

            نامنوعالزامتوضیح
            plan_idstringالزامی
            mobile_numberstringاختیاری

            پاسخ‌ها

            • ۲۰۱PaymentIntent
            • ۴۰۰idempotency_key_requiredاین عملیات به سرآیند Idempotency-Key نیاز دارد.invalid_jsonبدنه‌ی درخواست JSON معتبر نیست.validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۴۰۹idempotency_conflictاین Idempotency-Key پیش‌تر با درخواست دیگری به کار رفته است.idempotency_in_progressدرخواستی با همین Idempotency-Key هنوز در حال پردازش است.plan_unchangedحساب شما هم‌اکنون روی همین پلن یا پلن بالاتری است.
            • ۴۱۳payload_too_largeحجم بدنه‌ی درخواست بیش از حد مجاز است.
            • ۴۱۵unsupported_media_typeبدنه‌ی درخواست را با نوع application/json بفرستید.
            • ۴۲۲plan_not_purchasableاین پلن را نمی‌توان به‌صورت آنلاین خرید.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.
            • ۵۰۲payment_provider_errorدرگاه پرداخت خطا برگرداند.
            • ۵۰۳payments_not_configuredپرداخت آنلاین هنوز راه‌اندازی نشده است.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl -X POST "https://api.taghvim.dev/v1/payment-intents" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Idempotency-Key: $(uuidgen)" \
              -H "Content-Type: application/json" \
              -d '{"plan_id":"plan_builder"}'
            GET/v1/payment-intents/{id}وضعیت درخواست پرداختنیازمند کلید API

            پارامترها

            نامجایگاهنوعالزامتوضیح
            idمسیرstringالزامی

            پاسخ‌ها

            • ۲۰۰PaymentIntent
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/payment-intents/{id}" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"
            POST/v1/payment-intents/{id}/verifyتأیید پرداخت از درگاهنیازمند کلید API

            اگر بازگشت از درگاه گم شده باشد، این عملیات وضعیت پرداخت را از درگاه می‌پرسد و در صورت تأیید، پلن را ارتقا می‌دهد.

            پارامترها

            نامجایگاهنوعالزامتوضیح
            idمسیرstringالزامی

            پاسخ‌ها

            • ۲۰۰PaymentIntent
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۴۰۹idempotency_conflictاین Idempotency-Key پیش‌تر با درخواست دیگری به کار رفته است.idempotency_in_progressدرخواستی با همین Idempotency-Key هنوز در حال پردازش است.payment_amount_mismatchمبلغ تأییدشده با مبلغ درخواست پرداخت یکسان نیست.payment_intent_stateوضعیت درخواست پرداخت اجازه‌ی این کار را نمی‌دهد.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.
            • ۵۰۲payment_provider_errorدرگاه پرداخت خطا برگرداند.
            • ۵۰۳payments_not_configuredپرداخت آنلاین هنوز راه‌اندازی نشده است.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl -X POST "https://api.taghvim.dev/v1/payment-intents/{id}/verify" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Idempotency-Key: $(uuidgen)"
            POST/v1/payment-intents/{id}/cancelلغو درخواست پرداختنیازمند کلید API

            پارامترها

            نامجایگاهنوعالزامتوضیح
            idمسیرstringالزامی

            پاسخ‌ها

            • ۲۰۰PaymentIntent
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۴۰۹idempotency_conflictاین Idempotency-Key پیش‌تر با درخواست دیگری به کار رفته است.idempotency_in_progressدرخواستی با همین Idempotency-Key هنوز در حال پردازش است.payment_intent_stateوضعیت درخواست پرداخت اجازه‌ی این کار را نمی‌دهد.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl -X POST "https://api.taghvim.dev/v1/payment-intents/{id}/cancel" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Idempotency-Key: $(uuidgen)"
            GET/v1/billing/callback/vandarبازگشت پرداخت‌کننده از درگاهبدون کلید

            پرداخت‌کننده پس از پرداخت به این نشانی برمی‌گردد. این بازگشت فقط یک نشانه است: پرداخت تنها پس از تأیید مستقیم از درگاه و برابری مبلغ، موفق ثبت می‌شود.

            پارامترها

            نامجایگاهنوعالزامتوضیح
            tokenپرس‌وجوstringالزامی
            payment_statusپرس‌وجوstringاختیاری

            پاسخ‌ها

            • ۲۰۰
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/billing/callback/vandar" \
              -H "Accept: text/html"
            GET/v1/receipts/{id}دریافت رسیدنیازمند کلید API

            پارامترها

            نامجایگاهنوعالزامتوضیح
            idمسیرstringالزامی

            پاسخ‌ها

            • ۲۰۰Receipt
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/receipts/{id}" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"
            GET/v1/receipts/{id}/deliveriesوضعیت ارسال رسیدنیازمند کلید API

            پارامترها

            نامجایگاهنوعالزامتوضیح
            idمسیرstringالزامی

            پاسخ‌ها

            • ۲۰۰ReceiptDeliveryList
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/receipts/{id}/deliveries" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"

            رویدادهاگزارش رویدادها و انواع رویداد.

            GET/v1/event-logگزارش رویدادهای حسابنیازمند کلید API

            رویدادهای ثبت‌شده‌ی حساب، تازه‌ترین در ابتدا. شناسه‌ی هر رویداد با evtlog_ آغاز می‌شود؛ evt_ برای رویدادهای تقویم کنار گذاشته شده است.

            پارامترها

            نامجایگاهنوعالزامتوضیح
            typeپرس‌وجوEventTypeاختیاری
            limitپرس‌وجوintegerاختیاری

            پاسخ‌ها

            • ۲۰۰EventList
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/event-log" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"
            GET/v1/event-log/{id}یک رویداد از گزارش رویدادهانیازمند کلید API

            پارامترها

            نامجایگاهنوعالزامتوضیح
            idمسیرstringالزامی

            پاسخ‌ها

            • ۲۰۰Event
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/event-log/{id}" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"
            GET/v1/event-typesانواع رویدادبدون کلید

            پاسخ‌ها

            • ۲۰۰EventTypeList
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/event-types" \
              -H "Accept: application/json"

            وب‌هوکنشانی‌های وب‌هوک امضاشده و گزارش تحویل.

            POST/v1/webhooksساختن نشانی وب‌هوکنیازمند کلید API

            بدنه‌ی درخواست

            نامنوعالزامتوضیح
            urlstringالزامی
            event_typesEventType[]الزامی
            descriptionstringاختیاری

            پاسخ‌ها

            • ۲۰۱WebhookWithSecret
            • ۴۰۰invalid_jsonبدنه‌ی درخواست JSON معتبر نیست.validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۰۹idempotency_conflictاین Idempotency-Key پیش‌تر با درخواست دیگری به کار رفته است.idempotency_in_progressدرخواستی با همین Idempotency-Key هنوز در حال پردازش است.webhook_limit_reachedبه سقف تعداد نشانی‌های وب‌هوک رسیده‌اید.
            • ۴۱۳payload_too_largeحجم بدنه‌ی درخواست بیش از حد مجاز است.
            • ۴۱۵unsupported_media_typeبدنه‌ی درخواست را با نوع application/json بفرستید.
            • ۴۲۲webhook_url_rejectedنشانی وب‌هوک باید یک نشانی عمومی HTTPS باشد.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl -X POST "https://api.taghvim.dev/v1/webhooks" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Idempotency-Key: $(uuidgen)" \
              -H "Content-Type: application/json" \
              -d '{"url":"https://example.com/webhooks/taghvim","event_types":["taghvim.event.payment.intent.verified.v1"]}'
            GET/v1/webhooksفهرست نشانی‌های وب‌هوکنیازمند کلید API

            پاسخ‌ها

            • ۲۰۰WebhookList
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/webhooks" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"
            GET/v1/webhooks/{id}دریافت نشانی وب‌هوکنیازمند کلید API

            پارامترها

            نامجایگاهنوعالزامتوضیح
            idمسیرstringالزامی

            پاسخ‌ها

            • ۲۰۰Webhook
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/webhooks/{id}" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"
            DELETE/v1/webhooks/{id}غیرفعال کردن نشانی وب‌هوکنیازمند کلید API

            پارامترها

            نامجایگاهنوعالزامتوضیح
            idمسیرstringالزامی

            پاسخ‌ها

            • ۲۰۰Webhook
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۴۰۹idempotency_conflictاین Idempotency-Key پیش‌تر با درخواست دیگری به کار رفته است.idempotency_in_progressدرخواستی با همین Idempotency-Key هنوز در حال پردازش است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl -X DELETE "https://api.taghvim.dev/v1/webhooks/{id}" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Idempotency-Key: $(uuidgen)"
            POST/v1/webhooks/{id}/rotate-secretتعویض کلید امضانیازمند کلید API

            کلید تازه می‌سازد؛ کلید قبلی تا پایان دوره‌ی هم‌پوشانی هم امضا می‌کند.

            پارامترها

            نامجایگاهنوعالزامتوضیح
            idمسیرstringالزامی

            پاسخ‌ها

            • ۲۰۰WebhookWithSecret
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۴۰۹idempotency_conflictاین Idempotency-Key پیش‌تر با درخواست دیگری به کار رفته است.idempotency_in_progressدرخواستی با همین Idempotency-Key هنوز در حال پردازش است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl -X POST "https://api.taghvim.dev/v1/webhooks/{id}/rotate-secret" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Idempotency-Key: $(uuidgen)"
            GET/v1/webhooks/{id}/deliveriesگزارش تحویل‌های یک وب‌هوکنیازمند کلید API

            پارامترها

            نامجایگاهنوعالزامتوضیح
            idمسیرstringالزامی

            پاسخ‌ها

            • ۲۰۰DeliveryList
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/webhooks/{id}/deliveries" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"
            POST/v1/webhooks/{id}/testارسال تحویل آزمایشینیازمند کلید API

            پارامترها

            نامجایگاهنوعالزامتوضیح
            idمسیرstringالزامی

            پاسخ‌ها

            • ۲۰۲Event
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۴۰۹idempotency_conflictاین Idempotency-Key پیش‌تر با درخواست دیگری به کار رفته است.idempotency_in_progressدرخواستی با همین Idempotency-Key هنوز در حال پردازش است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl -X POST "https://api.taghvim.dev/v1/webhooks/{id}/test" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Idempotency-Key: $(uuidgen)"

            استاندارد اتصال پرداختاستاندارد اتصال پرداخت برای ساخت آداپتور خودتان.

            GET/v1/connectors/payment/standardاستاندارد اتصال پرداختبدون کلید

            پاسخ‌ها

            • ۲۰۰PaymentConnectorStandard
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/connectors/payment/standard" \
              -H "Accept: application/json"
            POST/v1/connectors/payment/manifests/validateبررسی مانیفست آداپتوربدون کلید

            بدنه‌ی درخواست

            پاسخ‌ها

            • ۲۰۰ManifestValidation
            • ۴۰۰invalid_jsonبدنه‌ی درخواست JSON معتبر نیست.validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۱۳payload_too_largeحجم بدنه‌ی درخواست بیش از حد مجاز است.
            • ۴۱۵unsupported_media_typeبدنه‌ی درخواست را با نوع application/json بفرستید.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl -X POST "https://api.taghvim.dev/v1/connectors/payment/manifests/validate" \
              -H "Accept: application/json" \
              -H "Content-Type: application/json" \
              -d '{}'

            publicationsتقویم‌های سازمانی در فضای کاری مجاز، انتشار عمومی و جست‌وجو.

            GET/v1/workspaces/currentدریافت فضای کاری و اختیار انتشارنیازمند کلید API

            پاسخ‌ها

            • ۲۰۰PublicationWorkspace
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/workspaces/current" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"
            POST/v1/calendarsایجاد پیش‌نویس تقویم سازمانینیازمند کلید API

            بدنه‌ی درخواست

            نامنوعالزامتوضیح
            versionintegerالزامیبازه: ۱……
            tenant_idstringالزامی
            workspace_idstringالزامی
            namespacestringالزامی
            calendar_idstringالزامی
            statusobjectالزامیمقدارها: draft، published، unpublished، archived
            visibilityobjectالزامیمقدارها: private، unlisted، public
            sector_packPublicationSectorPackالزامی
            sector_pack.idstringالزامی
            sector_pack.versionstringالزامی
            sector_pack.schema_refsstring[]الزامی
            sector_pack.policy_refsstring[]الزامی
            sector_pack.label_namespacestringاختیاری
            entitiesPublicationEntity[]الزامی
            entities[].idPublicationEntityIdالزامی
            entities[].kindstringالزامی
            entities[].namespacestringالزامی
            entities[].statusobjectالزامیمقدارها: draft، active، cancelled، archived
            entities[].visibilityobjectالزامیمقدارها: private، unlisted، public
            entities[].labelsobjectالزامی
            entities[].tagsstring[]اختیاری
            entities[].attributesobjectاختیاری
            entities[].evidence_refsstring[]اختیاری
            entities[].versionintegerاختیاریبازه: ۱……
            relationshipsPublicationRelationship[]الزامی
            relationships[].idstringالزامی
            relationships[].source_idstringالزامی
            relationships[].target_idstringالزامی
            relationships[].kindstringالزامی
            relationships[].rolestringاختیاری
            relationships[].policy_refstringالزامی
            relationships[].valid_fromstringاختیاری
            relationships[].valid_tostringاختیاری
            relationships[].federation_authority_refstringاختیاری
            relationships[].evidence_refsstring[]اختیاری
            occurrencesPublicationOccurrence[]الزامی
            occurrences[].idstringالزامی
            occurrences[].event_idstringالزامی
            occurrences[].starts_atstringالزامی
            occurrences[].ends_atstringالزامی
            occurrences[].timezonestringالزامی
            occurrences[].calendar_systemobjectالزامیمقدارها: gregorian، jalali، hijri، mixed
            occurrences[].temporal_policy_refstringالزامی
            occurrences[].ambiguityobjectاختیاریمقدارها: none، predicted، ambiguous، unresolved
            occurrences[].evidence_refsstring[]اختیاری
            labelsobjectاختیاری
            policy_refsstring[]اختیاری
            evidence_refsstring[]اختیاری

            پاسخ‌ها

            • ۲۰۱CalendarPublication
            • ۴۰۰idempotency_key_requiredاین عملیات به سرآیند Idempotency-Key نیاز دارد.invalid_jsonبدنه‌ی درخواست JSON معتبر نیست.validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.forbiddenاین اعتبارنامه اجازه‌ی انجام این کار را ندارد.
            • ۴۰۹idempotency_conflictاین Idempotency-Key پیش‌تر با درخواست دیگری به کار رفته است.idempotency_in_progressدرخواستی با همین Idempotency-Key هنوز در حال پردازش است.publication_conflictتقویم تکراری است، نسخهٔ آن تغییر کرده یا این انتقال وضعیت مجاز نیست.
            • ۴۱۳payload_too_largeحجم بدنه‌ی درخواست بیش از حد مجاز است.
            • ۴۱۵unsupported_media_typeبدنه‌ی درخواست را با نوع application/json بفرستید.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl -X POST "https://api.taghvim.dev/v1/calendars" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Idempotency-Key: $(uuidgen)" \
              -H "Content-Type: application/json" \
              -d '{"version":1,"tenant_id":"tenant_example","workspace_id":"workspace_example","namespace":"taghvim://example/calendar","calendar_id":"calendar_example_0001","status":"draft","visibility":"private","sector_pack":{"id":"example_0001","version":"1.0.0","schema_refs":[],"policy_refs":[]},"entities":[{"id":"calendar_example_0001","kind":"calendar","namespace":"taghvim://example/calendar","status":"active","visibility":"private","labels":{"fa":"تقویم نمونه"}}],"relationships":[],"occurrences":[]}'
            GET/v1/calendars/{calendar_id}دریافت تقویم فضای کاری مجازنیازمند کلید API

            پارامترها

            نامجایگاهنوعالزامتوضیح
            calendar_idمسیرstringالزامی

            پاسخ‌ها

            • ۲۰۰CalendarPublication
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/calendars/{calendar_id}" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"
            PATCH/v1/calendars/{calendar_id}ویرایش نسخه‌دار تقویم خصوصینیازمند کلید API

            پارامترها

            نامجایگاهنوعالزامتوضیح
            calendar_idمسیرstringالزامی

            بدنه‌ی درخواست

            نامنوعالزامتوضیح
            versionintegerالزامیبازه: ۱……
            tenant_idstringالزامی
            workspace_idstringالزامی
            namespacestringالزامی
            calendar_idstringالزامی
            statusobjectالزامیمقدارها: draft، published، unpublished، archived
            visibilityobjectالزامیمقدارها: private، unlisted، public
            sector_packPublicationSectorPackالزامی
            sector_pack.idstringالزامی
            sector_pack.versionstringالزامی
            sector_pack.schema_refsstring[]الزامی
            sector_pack.policy_refsstring[]الزامی
            sector_pack.label_namespacestringاختیاری
            entitiesPublicationEntity[]الزامی
            entities[].idPublicationEntityIdالزامی
            entities[].kindstringالزامی
            entities[].namespacestringالزامی
            entities[].statusobjectالزامیمقدارها: draft، active، cancelled، archived
            entities[].visibilityobjectالزامیمقدارها: private، unlisted، public
            entities[].labelsobjectالزامی
            entities[].tagsstring[]اختیاری
            entities[].attributesobjectاختیاری
            entities[].evidence_refsstring[]اختیاری
            entities[].versionintegerاختیاریبازه: ۱……
            relationshipsPublicationRelationship[]الزامی
            relationships[].idstringالزامی
            relationships[].source_idstringالزامی
            relationships[].target_idstringالزامی
            relationships[].kindstringالزامی
            relationships[].rolestringاختیاری
            relationships[].policy_refstringالزامی
            relationships[].valid_fromstringاختیاری
            relationships[].valid_tostringاختیاری
            relationships[].federation_authority_refstringاختیاری
            relationships[].evidence_refsstring[]اختیاری
            occurrencesPublicationOccurrence[]الزامی
            occurrences[].idstringالزامی
            occurrences[].event_idstringالزامی
            occurrences[].starts_atstringالزامی
            occurrences[].ends_atstringالزامی
            occurrences[].timezonestringالزامی
            occurrences[].calendar_systemobjectالزامیمقدارها: gregorian، jalali، hijri، mixed
            occurrences[].temporal_policy_refstringالزامی
            occurrences[].ambiguityobjectاختیاریمقدارها: none، predicted، ambiguous، unresolved
            occurrences[].evidence_refsstring[]اختیاری
            labelsobjectاختیاری
            policy_refsstring[]اختیاری
            evidence_refsstring[]اختیاری

            پاسخ‌ها

            • ۲۰۰CalendarPublication
            • ۴۰۰idempotency_key_requiredاین عملیات به سرآیند Idempotency-Key نیاز دارد.invalid_jsonبدنه‌ی درخواست JSON معتبر نیست.validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.forbiddenاین اعتبارنامه اجازه‌ی انجام این کار را ندارد.
            • ۴۰۹idempotency_conflictاین Idempotency-Key پیش‌تر با درخواست دیگری به کار رفته است.idempotency_in_progressدرخواستی با همین Idempotency-Key هنوز در حال پردازش است.publication_conflictتقویم تکراری است، نسخهٔ آن تغییر کرده یا این انتقال وضعیت مجاز نیست.
            • ۴۱۳payload_too_largeحجم بدنه‌ی درخواست بیش از حد مجاز است.
            • ۴۱۵unsupported_media_typeبدنه‌ی درخواست را با نوع application/json بفرستید.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl -X PATCH "https://api.taghvim.dev/v1/calendars/{calendar_id}" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Idempotency-Key: $(uuidgen)" \
              -H "Content-Type: application/json" \
              -d '{"version":1,"tenant_id":"tenant_example","workspace_id":"workspace_example","namespace":"taghvim://example/calendar","calendar_id":"calendar_example_0001","status":"draft","visibility":"private","sector_pack":{"id":"example_0001","version":"1.0.0","schema_refs":[],"policy_refs":[]},"entities":[{"id":"calendar_example_0001","kind":"calendar","namespace":"taghvim://example/calendar","status":"active","visibility":"private","labels":{"fa":"تقویم نمونه"}}],"relationships":[],"occurrences":[]}'
            POST/v1/calendars/{calendar_id}/publishانتشار اتمیک نمای عمومی تقویمنیازمند کلید API

            پارامترها

            نامجایگاهنوعالزامتوضیح
            calendar_idمسیرstringالزامی

            بدنه‌ی درخواست

            نامنوعالزامتوضیح
            expected_versionintegerالزامیبازه: ۱……

            پاسخ‌ها

            • ۲۰۰CalendarPublication
            • ۴۰۰idempotency_key_requiredاین عملیات به سرآیند Idempotency-Key نیاز دارد.invalid_jsonبدنه‌ی درخواست JSON معتبر نیست.validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.forbiddenاین اعتبارنامه اجازه‌ی انجام این کار را ندارد.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۴۰۹idempotency_conflictاین Idempotency-Key پیش‌تر با درخواست دیگری به کار رفته است.idempotency_in_progressدرخواستی با همین Idempotency-Key هنوز در حال پردازش است.publication_conflictتقویم تکراری است، نسخهٔ آن تغییر کرده یا این انتقال وضعیت مجاز نیست.
            • ۴۱۳payload_too_largeحجم بدنه‌ی درخواست بیش از حد مجاز است.
            • ۴۱۵unsupported_media_typeبدنه‌ی درخواست را با نوع application/json بفرستید.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl -X POST "https://api.taghvim.dev/v1/calendars/{calendar_id}/publish" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Idempotency-Key: $(uuidgen)" \
              -H "Content-Type: application/json" \
              -d '{"expected_version":1}'
            POST/v1/calendars/{calendar_id}/unpublishلغو انتشار عمومی تقویمنیازمند کلید API

            پارامترها

            نامجایگاهنوعالزامتوضیح
            calendar_idمسیرstringالزامی

            بدنه‌ی درخواست

            نامنوعالزامتوضیح
            expected_versionintegerالزامیبازه: ۱……

            پاسخ‌ها

            • ۲۰۰CalendarPublication
            • ۴۰۰idempotency_key_requiredاین عملیات به سرآیند Idempotency-Key نیاز دارد.invalid_jsonبدنه‌ی درخواست JSON معتبر نیست.validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.forbiddenاین اعتبارنامه اجازه‌ی انجام این کار را ندارد.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۴۰۹idempotency_conflictاین Idempotency-Key پیش‌تر با درخواست دیگری به کار رفته است.idempotency_in_progressدرخواستی با همین Idempotency-Key هنوز در حال پردازش است.publication_conflictتقویم تکراری است، نسخهٔ آن تغییر کرده یا این انتقال وضعیت مجاز نیست.
            • ۴۱۳payload_too_largeحجم بدنه‌ی درخواست بیش از حد مجاز است.
            • ۴۱۵unsupported_media_typeبدنه‌ی درخواست را با نوع application/json بفرستید.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl -X POST "https://api.taghvim.dev/v1/calendars/{calendar_id}/unpublish" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Idempotency-Key: $(uuidgen)" \
              -H "Content-Type: application/json" \
              -d '{"expected_version":1}'
            GET/v1/public/calendars/{calendar_id}نمای عمومی مجاز تقویمبدون کلید

            پارامترها

            نامجایگاهنوعالزامتوضیح
            calendar_idمسیرstringالزامی

            پاسخ‌ها

            • ۲۰۰PublicCalendarView
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/public/calendars/{calendar_id}" \
              -H "Accept: application/json"
            GET/v1/public/calendars/{calendar_id}/icsدریافت اشتراک استاندارد ICS تقویم عمومیبدون کلید

            پارامترها

            نامجایگاهنوعالزامتوضیح
            calendar_idمسیرstringالزامی

            پاسخ‌ها

            • ۲۰۰
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/public/calendars/{calendar_id}/ics" \
              -H "Accept: text/calendar"
            GET/v1/public/calendar-searchجست‌وجوی تقویم‌های منتشرشدهبدون کلید

            پارامترها

            نامجایگاهنوعالزامتوضیح
            qپرس‌وجوstringاختیاری
            limitپرس‌وجوintegerاختیاری

            پاسخ‌ها

            • ۲۰۰PublicCalendarSearchResult
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/public/calendar-search" \
              -H "Accept: application/json"
            POST/v1/workspacesایجاد فضای کاری فرزند با مجوز مالکنیازمند کلید API

            ایجاد فضای کاری فرزند با مجوز مالک

            بدنه‌ی درخواست

            نامنوعالزامتوضیح
            kindobjectالزامیمقدارها: organisation، partner، reseller، distributor، department، team، customer، agent

            پاسخ‌ها

            • ۲۰۱PublicationWorkspace
            • ۴۰۰idempotency_key_requiredاین عملیات به سرآیند Idempotency-Key نیاز دارد.invalid_jsonبدنه‌ی درخواست JSON معتبر نیست.validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.forbiddenاین اعتبارنامه اجازه‌ی انجام این کار را ندارد.
            • ۴۰۹idempotency_conflictاین Idempotency-Key پیش‌تر با درخواست دیگری به کار رفته است.idempotency_in_progressدرخواستی با همین Idempotency-Key هنوز در حال پردازش است.publication_conflictتقویم تکراری است، نسخهٔ آن تغییر کرده یا این انتقال وضعیت مجاز نیست.
            • ۴۱۳payload_too_largeحجم بدنه‌ی درخواست بیش از حد مجاز است.
            • ۴۱۵unsupported_media_typeبدنه‌ی درخواست را با نوع application/json بفرستید.
            • ۴۲۹quota_exceededسهمیه‌ی ماهانه‌ی عملیات پلن شما تمام شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl -X POST "https://api.taghvim.dev/v1/workspaces" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Idempotency-Key: $(uuidgen)" \
              -H "Content-Type: application/json" \
              -d '{"kind":"partner"}'
            GET/v1/workspaces/{workspace_id}خواندن فضای کاری دارای مجوزنیازمند کلید API

            خواندن فضای کاری دارای مجوز

            پارامترها

            نامجایگاهنوعالزامتوضیح
            workspace_idمسیرstringالزامی

            پاسخ‌ها

            • ۲۰۰PublicationWorkspace
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.forbiddenاین اعتبارنامه اجازه‌ی انجام این کار را ندارد.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۴۲۹quota_exceededسهمیه‌ی ماهانه‌ی عملیات پلن شما تمام شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/workspaces/{workspace_id}" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"
            POST/v1/calendars/{calendar_id}/eventsایجاد رویداد نسخه‌دار در گراف تقویم خصوصینیازمند کلید API

            ایجاد رویداد نسخه‌دار در گراف تقویم خصوصی

            پارامترها

            نامجایگاهنوعالزامتوضیح
            calendar_idمسیرstringالزامی

            بدنه‌ی درخواست

            نامنوعالزامتوضیح
            expected_versionintegerالزامیبازه: ۱……
            entityPublicationEntityالزامی
            entity.idPublicationEntityIdالزامی
            entity.kindstringالزامی
            entity.namespacestringالزامی
            entity.statusobjectالزامیمقدارها: draft، active، cancelled، archived
            entity.visibilityobjectالزامیمقدارها: private، unlisted، public
            entity.labelsobjectالزامی
            entity.tagsstring[]اختیاری
            entity.attributesobjectاختیاری
            entity.evidence_refsstring[]اختیاری
            entity.versionintegerاختیاریبازه: ۱……
            occurrencesPublicationOccurrence[]الزامی
            occurrences[].idstringالزامی
            occurrences[].event_idstringالزامی
            occurrences[].starts_atstringالزامی
            occurrences[].ends_atstringالزامی
            occurrences[].timezonestringالزامی
            occurrences[].calendar_systemobjectالزامیمقدارها: gregorian، jalali، hijri، mixed
            occurrences[].temporal_policy_refstringالزامی
            occurrences[].ambiguityobjectاختیاریمقدارها: none، predicted، ambiguous، unresolved
            occurrences[].evidence_refsstring[]اختیاری

            پاسخ‌ها

            • ۲۰۱CalendarEventMutationResult
            • ۴۰۰idempotency_key_requiredاین عملیات به سرآیند Idempotency-Key نیاز دارد.invalid_jsonبدنه‌ی درخواست JSON معتبر نیست.validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.forbiddenاین اعتبارنامه اجازه‌ی انجام این کار را ندارد.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۴۰۹idempotency_conflictاین Idempotency-Key پیش‌تر با درخواست دیگری به کار رفته است.idempotency_in_progressدرخواستی با همین Idempotency-Key هنوز در حال پردازش است.publication_conflictتقویم تکراری است، نسخهٔ آن تغییر کرده یا این انتقال وضعیت مجاز نیست.
            • ۴۱۳payload_too_largeحجم بدنه‌ی درخواست بیش از حد مجاز است.
            • ۴۱۵unsupported_media_typeبدنه‌ی درخواست را با نوع application/json بفرستید.
            • ۴۲۹quota_exceededسهمیه‌ی ماهانه‌ی عملیات پلن شما تمام شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl -X POST "https://api.taghvim.dev/v1/calendars/{calendar_id}/events" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Idempotency-Key: $(uuidgen)" \
              -H "Content-Type: application/json" \
              -d '{"expected_version":1,"entity":{"id":"example_0001","kind":"rel_example_00000001","namespace":"taghvim://example/calendar","status":"draft","visibility":"private","labels":{"example":"taghvim://example/calendar"}},"occurrences":[{"id":"occ_example_00000001","event_id":"taghvim://example/calendar","starts_at":"2026-11-19T09:00:00Z","ends_at":"2026-11-19T10:00:00Z","timezone":"Asia/Tehran","calendar_system":"gregorian","temporal_policy_ref":"policy_example"}]}'
            GET/v1/calendars/{calendar_id}/eventsفهرست رویدادهای خصوصی در فضای کاری مجازنیازمند کلید API

            فهرست رویدادهای خصوصی در فضای کاری مجاز

            پارامترها

            نامجایگاهنوعالزامتوضیح
            calendar_idمسیرstringالزامی

            پاسخ‌ها

            • ۲۰۰CalendarEventList
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.forbiddenاین اعتبارنامه اجازه‌ی انجام این کار را ندارد.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۴۲۹quota_exceededسهمیه‌ی ماهانه‌ی عملیات پلن شما تمام شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/calendars/{calendar_id}/events" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY"
            PATCH/v1/calendars/{calendar_id}/events/{event_id}ویرایش رویداد با مقایسهٔ اتمیک نسخهنیازمند کلید API

            ویرایش رویداد با مقایسهٔ اتمیک نسخه

            پارامترها

            نامجایگاهنوعالزامتوضیح
            calendar_idمسیرstringالزامی
            event_idمسیرPublicationEntityIdالزامی

            بدنه‌ی درخواست

            نامنوعالزامتوضیح
            expected_versionintegerالزامیبازه: ۱……
            entityPublicationEntityالزامی
            entity.idPublicationEntityIdالزامی
            entity.kindstringالزامی
            entity.namespacestringالزامی
            entity.statusobjectالزامیمقدارها: draft، active، cancelled، archived
            entity.visibilityobjectالزامیمقدارها: private، unlisted، public
            entity.labelsobjectالزامی
            entity.tagsstring[]اختیاری
            entity.attributesobjectاختیاری
            entity.evidence_refsstring[]اختیاری
            entity.versionintegerاختیاریبازه: ۱……
            occurrencesPublicationOccurrence[]الزامی
            occurrences[].idstringالزامی
            occurrences[].event_idstringالزامی
            occurrences[].starts_atstringالزامی
            occurrences[].ends_atstringالزامی
            occurrences[].timezonestringالزامی
            occurrences[].calendar_systemobjectالزامیمقدارها: gregorian، jalali، hijri، mixed
            occurrences[].temporal_policy_refstringالزامی
            occurrences[].ambiguityobjectاختیاریمقدارها: none، predicted، ambiguous، unresolved
            occurrences[].evidence_refsstring[]اختیاری

            پاسخ‌ها

            • ۲۰۰CalendarEventMutationResult
            • ۴۰۰idempotency_key_requiredاین عملیات به سرآیند Idempotency-Key نیاز دارد.invalid_jsonبدنه‌ی درخواست JSON معتبر نیست.validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.forbiddenاین اعتبارنامه اجازه‌ی انجام این کار را ندارد.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۴۰۹idempotency_conflictاین Idempotency-Key پیش‌تر با درخواست دیگری به کار رفته است.idempotency_in_progressدرخواستی با همین Idempotency-Key هنوز در حال پردازش است.publication_conflictتقویم تکراری است، نسخهٔ آن تغییر کرده یا این انتقال وضعیت مجاز نیست.
            • ۴۱۳payload_too_largeحجم بدنه‌ی درخواست بیش از حد مجاز است.
            • ۴۱۵unsupported_media_typeبدنه‌ی درخواست را با نوع application/json بفرستید.
            • ۴۲۹quota_exceededسهمیه‌ی ماهانه‌ی عملیات پلن شما تمام شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl -X PATCH "https://api.taghvim.dev/v1/calendars/{calendar_id}/events/{event_id}" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Idempotency-Key: $(uuidgen)" \
              -H "Content-Type: application/json" \
              -d '{"expected_version":1,"entity":{"id":"example_0001","kind":"rel_example_00000001","namespace":"taghvim://example/calendar","status":"draft","visibility":"private","labels":{"example":"taghvim://example/calendar"}},"occurrences":[{"id":"occ_example_00000001","event_id":"taghvim://example/calendar","starts_at":"2026-11-19T09:00:00Z","ends_at":"2026-11-19T10:00:00Z","timezone":"Asia/Tehran","calendar_system":"gregorian","temporal_policy_ref":"policy_example"}]}'
            GET/v1/public/calendars/{calendar_id}/eventsفهرست فقط رویدادهای صریحاً منتشرشدهبدون کلید

            فهرست فقط رویدادهای صریحاً منتشرشده

            پارامترها

            نامجایگاهنوعالزامتوضیح
            calendar_idمسیرstringالزامی

            پاسخ‌ها

            • ۲۰۰PublicCalendarEventsResult
            • ۴۰۰validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl "https://api.taghvim.dev/v1/public/calendars/{calendar_id}/events" \
              -H "Accept: application/json"
            POST/v1/public/calendars/{calendar_id}/subscriptionsاشتراک ثبت‌شدهٔ خوراک ICS فقط برای تقویم عمومینیازمند کلید API

            اشتراک ثبت‌شدهٔ خوراک ICS فقط برای تقویم عمومی

            پارامترها

            نامجایگاهنوعالزامتوضیح
            calendar_idمسیرstringالزامی

            بدنه‌ی درخواست

            نامنوعالزامتوضیح
            channelobjectالزامی

            پاسخ‌ها

            • ۲۰۱FeedSubscription
            • ۴۰۰idempotency_key_requiredاین عملیات به سرآیند Idempotency-Key نیاز دارد.invalid_jsonبدنه‌ی درخواست JSON معتبر نیست.validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.forbiddenاین اعتبارنامه اجازه‌ی انجام این کار را ندارد.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۴۰۹idempotency_conflictاین Idempotency-Key پیش‌تر با درخواست دیگری به کار رفته است.idempotency_in_progressدرخواستی با همین Idempotency-Key هنوز در حال پردازش است.publication_conflictتقویم تکراری است، نسخهٔ آن تغییر کرده یا این انتقال وضعیت مجاز نیست.
            • ۴۱۳payload_too_largeحجم بدنه‌ی درخواست بیش از حد مجاز است.
            • ۴۱۵unsupported_media_typeبدنه‌ی درخواست را با نوع application/json بفرستید.
            • ۴۲۹quota_exceededسهمیه‌ی ماهانه‌ی عملیات پلن شما تمام شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl -X POST "https://api.taghvim.dev/v1/public/calendars/{calendar_id}/subscriptions" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Idempotency-Key: $(uuidgen)" \
              -H "Content-Type: application/json" \
              -d '{"channel":"ics"}'
            PATCH/v1/calendars/{calendar_id}/notification-preferencesثبت ترجیحات اعلان؛ فعال‌سازی بدون کانال تحویل معتبر ممنوعنیازمند کلید API

            ثبت ترجیحات اعلان؛ فعال‌سازی بدون کانال تحویل معتبر ممنوع

            پارامترها

            نامجایگاهنوعالزامتوضیح
            calendar_idمسیرstringالزامی

            بدنه‌ی درخواست

            نامنوعالزامتوضیح
            enabledbooleanالزامی
            channelsobject[]الزامی
            expected_versionintegerالزامیبازه: ۰……

            پاسخ‌ها

            • ۲۰۰NotificationPreferences
            • ۴۰۰idempotency_key_requiredاین عملیات به سرآیند Idempotency-Key نیاز دارد.invalid_jsonبدنه‌ی درخواست JSON معتبر نیست.validation_failedدرخواست با قرارداد API هم‌خوان نیست.
            • ۴۰۱key_revokedاین کلید API باطل شده است.unauthorizedبرای این درخواست کلید API معتبر لازم است.
            • ۴۰۳entitlement_requiredپلن فعلی شما این قابلیت را ندارد.forbiddenاین اعتبارنامه اجازه‌ی انجام این کار را ندارد.
            • ۴۰۴not_foundمنبع خواسته‌شده پیدا نشد.
            • ۴۰۹idempotency_conflictاین Idempotency-Key پیش‌تر با درخواست دیگری به کار رفته است.idempotency_in_progressدرخواستی با همین Idempotency-Key هنوز در حال پردازش است.
            • ۴۱۳payload_too_largeحجم بدنه‌ی درخواست بیش از حد مجاز است.
            • ۴۱۵unsupported_media_typeبدنه‌ی درخواست را با نوع application/json بفرستید.
            • ۴۲۹quota_exceededسهمیه‌ی ماهانه‌ی عملیات پلن شما تمام شده است.
            • ۵۰۰internal_errorخطای پیش‌بینی‌نشده‌ای رخ داد.

            امتحان کنید

            فراخوانی واقعی روی حساب شما اجرا می‌شود و در مصرف شما به حساب می‌آید.

            وضعیت: —

            پاسخ
            پاسخ پس از ارسال اینجا نمایش داده می‌شود.
            curl
            curl -X PATCH "https://api.taghvim.dev/v1/calendars/{calendar_id}/notification-preferences" \
              -H "Accept: application/json" \
              -H "Authorization: Bearer TAGHVIM_API_KEY" \
              -H "Idempotency-Key: $(uuidgen)" \
              -H "Content-Type: application/json" \
              -d '{"expected_version":0,"enabled":false,"channels":[]}'

            این صفحه نسخهٔ مشخصی از قرارداد API را نمایش می‌دهد. نمونه‌های تقویم در مرورگر اجرا می‌شوند. پیش از استفادهٔ واقعی، نسخهٔ مستندات باید با API منتشرشده تطبیق داده شود.

            محیط تست زمانی

            با ساعت آزمایشی، رفتارهای آینده را پیش‌نمایش کنید.

            ساعت نمایشی را ثابت نگه دارید یا جلو ببرید و اثر آن را بر سررسیدها و برنامه‌ها ببینید. این شبیه‌سازی در صفحه، جایگزین محیط آزمایشیِ دارای حساب و کلید API نیست.

            ساعت محیط تست۱۴۰۵/۰۷/۰۱، ساعت ۰۹:۰۰
            1. هنوز زمانی جلو نرفته است.

            فضای کاری نمونه: ۴ یادآور، ۲ برنامه و ۱ سررسید؛ روزهای کاری از موتور تقویم.

            آزمودن یک یادآور یک‌ماهه نباید یک ماه طول بکشد.

            کاربردها

            یک موتور زمان، برای ده‌ها مدل کسب‌وکار.

            تقویم، رزرو و گردش‌کارهای زمان‌دار را به محصولتان اضافه کنید، بی‌آنکه تیم بک‌اند زیرسیستم زمان بسازد.

            • ۱نرم‌افزار نوبت‌دهی
            • ۲مدیریت ارتباط با مشتری
            • ۳مدیریت پروژه
            • ۴بازارگاه آنلاین

            تاریخ‌های پیش رو، به حساب موتور تقویمموتور تقویم

            نخستین روز آزاد
            یکشنبه ۱ آذر ۱۴۰۵
            پیگیری
            سه‌شنبه ۳ آذر ۱۴۰۵
            تمدید اشتراک
            دوشنبه ۳۰ آذر ۱۴۰۵

            هر نقش، یک نما

            هر کس در سازمان همان چیزی را می‌بیند که به کارش می‌آید.

            یک نقش را انتخاب کنید تا ببینید از کدام رابط استفاده می‌کند، چه می‌بیند و چه به دست می‌آورد.

            نما: ترمینال و مستنداتنمونه؛ تاریخ‌ها را موتور تقویم حساب می‌کند
            درخواست
            POST /v1/business-days/add
            ۳۰ روز کاری پس از امروز
            یکشنبه ۶ دی ۱۴۰۵
            زمان پاسخ
            در مرورگر، بدون شبکه

            کارشمنطق تاریخ را نمی‌نویسد؛ فراخوانی‌اش می‌کند.

            عملیات‌های API

            از چه چیزهایی استفاده می‌کند

            • API
            • SDK
            • CLI
            • محیط تست

            نتیجهیک فراخوانی، به‌جای یک کتابخانه‌ی تاریخ و فایل دستی تعطیلات.

            سازمانی

            از نخستین فراخوانی API تا راه‌اندازی در کل سازمان.

            • چندمستأجری و ساختار سازمانی چندلایه
            • جداسازی فضاهای کاری
            • کنترل دسترسی نقش‌محور و سیاست‌ها
            • ردپای حسابرسی
            • قراردادها و رویدادهای نسخه‌دار
            • ایمنی در برابر تکرار
            • شواهد و رسیدها
            • محیط‌های اختصاصی
            • محیط تست، پیش‌انتشار و عملیاتی
            • بسته‌های تقویم سفارشی
            • اتصال‌دهنده‌های سفارشی
            • گزینه‌های SLA
            • استقرار خصوصی یا مدیریت‌شده، هر جا ارائه شود
            معماری هدف برای B2B، B2B2C و B2B2B2C طراحی شده است؛ تفویض دسترسی و صورتحساب چندلایه هنوز نیازمند آزمون و تأیید عملیاتی است.روی هر سطح بزنید تا کنسول مدیریت آن را ببینید.
            کنسول مدیریت (نمونه)سازماننمونه
            • مریم احمدیمالک
            • رضا کریمیمدیر

            مزایا

            زمان کمتری صرف ساخت و نگهداری منطق تکراری کنید.

            ۱

            مزیت ۱: زمان مهندسی

            منطق زمان را یک‌بار تعریف کنید و در بخش‌های مختلف به کار بگیرید.

            به‌جای نگهداری این‌ها:

            • تبدیل تاریخ شمسی
            • دادهٔ تعطیلات
            • تداخل رزروها
            • تلاش‌های دوباره
            • سررسیدها
            • تکرار
            • اجرای برنامه‌ها

            فقط یک سکو را به محصولتان وصل می‌کنید.

            ۲

            مزیت ۲: یکدستی

            همهٔ تیم‌ها یک تعریف از «زمان» دارند.

            دیگر هیچ‌کدام از این‌ها جداگانه حساب نمی‌کند:

            • بک‌اند
            • موبایل
            • مالی
            • عملیات
            • عامل هوشمند
            ۳

            مزیت ۳: عرضهٔ سریع‌تر

            قابلیت تازه را از اجزای پایهٔ آماده بسازید.

            ۴

            مزیت ۴: ریسک عملیاتی کمتر

            ایمنی در برابر تکرار، رسید، نسخه‌بندی و حسابرسی از ابتدا در طراحی بوده‌اند.

            ۵

            مزیت ۵: آماده برای عامل‌ها

            همان زیرساختی که آدم‌ها به کار می‌برند، برای عامل‌های هوشمند هم آماده است.

            بازگشت سرمایه

            هزینهٔ «خودمان می‌سازیم» را حساب کنید.

            ورودی‌های شما
            قیمت پلن‌ها را از ما بپرسید و برآورد خودتان را اینجا وارد کنید تا مقایسه کامل شود.
            هزینهٔ تخمینی ساخت داخلی—ساعت توسعهٔ اولیه × هزینهٔ هر ساعت
            هزینهٔ سالانهٔ نگهداری—ساعت نگهداری در ماه × ۱۲ × هزینهٔ هر ساعت
            هزینهٔ تکرار منطق در ۳ محصول—(ساخت + نگهداری سالانه) × (تعداد محصولات − ۱)
            سهم هر توسعه‌دهنده از ساعت‌های اولیه—

            ساخت داخلی

            مهندسی، نگهداری و تکرار

            اشتراک ما

            هزینهٔ پیش‌بینی‌پذیر اشتراک و مصرف

            قرار نیست ما در هر حالتی از کد داخلی ارزان‌تر باشیم. قرار است هزینهٔ ساخت، نگهداری، یکدستی و ریسک زیرساخت زمان را دیدنی و قابل مقایسه کنیم.

            همهٔ عددها از ورودی‌های خود شما حساب می‌شوند؛ هزینهٔ خرابی‌ها و رخدادها در این مدل نیامده است.

            کارهای عقب‌افتاده

            این‌ها دیگر در فهرست کارهای شما نیستند.

            • تبدیل تاریخ شمسی
            • به‌روزرسانی تعطیلات
            • شمارش روز کاری
            • موتور دسترس‌پذیری
            • قفل رزرو
            • تکرار
            • قاعده‌های سررسید
            • زمان‌بند
            • تلاش دوبارهٔ یادآورها
            • تحویل وب‌هوک
            • برنامهٔ عامل‌ها
            • شبیه‌سازی زمان
            محصولتان را عرضه کنید

            اطمینان‌پذیری

            زیرساخت زمان باید پیش‌بینی‌پذیر باشد.

            نسخه‌دار
            ساختار داده، رویداد، API و رفتار، بی‌نسخهٔ تازه تغییر نمی‌کنند.
            امن در تکرار
            برای عملیات حساس، سازوکار جلوگیری از اجرای تکراری طراحی شده و باید برای هر عملیات جداگانه آزموده شود.
            رویدادمحور
            تغییرهای مهم را می‌شود دنبال و بازپخش کرد.
            رسیددار
            هر عملیات مهم نتیجه و ردی دارد که می‌شود بررسی‌اش کرد.
            سیاست‌محور
            عملیات حساس می‌تواند به سیاست، دامنهٔ دسترسی و تأیید وابسته باشد.
            بازسازی‌پذیر
            نماهای داده را می‌شود از روی سابقه از نو ساخت.

            مقایسه

            کتابخانهٔ تاریخ، نرم‌افزار نوبت‌دهی، یا زیرساخت زمان؟

            • کتابخانهٔ تاریخ شمسی۱قابلیت کامل از ۱۳
            • نرم‌افزار نوبت‌دهی۳قابلیت کامل از ۱۳
            • زیرساخت زمان ما۱۳قابلیت کامل از ۱۳
            قابلیتکتابخانهٔ تاریخ شمسینرم‌افزار نوبت‌دهیزیرساخت زمان ما
            شمسی و میلادیداردگاهیدارد
            تعطیلاتمحدودگاهیدارد
            روزهای کاریمحدودمحدوددارد
            زمان‌بندی منابع—دارددارد
            API رزرو—وابسته به محصولدارد
            سررسیدها——دارد
            تکراردر حد کتابخانهدارددارد
            زمان‌بندی عامل‌ها——دارد
            MCP——دارد
            ویجت‌ها—دارددارد
            وب‌هوک و رویداد—گاهیدارد
            ساعت آزمایشی——دارد
            ساختن محصول خودتان روی آنمحدودمحدودبله

            ما جای محصول شما را نمی‌گیریم؛ زیرساختی هستیم که محصول شما روی آن ساخته می‌شود.

            قیمت‌گذاری

            دسترسی زودهنگام را درخواست کنید؛ پلن مناسب را بعداً انتخاب کنید.

            رایگان

            بدون کارت بانکی

            • API
            • SDK
            • MCP
            • ویجت‌های پایه
            • تقویم ایران
            • تبدیل تاریخ
            • تعطیلات
            • روزهای کاری
            • محیط تست

            سازنده

            برای توسعه‌دهندگان مستقل و محصولات کوچکِ در حال اجرا.

            با ما تماس بگیرید

            • سقف عملیات بالاتر
            • وب‌هوک‌ها
            • زمان‌بندی
            • سررسیدها
            • پروژه‌های بیشتر

            استارتاپ

            با ما تماس بگیرید

            • دسترس‌پذیری
            • رزرو
            • منابع
            • زمان‌بندی عامل‌ها
            • ویجت‌های بی‌نشان تجاری

            کسب‌وکار

            با ما تماس بگیرید

            • کنترل دسترسی نقش‌محور و حسابرسی
            • سیاست‌های پیشرفته
            • تقویم‌های سازمانی
            • پشتیبانی با اولویت

            سازمانی

            با ما تماس بگیرید

            • SLA سفارشی
            • گزینه‌های اختصاصی یا خصوصی
            • بسته‌ها و اتصال‌دهنده‌های سفارشی
            • راه‌اندازی همراه با پشتیبانی

            شروع رایگان است؛ برای پلن‌های بالاتر و سازمانی با ما تماس بگیرید.

            برای توسعه‌دهندگان

            یک کار، شش رابط.

            http
            POST /v1/reservations

            رابط عوض می‌شود؛ قرارداد عوض نمی‌شود.

            داشبورد

            همه‌چیز را ببینید، حتی اگر فقط با API کار می‌کنید.

            تقویم.dev™محیط تستten_acmeدادهٔ نمایشی
            مصرف این ماه

            ۱٫۲۸ از ۲ میلیون عملیات

            رویدادهای اخیر
            1. taghvim.event.reservation.confirmed.v1
            2. taghvim.event.schedule.triggered.v1
            3. taghvim.event.deadline.created.v1
            سلامت سرویس‌های متصل

            تقویم گوگل ✓وب‌هوک‌ها ✓

            نمای محصول

            همان موتور، درون اپلیکیشن، ایمیل و ترمینال شما.

            این نماها نمونه‌های تعاملی‌اند: انتخاب تاریخ در یک برنامهٔ بانکی، نمایش یادآوری و استفاده از ابزارهای توسعه. نمایش آن‌ها به معنای فعال‌بودن ارسال پیام یا SDK برای همهٔ کاربران نیست.

            بانک نمونهنمونه

            انتقال وجه زمان‌بندی‌شده

            از حساب
            جاری ۰۱۲۳
            به
            شرکت پارس‌ابزار

            انجام انتقال

            انتخابگر تاریخ ما درون اپلیکیشن یک بانک نمونه؛ روز انجام انتقال را موتور تقویم می‌دهد.
            یادآور در ایمیل و روی گوشینمونه
            سامانه‌ی قراردادهای نمونهnoreply@example.com

            یادآوری: سررسید قرارداد، ۳ آذر ۱۴۰۵

            سلام خانم رضایی،

            قرارداد نمونه‌ی ۱۲۴۰ روز سه‌شنبه ۳ آذر ۱۴۰۵ سررسید می‌شود. این یادآور ۳ روز کاری پیش از سررسید فرستاده شده است.

            قراردادها · اکنونسررسید نزدیک است

            قرارداد ۱۲۴۰: ۳ آذر ۱۴۰۵

            متن و نام‌ها نمونه‌اند؛ تاریخ سررسید را موتور تقویم حساب می‌کند.

            بازارچه

            از هسته شروع کنید؛ با بسته‌ها گسترش دهید.

            ساخت خود ما

            روی هر بسته بزنید تا محتوایش را ببینید.

            در آینده

            • بستهٔ تقویم بانکی
            • بستهٔ مهلت‌های قانونی
            • بستهٔ حقوق و دستمزد
            • بستهٔ زمان‌بندی درمانی
            • اتصال‌دهنده‌ها
            • ویجت‌ها

            بازارچه برای گسترش زیست‌بوم است، نه شرطی برای اینکه از روز اول بتوانید از ما استفاده کنید.

            سناریوهای نمونه

            سه سناریوی نمونه

            این‌ها سناریوهای فرضی‌اند، نه نظر یا تجربهٔ مشتری واقعی.

            نمونهٔ فرضی

            «یک سرویس نوبت‌دهی آنلاین»

            قبل: تقویم شمسی، دسترس‌پذیری، یادآور و منطق تداخل، در سه سرویس جدا.

            بعد: تیم محصول فقط گردش‌کار و تجربهٔ مشتری را می‌سازد.

            نمونهٔ فرضی

            «یک فین‌تک»

            قبل: تسویه، صورت‌حساب و عملیات هر کدام روز کاری را جور دیگری می‌شمارند.

            بعد: یک بستهٔ تقویم و یک محاسبهٔ مرجع.

            نمونهٔ فرضی

            «یک سکوی عامل‌های هوشمند»

            قبل: کارهای تکرارشونده و سقف‌های مصرف در کد اپلیکیشن پنهان‌اند.

            بعد: برنامهٔ هر عامل دیدنی است، تابع سیاست است و سنجیده می‌شود.

            پرسش‌ها

            پرسش‌های پرتکرار

            آیا شما یک تقویم آنلاین هستید؟

            نه. ما زیرساختی هستیم برای ساختن قابلیت‌های زمان و زمان‌بندی درون محصول‌های دیگر.

            فقط به کار تاریخ شمسی می‌آیید؟

            نه. اولویت طراحی ما ایران است، اما مدل زمانی ما شمسی، میلادی و قمری را پوشش می‌دهد.

            آیا باید از ویجت‌های شما استفاده کنم؟

            نه. ویجت‌ها اختیاری‌اند. پس از دریافت دسترسی معتبر می‌توانید از API استفاده کنید و رابط کاربری خودتان را بسازید؛ وضعیت عرضهٔ SDK و MCP جداگانه اعلام می‌شود.

            MCP به چه کاری می‌آید؟

            MCP رابط برنامه‌ریزی‌شده برای استفادهٔ کنترل‌شدهٔ عامل‌های هوشمند از قابلیت‌های زمانی است. دامنهٔ عملیات و زمان عرضه پس از تأیید اعلام می‌شود.

            با تقویم گوگل یا Outlook کار می‌کنید؟

            اتصال به تقویم گوگل و Outlook در نقشهٔ محصول است. پیش از استفاده، باید وضعیت عرضه و مجوزهای هر اتصال‌دهنده تأیید شود.

            جای Calendly یا نرم‌افزار نوبت‌دهی را می‌گیرید؟

            ما زیرساختی هستیم که می‌شود محصولی مثل آن‌ها را رویش ساخت؛ خودمان لزوماً نرم‌افزار نوبت‌دهی آماده برای کسب‌وکارها نیستیم.

            تعطیلات چطور مدیریت می‌شوند؟

            با بسته‌های تقویم نسخه‌دار، همراه با منشأ داده و امکان بازنویسی برای هر سازمان.

            اگر یک درخواست دو بار فرستاده شود، چه می‌شود؟

            برای عملیات تغییردهنده، شناسهٔ درخواست و سازوکار جلوگیری از تکرار در نظر گرفته شده است. رفتار هر عملیات باید با تست همان عملیات تأیید شود.

            می‌شود آینده را آزمود؟

            بله، پیش‌نمایش ساعت آزمایشی در همین صفحه وجود دارد. محیط Sandbox دارای حساب و کلید API، مسیر فعال‌سازی جداگانه‌ای دارد.

            برای سازمان‌های بزرگ مناسب است؟

            قابلیت‌هایی مانند جداسازی مشتریان، سیاست‌های دسترسی و حسابرسی در طراحی سازمانی پیش‌بینی شده‌اند؛ استفادهٔ عملیاتی هرکدام به تأیید و فعال‌سازی نیاز دارد.

            کارهای زمان را از فهرست عقب‌افتاده‌هایتان خط بزنید.

            با API تقویم شروع کنید. وقتی محصولتان بزرگ شد، همین زیرساخت در زمان‌بندی، رزرو، سررسید، گردش‌کار و عامل‌های هوشمند همراهتان است.

            بدون کارت بانکی · محیط آزمایشی مستقل · تأیید ایمیل و کلید ۳۰روزه

            دریافت کلید تست رایگان