خلاصه در یک نگاه: هزینه API به نوع کار بستگی دارد. طبق منابع عمومی بازار ۱۴۰۵، اتصال ساده به یک درگاه پرداخت یا سامانه پیامکی حدود ۳۰ تا ۷۰ میلیون تومان است و یکپارچهسازی سازمانی با همگامسازی دوطرفه حدود ۲۰۰ تا ۵۰۰ میلیون تومان. بعضی مجموعهها اتصالهای کوچک را از حدود ۱۰ میلیون تومان شروع میکنند. ساخت API کامل برای یک اپ معمولاً بخشی از هزینه بکاند است. فرق API ارزان با API قابل اعتماد در مستندات، امنیت، مدیریت خطا و تست است.
- در تعرفه رسمی ۱۴۰۵ نظام صنفی رایانهای، نرخ پایه هر نفر-ساعت برای شرکتها ۵۷۶ هزار تومان است و با ضریب نقش و سابقه بالا میرود.
- پشتیبانی سالانه نرمافزار در همان سند ۲۵ تا ۳۵ درصد هزینه تولید است؛ این را در بودجه سال اول ببینید.
- مستند OpenAPI، کلیدها و حسابها را روز تحویل به نام خودتان بگیرید.
بهروزرسانی: ۹ آبان ۱۴۰۵ — خلاصه اول مطلب بازنویسی شد، تعرفه رسمی ۱۴۰۵ و یک مثال محاسبه با آن اضافه شد، دو سؤال رایج تازه آمد و راهنماهای جدیدتر اتصالها لینک شد. عددهای بازار از منبعهای عمومی نقل شدهاند و قیمت پونوکد نیستند.
وقتی سایت شما باید به اپ موبایل، نرمافزار حسابداری، پنل نمایندگان یا یک سرویس بیرونی وصل شود، دیر یا زود اسم API وسط میآید. برنامهنویس میگوید «باید API نوشته شود» و شما میپرسید «چقدر؟». جوابهایی که میشنوید از ده میلیون تا چند صد میلیون تومان فاصله دارد و معمولاً کسی توضیح نمیدهد این فاصله از کجا میآید.
این مقاله برای همین سؤال نوشته شده. توضیح میدهیم API در پروژه شما دقیقاً چه کاری انجام میدهد، سه نوع پروژه API را از هم جدا میکنیم، بازه قیمت رایج بازار ۱۴۰۵ را بر اساس نوع کار (بدون نام مجموعه) کنار هم میگذاریم و عوامل هزینه را یکییکی باز میکنیم. بعد سراغ هزینههای ماهانه بعد از تحویل، روش مقایسه پیشنهادها و فهرست خروجیهایی میرویم که هر API خوب باید همراهش تحویل شود.
API در پروژه شما چه کاری میکند؟
API یک «در» استاندارد است که نرمافزارها از طریق آن با هم حرف میزنند. وقتی اپ موبایل فهرست محصولات را نشان میدهد، از API سایت میپرسد. وقتی سفارش ثبت میشود و فاکتور در حسابداری صادر میشود، دو سیستم از طریق API با هم کار کردهاند. وقتی پیامک تأیید سفارش میرسد، سایت به API سامانه پیامک درخواست فرستاده است.
برای کارفرما مهم است بداند API خوب سه ویژگی دارد: امن است (هر کسی نمیتواند اطلاعات را بخواند یا تغییر دهد)، مستند است (برنامهنویس دیگری بدون پرسیدن از سازنده بتواند از آن استفاده کند) و پایدار است (با تغییر یک بخش، بقیه از کار نمیافتند). نسخه سادهتر توضیح اتصالها را در یکپارچه سازی API؛ اتصال سایت به حسابداری، پیامک و درگاه آوردهایم.
یک اصطلاح دیگر هم زیاد میشنوید: وبهوک. API یعنی سیستم شما میپرسد و جواب میگیرد. وبهوک برعکس است: سیستم مقابل هر وقت اتفاقی افتاد (مثلاً پرداخت موفق شد) خودش خبر میدهد. خیلی از اتصالهای واقعی ترکیبی از هر دو هستند و این روی زمان کار اثر دارد.
سه نوع پروژه API که قیمتشان فرق دارد
| نوع پروژه | مثال | چه چیزی هزینه را میسازد |
|---|---|---|
| اتصال به API دیگران | درگاه پرداخت، پیامک، ترب، سرویس ارسال، حسابداری | کیفیت مستندات طرف مقابل، مدیریت خطا، همگامسازی یکطرفه یا دوطرفه |
| ساخت API برای محصول خودتان | API پشت اپ موبایل، پنل مدیریت یا سایت Next.js | تعداد بخشها (محصول، سفارش، کاربر...)، نقشها و منطق کسبوکار |
| API برای شرکا و نمایندگان | نمایندگان قیمت و موجودی را مستقیم از سیستم شما بگیرند | امنیت، کلید جداگانه هر شریک، محدودیت تعداد درخواست، مستندات عمومی، نسخهبندی |
بیشتر پروژههای واقعی ترکیبی از این سهاند. مثلاً فروشگاهی که اپ موبایل میسازد، هم API برای اپ خودش لازم دارد و هم اتصال به درگاه و پیامک.
اشتباه رایج این است که این سه را با یک نام صدا کنیم و یک قیمت بخواهیم. اتصال به درگاه پرداخت چند روز کار است؛ ساخت API که ده نماینده فروش به آن وصل شوند، یک پروژه کامل است.

قیمت API در بازار ۱۴۰۵؛ بر اساس نوع کار
برای تصویر واقعیتر، بازههایی را که تا مهر ۱۴۰۵ در صفحات عمومی قیمت و راهنماهای بازار دیده میشود، بدون نام مجموعه، بر اساس نوع کار جمع کردهایم. محدوده کار هر ردیف فرق دارد؛ این جدول برای مقایسه مستقیم پیشنهادها نیست، فقط نشان میدهد بازار در چه بازهای حرکت میکند. هیچکدام قیمت پونوکد نیست.
| نوع کار | بازه رایج بازار (تومان) | نفر-ساعت تقریبی | نکته |
|---|---|---|---|
| اتصال خیلی ساده به یک سرویس با مستند خوب | از حدود ۱۰ میلیون | معمولاً کم | کف بازار برای کار محدود؛ اغلب تست کامل و نگهداری جداست |
| اتصال درگاه پرداخت یا سامانه پیامک با تست | حدود ۳۰ تا ۷۰ میلیون | حدود ۴۰ تا ۸۰ | تأیید تراکنش سمت سرور و جلوگیری از ارسال تکراری باید داخل کار باشد |
| اتصال یکطرفه به حسابداری یا CRM | حدود ۵۰ تا ۱۵۰ میلیون | حدود ۸۰ تا ۲۰۰ | نگاشت کالا و مشتری و گزارش مغایرت معمولاً جا میافتد |
| همگامسازی دوطرفه سازمانی با ERP یا چند سامانه | حدود ۲۰۰ تا ۵۰۰ میلیون | حدود ۳۰۰ تا ۸۰۰ | بیشترین سهم مربوط به حل تداخل دادههاست؛ قیمت فقط بعد از دیدن هر دو سمت قابل اتکاست |
| سامانه اختصاصی با پنل، API و منطق کسبوکار | از حدود ۱۵۰ تا چند صد میلیون | وابسته به کل سامانه | API جزئی از کل است، نه یک قلم جدا در فاکتور |
| API پشت اپ موبایل یا پنل چندنقشی | معمولاً چند ده تا چند صد میلیون (بخشی از بکاند) | وابسته به بخشها و نقشها | جدا از فرانت یا اپ قیمت ندهید؛ با برنامهنویس بکاند ببینید |
| API عمومی برای شرکا و نمایندگان | سنگین؛ معمولاً از چند صد میلیون | زیاد | کلید جدا، سقف درخواست، نسخهبندی و مستندات عمومی |
| میانه بازار «طراحی و توسعه بکاند و API» در پروژههای ساخت اپ | حدود ۲۰٫۵ تا ۹۵ میلیون | — | میانه اعلامشده بازار پروژهای؛ بدون تعریف محدوده کار گمراهکننده است |
| کار خیلی کوچک روی سامانههای پروژه (رفع باگ یا یک مسیر) | حدود ۰٫۷ تا ۳ میلیون | نامشخص | معمولاً بدون تست، مستند و استقرار؛ با پروژه واقعی یکی نیست |
| قیمت توافقی بدون بازه | — | — | تا فهرست بخشها، جهت داده و سناریوی خطا روشن نشود، عدد قابل اتکا نیست |
«نفر-ساعت» یعنی تعداد ساعتی که یک متخصص روی کار میگذارد. وقتی پیشنهادی گرفتید، بپرسید چند نفر-ساعت برآورد شده و نرخ هر ساعت چقدر است؛ این دو عدد کنار هم، مقایسه را شفافتر میکنند. اگر کسی فقط یک عدد کلی میدهد و نمیتواند بگوید پشتش چند ساعت کار است، احتمالاً هنوز محدوده کار را دقیق نفهمیده است.
چرا کف بازار حدود ۱۰ میلیون و سقفش چند صد میلیون است؟ چون عدد پایین معمولاً برای اتصال یکطرفه و ساده با سرویسی است که مستندات خوب دارد، و عدد بالا برای وقتی که چند سیستم قدیمی باید داده را دوطرفه و بدون مغایرت با هم عوض کنند. برای تصویر کلی هزینه نرمافزار، هزینه ساخت نرمافزار اختصاصی را ببینید. هزینه پنل جدا را هم در هزینه ساخت پنل مدیریت ۱۴۰۵ نوشتهایم.
پیشنهاد قیمت API را چطور بخوانیم؟
بعضی جملهها در پیشنهاد قیمت خوشآیند به نظر میرسند ولی بعداً خرج اضافه میسازند. قبل از امضا اینها را روشن کنید:
| جمله در پیشنهاد | معمولاً یعنی چه | چه بخواهید |
|---|---|---|
| «اتصال API از ۱۰ میلیون» | کف برای کار خیلی محدود؛ محدوده هنوز معلوم نیست | فهرست مسیرها، تستها و سناریوی خطا پیوست شود |
| «API نامحدود» | تعداد بخشها و عملیات معلوم نیست | فهرست بخشها و عملیات امضاشده |
| «تست و مستند جدا حساب میشود» | کیفیت از قیمت اصلی حذف شده | مستند OpenAPI و تست مسیرهای اصلی داخل قیمت |
| «سرور و پیامک رایگان روی حساب ما» | دسترسی و صورتحساب به نام سازنده میماند | حسابها به نام شما؛ هزینه سرویسها جدا و روشن |
| «پشتیبانی مادامالعمر» | معمولاً بدون زمان پاسخ و بدون تعریف | مدت رفع اشکال، زمان پاسخ و کارهایی که شامل نمیشود |
| «قیمت توافقی» بدون بررسی دو سمت | هنوز محدوده کار فهمیده نشده | دسترسی آزمایشی و نمونه داده قبل از عدد نهایی |
| «یک هفته تحویل» | برای اتصال سازمانی غیرواقعی است مگر محدوده خیلی کوچک | زمان گرفتن دسترسی طرف مقابل جدا از زمان کدنویسی نوشته شود |
کار شما در کدام سطح است؟ هفت سناریوی رایج
جدول زیر سفارشهای رایج را از ساده به سنگین مرتب کرده است. سطح کار را نسبی نوشتهایم تا بتوانید پروژه خودتان را کنار یکی از ردیفها بگذارید و بفهمید به کدام بازه جدول قیمت بالاتر نزدیکتر است.
| سناریو | جهت داده | سطح کار | نکتهای که معمولاً جا میافتد |
|---|---|---|---|
| اتصال درگاه پرداخت به سایت اختصاصی | رفت و برگشت (درخواست و تأیید) | ساده | تأیید دوباره تراکنش در سمت سرور و بازگشت پول تراکنشهای ناقص |
| ورود با کد پیامکی و پیامک وضعیت سفارش | یکطرفه | ساده | محدود کردن تعداد درخواست کد تا هزینه پیامک بالا نرود |
| ارسال محصولات به ترب یا مقایسهگرها | یکطرفه | ساده تا متوسط | بهروز ماندن قیمت و موجودی و فیلدهای اجباری هر سرویس |
| ارسال سفارش و فاکتور به حسابداری | یکطرفه | متوسط | تطبیق کد کالا و مشتری بین دو سیستم و گزارش مغایرت |
| همگامسازی موجودی بین انبار، سایت و بازارگاهها | دوطرفه | متوسط تا سنگین | اینکه اگر همزمان دو جا کالا فروخته شد، کدام سیستم حرف آخر را میزند |
| API کامل پشت اپ موبایل یا پنل | دوطرفه | متوسط تا سنگین | جزو بکاند است؛ قیمتش به تعداد بخشها و نقشها گره خورده |
| API عمومی برای شرکا و نمایندگان | دوطرفه | سنگین | کلید جداگانه هر شریک، سقف درخواست، نسخهبندی و مستندات عمومی |
برای جزئیات هر کدام راهنمای جدا نوشتهایم: ورود با پیامک در سایت، اتصال سایت به ترب، اتصال سایت به نرمافزار حسابداری و اتصال فروشگاه به دیجی کالا و بازارگاهها.
هشت عاملی که هزینه API را تعیین میکند
۱. تعداد بخشها و عملیات
هر بخش (محصول، سفارش، مشتری، فاکتور) چند عملیات دارد: فهرست، جزئیات، ساختن، ویرایش، حذف، جستوجو. API با سه بخش و API با بیست بخش، فرق زمانی واضحی دارند. اگر فهرست بخشها را قبل از استعلام بنویسید، برآوردها خیلی به هم نزدیکتر میشوند.
۲. احراز هویت و نقشها
آیا فقط اپ خودتان به API وصل میشود یا کاربران با نقشهای مختلف و شرکای بیرونی هم؟ ورود با توکن، تمدید خودکار، کلید جداگانه برای هر شریک و محدود کردن دسترسی هر نقش، هر کدام کار جداگانه است.
۳. منطق کسبوکار
محاسبه قیمت با تخفیف پلکانی، رزرو موجودی تا پرداخت، محاسبه پورسانت یا قوانین مالیاتی، بخش سنگین API هستند. این قوانین را از اول روی کاغذ بیاورید؛ قانونی که وسط کار اضافه شود، معمولاً چند بخش دیگر را هم تغییر میدهد.
۴. همگامسازی یکطرفه یا دوطرفه
فرستادن سفارش به حسابداری یکطرفه است. وقتی موجودی هم باید از حسابداری به سایت برگردد و تداخلها حل شوند، پیچیدگی چند برابر میشود. همین تفاوت، بازه چند ده میلیونی را به بازه چند صد میلیونی میرساند.
۵. کیفیت API طرف مقابل
بعضی سرویسها مستندات دقیق و محیط تست دارند. بعضی دیگر مستندات ناقص دارند و برنامهنویس باید با آزمونوخطا کار کند. نرمافزارهای حسابداری قدیمی گاهی اصلاً API ندارند و باید از راه پایگاه داده یا فایل خروجی وصل شد. قبل از برآورد، مستندات سرویس مقصد را در اختیار برنامهنویس بگذارید.
۶. مستندات
API بدون مستندات، شما را به سازندهاش وابسته میکند. در صفحه خدمات API پونوکد آمده که مستندات با استاندارد OpenAPI (نمای Swagger یا Redoc) و مجموعه درخواستهای Postman تحویل میشود تا برنامهنویس جدید بدون پرسیدن کار کند. این کار زمان دارد و باید در برآورد باشد.
۷. امنیت و محدودیت درخواست
اعتبارسنجی دقیق ورودیها، محدودیت تعداد درخواست برای جلوگیری از سوءاستفاده، ثبت لاگ و بررسی امنیتی قبل از انتشار. API عمومی بدون اینها خطرناک است. برای فهرست کاملتر، چکلیست امنیت سایت را هم ببینید.
۸. تست، پایش و نگهداری
تست خودکار، تست بار برای API پرترافیک، هشدار هنگام قطعی و اصلاح وقتی سرویس طرف مقابل نسخهاش را عوض میکند. مستندات API سرویسهای واسط معمولاً تغییر میکنند و نگهداری آن هزینه جاری دارد.

وقتی اتصال قطع میشود چه اتفاقی میافتد؟
این بخش در بیشتر پیشنهادهای ارزان دیده نمیشود، ولی بیشترین ضرر را همینجا میبینید. فرض کنید سرویس حسابداری نیم ساعت در دسترس نیست و در همین مدت بیست سفارش ثبت میشود. اتصال ضعیف این سفارشها را بیصدا رها میکند و آخر ماه حسابدار با مغایرت روبهرو میشود. اتصال درست سه کار انجام میدهد:
- صف و تلاش دوباره: سفارشهایی که نرسیدهاند در صف میمانند و بعد از برگشتن سرویس، خودکار دوباره فرستاده میشوند.
- جلوگیری از ثبت تکراری: هر درخواست یک شناسه یکتا دارد تا اگر دو بار فرستاده شد، فاکتور دو بار صادر نشود. شناسه رخداد و جلوگیری از تکرار جزو کیفیت اتصال است، نه امکانات لوکس.
- گزارش و هشدار: یک صفحه ساده که نشان دهد چه چیزی نرسیده و چرا، و پیامی که به مسئول خبر بدهد.
همین سؤال را از هر پیشنهاددهنده بپرسید: «اگر سرویس مقابل یک ساعت قطع شود، دقیقاً چه میشود؟». جواب این سؤال خیلی بهتر از رزومه نشان میدهد با چه کسی طرف هستید.
مراحل اجرای پروژه API
| مرحله | چه اتفاقی میافتد | خروجی قابل تحویل |
|---|---|---|
| بررسی و طراحی قرارداد API | فهرست بخشها، ورودی و خروجی هر درخواست، نقشها و قوانین | پیشنویس مستندات قبل از کدنویسی |
| پیادهسازی | نوشتن API، احراز هویت، اعتبارسنجی و مدیریت خطا | API روی محیط آزمایشی |
| اتصال به سرویسهای بیرونی | درگاه، پیامک، حسابداری یا هر سرویس دیگر | تست موفق هر اتصال با داده آزمایشی |
| تست و بررسی امنیتی | تست خودکار، تست بار در صورت نیاز، بررسی دسترسیها | گزارش تست |
| انتشار و تحویل | نصب روی سرور اصلی، تنظیم پایش و هشدار | API فعال، مستندات نهایی، کلیدهای دسترسی |
مرحله اول را «طراحی قرارداد API» میگویند و مهمترین مرحله است. وقتی ورودی و خروجیها قبل از کدنویسی روی کاغذ تأیید شود، سازنده اپ موبایل و سازنده بکاند میتوانند همزمان کار کنند و بعداً دعوای «اطلاعات را اینطور نمیخواستیم» پیش نمیآید. اگر هنوز نیازها را مکتوب نکردهاید، سند نیازمندی نرمافزار نقطه شروع خوبی است.
پرداخت مرحلهای؛ پول را به تست پذیرش گره بزنید
در پروژه API چیزی برای «دیدن» مثل یک صفحه سایت نیست و همین باعث میشود کارفرما نداند کار کجاست. پرداخت را به «درصد پیشرفت» گره نزنید؛ هر قسط را به خروجی دیدنی و یک تست ساده که خودتان قبل از پرداخت انجام میدهید وصل کنید:
| مرحله | خروجی قابل دیدن | تست پذیرش قبل از پرداخت | سهم پیشنهادی از کل |
|---|---|---|---|
| شروع | قرارداد، فهرست بخشها، مخزن کد به نام شما | مخزن را باز میکنید و مالکش شمایید؛ فهرست با نیاز شما یکی است | حدود ۲۰ تا ۳۰ درصد |
| قرارداد API | پیشنویس مستند OpenAPI (مسیرها، ورود، خطاها) | سازنده اپ یا یک فرد فنی آن را میخواند و سؤال اساسی ندارد | حدود ۱۵ تا ۲۰ درصد |
| محیط آزمایشی | API روی سرور تست؛ اتصالها با داده آزمایشی | چند درخواست آماده را اجرا میکنید؛ یک پرداخت آزمایشی موفق و یک ناموفق؛ پیامک تست میرسد | حدود ۲۵ تا ۳۰ درصد |
| تحویل اصلی | انتشار، مستند نهایی، انتقال حسابها، گزارش تست | طبق فهرست خروجیها تیک میزنید؛ پشتیبان یک بار برگردانده میشود؛ کلیدها عوض شدهاند | حدود ۲۰ تا ۲۵ درصد |
اگر بخواهید، حدود ۵ درصد از قسط آخر را تا پایان دوره رفع اشکال نگه دارید. جزئیات بندها را در قرارداد برنامهنویسی و روش تحویل را در تحویل گرفتن پروژه نرمافزاری نوشتهایم. سند محدوده را هم قبل از استعلام در سند نیازمندی نرمافزار آماده کنید.
اشتباههای رایج در سفارش API
سفارش API بدون دانستن مصرفکننده: اگر معلوم نباشد چه کسی و با چه دستگاهی از API استفاده میکند، یا بیش از نیاز ساخته میشود یا کمتر.
یکی دانستن محیط آزمایشی و اصلی: تست روی داده واقعی مشتری و حساب واقعی درگاه، هم خطرناک است و هم دردسرساز.
تحویل گرفتن بدون مستندات: «بعداً مینویسم» معمولاً هیچوقت نوشته نمیشود. مستندات را جزو شرط پرداخت مرحله آخر بگذارید.
کلیدها به نام برنامهنویس: حساب درگاه، پنل پیامک، توکن سرویسها و دسترسی سرور باید به نام کسبوکار شما باشد. اگر با حساب شخصی سازنده ساخته شود، روز جدایی دردسر دارید.
نادیده گرفتن خطاها: اگر سرویس پیامک یک ساعت قطع شود، چه اتفاقی میافتد؟ پیامها دوباره ارسال میشوند یا گم میشوند؟ این سؤال را قبل از ساخت بپرسید.
خروجیهای قابل تحویل یک API خوب
وقتی پروژه API تحویل میگیرید، این فهرست را کنار قرارداد بگذارید:
- کد در مخزن به نام شما، با راهنمای نصب.
- مستندات کامل با OpenAPI: فهرست همه آدرسها، ورودیها، خروجیها و کدهای خطا.
- مجموعه درخواستهای آماده (مثلاً Postman) برای تست سریع.
- محیط آزمایشی جدا از محیط اصلی.
- روش ساختن و باطل کردن کلید دسترسی برای هر شریک یا اپ.
- قالب یکسان پیام خطا در همه بخشها.
- نسخهبندی (مثلاً v1) تا تغییرات بعدی اپهای قبلی را خراب نکند.
- فهرست حسابها و توکنهای سرویسهای بیرونی، همه به نام کسبوکار.
- گزارش تست و، برای API عمومی، گزارش بررسی امنیتی.
مستند OpenAPI خوب چه چیزهایی دارد؟
«مستندات کامل میدهیم» جملهای است که همه میگویند. فرق کار خوب و بد در جزئیات است. معمولاً مستند با Swagger یا Redoc ساخته میشود و یک صفحه وب است که میتوانید خودتان بازش کنید. این جدول میگوید چه چیزهایی باید در آن باشد و شما بدون دانش فنی چطور چکش کنید:
| بخش مستند | چه چیزی باید داشته باشد | شما چطور چک کنید |
|---|---|---|
| فهرست مسیرها | برای هر کار سیستم یک مسیر با توضیح کوتاه | تعداد و نامها با فهرست بخشهای قرارداد جور باشد |
| ورود و توکن | روش ورود، مدت اعتبار توکن، تمدید و خروج | بپرسید اگر کاربری را مسدود کنید، چقدر طول میکشد دسترسیاش قطع شود |
| نمونه درخواست و پاسخ | برای هر مسیر، با داده نمونه | دکمه امتحان در صفحه مستند کار کند و جواب برگردد |
| کدهای خطا | پیام روشن برای هر خطا؛ مثلاً «موجودی کافی نیست» | یک مسیر را با داده غلط امتحان کنید |
| صفحهبندی و فیلتر | فهرستهای بلند چطور صفحهبهصفحه میآیند | بپرسید اگر ده هزار سفارش داشته باشیم فهرست چطور برمیگردد |
| محدودیت درخواست | چند درخواست در دقیقه مجاز است و بعدش چه میشود | بهخصوص برای ورود و ارسال کد پیامکی |
| نسخهبندی | اگر تغییری اپ قدیمی را خراب کند، نسخه جدید ساخته میشود | بپرسید اپی که آپدیت نشده بعد از تغییر هم کار میکند؟ |
| محیط آزمایشی | آدرس جدا با داده نمونه | آدرس و یک حساب آزمایشی تحویل بگیرید |
یک قانون ساده: مستند هر بخش همراه همان بخش تحویل شود، نه «آخر کار». مستندی که یکجا در پایان نوشته میشود معمولاً ناقص است یا با نسخه روی سرور فرق دارد. جزئیات فنیتر را در راهنمای برنامهنویس بکاند هم آوردهایم.
یک مثال: پخشکننده با اپ نمایندگان
یک شرکت پخش مواد غذایی را در نظر بگیرید که سایت فروش عمده دارد و میخواهد نمایندگانش در شهرستانها از یک اپ ساده سفارش ثبت کنند و هر شب سفارشها به نرمافزار حسابداری برود. کار را میشود اینطور شکست:
- API محصول و قیمت: فهرست کالا، قیمت هر نماینده و موجودی تقریبی.
- API سفارش: ثبت، ویرایش تا قبل از تأیید، وضعیت سفارش.
- احراز هویت نمایندگان: ورود با شماره و کد پیامکی؛ هر نماینده فقط مشتریان و سفارشهای خودش را ببیند.
- اتصال یکطرفه به حسابداری: خروجی شبانه سفارشهای تأییدشده.
- مستندات و محیط تست برای سازنده اپ.
همگامسازی دوطرفه موجودی با حسابداری را میشود برای فاز دوم گذاشت. این تصمیم ساده، پروژه را از سطح «سازمانی» به سطح «متوسط» میآورد و نسخه اول زودتر به دست نمایندگان میرسد. اگر بخش سفارش عمده برایتان مهم است، استعلام قیمت و پیشفاکتور آنلاین B2B را هم بخوانید.
API آماده یا اختصاصی؟
همه اتصالها کدنویسی اختصاصی نمیخواهند. فروشگاهسازها و افزونههای آماده برای بعضی درگاهها و سرویسهای پیامک ماژول اتصال دارند. اگر سایت شما روی همین بسترهاست و نیازتان معمولی است، از ماژول آماده استفاده کنید. API اختصاصی وقتی لازم است که منطق کسبوکار خاص دارید، چند سیستم باید به هم وصل شوند یا سیستمهای شما خودشان اختصاصیاند. برای اتصال درگاه، راهنمای کامل را در اتصال درگاه پرداخت به سایت ببینید.
| وضعیت شما | پیشنهاد معقول |
|---|---|
| سایت وردپرسی، یک درگاه و پیامک معمولی | افزونه یا ماژول آماده سرویسدهنده |
| سایت آماده، ولی اتصال به حسابداری با کدهای کالای خاص | ماژول آماده اگر موجود است؛ وگرنه اتصال اختصاصی کوچک |
| اپ موبایل یا پنل اختصاصی | API اختصاصی بهعنوان بخشی از بکاند |
| نمایندگان یا شرکای بیرونی باید مستقیم وصل شوند | API اختصاصی با کلید جداگانه، سقف درخواست و مستندات عمومی |

هزینههای ماهانه و پنهان بعد از تحویل
API یک کار «تمامشده» نیست. بعد از تحویل هم روی سرور اجرا میشود، پیامک میفرستد و به نگهداری نیاز دارد. اینها را از روز اول در بودجه ببینید:
| قلم هزینه | بازه یا روش حساب | نکته |
|---|---|---|
| سرور مجازی داخل ایران | حدود ۰٫۸ تا ۱٫۹ میلیون تومان در ماه برای ۱ تا ۲ هسته و ۲ تا ۴ گیگ رم | برای شروع بیشتر اتصالهای کسبوکاری کافی است؛ حساب به نام شما |
| فضای پشتیبان جدا از سرور | چند صد هزار تومان در ماه، بسته به حجم | فایل پشتیبانی که روی همان سرور بماند، روز خرابی سرور به کار نمیآید |
| پیامک و OTP | به ازای هر پیامک، طبق تعرفه پنل | با رشد کاربر هزینه ماهانه بالا میرود؛ سهمیه و سقف را بپرسید |
| کارمزد درگاه پرداخت | درصد یا مبلغ ثابت هر تراکنش طبق قرارداد درگاه | قرارداد درگاه و حساب تسویه به نام شرکت شما باشد |
| سهمیه و محدودیت APIهای بیرونی | پلن رایگان یا پولی سرویس طرف مقابل | سقف درخواست روزانه/دقیقهای را از اول بدانید تا وسط کار غافلگیر نشوید |
| ثبت خطا و پایش قطعی | پلن رایگان یا نصب روی سرور خودتان | بدون هشدار، قطعی را اول مشتری میبیند |
| اصلاح بعد از تغییر نسخه سرویسها | ساعتی یا داخل قرارداد پشتیبانی | مستندات سرویسهای واسط معمولاً عوض میشود |
| نگهداری و بهروزرسانی امنیتی | قرارداد ماهانه یا ساعتی | چارچوب و کتابخانهها هم باید بهروز بمانند |
| تغییرات کوچک و بخشهای جدید | برآورد جدا یا بسته ساعتی | از رفع اشکال دوره گارانتی جدا ثبت شود |
یک روش ساده برای بودجهریزی این است که هزینه سال اول را دو بخش ببینید: هزینه ساخت و هزینه نگه داشتن. اگر پیشنهادی فقط بخش اول را دارد، بخش دوم را جداگانه بپرسید. در قرارداد پشتیبانی مشخص کنید چه کسی قطعی را پایش میکند، در چه مدت پاسخ میدهد و تغییرات ناشی از بهروزرسانی سرویسهای بیرونی چطور حساب میشود. جزئیات را در پشتیبانی و نگهداری ماهانه سایت و هزینه پیامک را در ورود با پیامک آوردهایم.
مثال فرضی هزینه سال اول یک اتصال متوسط
فرض کنید یک فروشگاه میخواهد سفارشها را یکطرفه به حسابداری بفرستد، پیامک وضعیت بدهد و درگاه داشته باشد. ساخت اتصال حدود ۸۰ میلیون تومان برآورد شده است. جدول زیر یک مثال فرضی است؛ عددها گرد شدهاند و قیمت پونوکد نیستند:
| قلم | برآورد سال اول (تومان) | توضیح |
|---|---|---|
| ساخت و تست اتصال | حدود ۸۰ میلیون | یکبار؛ شامل مستند و محیط آزمایشی |
| سرور و پشتیبان | ۱۲ × ۱٫۳ میلیون ≈ ۱۶ میلیون | حساب به نام شما |
| پیامک (فرض حدود ۳۰۰۰ پیامک/ماه) | بسته به تعرفه پنل؛ مثلاً چند میلیون تا بیش از ده میلیون | با رشد سفارش عوض میشود |
| کارمزد درگاه | درصد فروش؛ در بودجه جاری فروشگاه | جدا از دستمزد برنامهنویس |
| پشتیبانی سبک و اصلاح نسخهها | ۱۲ × ۳ تا ۶ میلیون ≈ ۳۶ تا ۷۲ میلیون | اگر قرارداد ماهانه نبندید، ساعتی حساب میشود |
| جمع تقریبی سال اول (بدون کارمزد درگاه) | حدود ۱۳۰ تا ۱۷۰ میلیون بهعلاوه هزینه پیامک | ساخت بهتنهایی تصویر کامل نیست |
اگر دو پیشنهاد فقط رقم ساخت را میگویند و یکی پشتیبانی و سرویسهای جاری را صفر فرض کرده، مقایسه ناعادلانه است. روش مقایسه را چند بند پایینتر آوردهایم.
دو پیشنهاد را چطور مقایسه کنیم؟
فرض کنید یک پیشنهاد نصف دیگری است. قبل از تصمیم، هر دو را با این سؤالها کنار هم بگذارید:
| سؤال | جواب قابل قبول | علامت هشدار |
|---|---|---|
| مستندات تحویل میدهید؟ | بله، OpenAPI و مجموعه درخواست آماده | «کد خودش گویاست» |
| محیط آزمایشی جدا دارید؟ | بله، با داده و حساب تست | تست مستقیم روی سایت اصلی |
| اگر سرویس مقابل قطع شود؟ | صف، تلاش دوباره و گزارش | «معمولاً قطع نمیشود» |
| کد و حسابها به نام کیست؟ | به نام کسبوکار شما | حساب شخصی برنامهنویس |
| برآورد چند نفر-ساعت است؟ | عدد مشخص به تفکیک بخشها | فقط یک مبلغ کلی |
| بعد از تحویل چه کسی پاسخ میدهد؟ | قرارداد پشتیبانی با زمان پاسخ مشخص | «هر وقت مشکلی بود زنگ بزنید» |
اگر هنوز بین فریلنسر و تیم مردد هستید، برنامهنویس بکاند پروژهای و برنامهنویس جنگو و پایتون معیارهای سنجش را با جزئیات توضیح دادهاند.
چه چیزهایی معمولاً در پیشنهاد اول نیست؟
قبل از امضا، این ردیفها را هم از پیشنهادکننده بپرسید. نبودنشان بعداً به هزینه اضافه تبدیل میشود:
| قلم | چرا جا میافتد | چه بخواهید |
|---|---|---|
| گرفتن دسترسی و هماهنگی با پشتیبانی سرویس طرف مقابل | زمانش دست برنامهنویس نیست | در زمانبندی جدا نوشته شود؛ اگر معطل شد، تقصیر کدنویسی نباشد |
| پاکسازی و یکسانسازی داده قدیمی | کد کالا و مشتری بین دو سیستم فرق دارد | نمونه داده واقعی غیرحساس قبل از برآورد نهایی |
| آموزش نفر داخلی برای خواندن لاگ و مغایرت | فرض میشود خودتان بلدید | یک جلسه کوتاه و راهنمای یکصفحهای |
| محیط آزمایشی پایدار بعد از تحویل | فقط موقع توسعه بالا میآید | آدرس تست تا پایان دوره رفع اشکال زنده بماند |
| تغییر نسخه API طرف مقابل در ماههای اول | پشتیبانی تعریف نشده | در قرارداد پشتیبانی یا با سقف ساعت مشخص شود |
انتقال کلیدها و حسابها روز تحویل
خیلی از دردسرهای بعد از قطع همکاری از اینجاست که یک حساب یا کلید به نام برنامهنویس مانده است. روز تحویل این جدول را کنار خودتان بگذارید:
| حساب یا دسترسی | به نام چه کسی باشد | چطور مطمئن شوید |
|---|---|---|
| مخزن کد | شرکت شما؛ برنامهنویس فقط عضو | در تنظیمات مخزن، مالک شمایید |
| سرور و دامنه | شما | با حساب خودتان وارد پنل ارائهدهنده میشوید |
| کلیدهای API سرویسهای بیرونی | ساختهشده در حساب شما | بعد از تحویل یک بار عوض (چرخش) میشوند |
| درگاه پرداخت | شرکت یا فروشگاه شما | قرارداد و حساب تسویه به نام شماست |
| پنل پیامک | شما | شارژ و گزارش ارسال را خودتان میبینید |
| مستند OpenAPI و مجموعه Postman | نسخه نهایی روی سرور شما | دکمه امتحان کار میکند و با فهرست قرارداد یکی است |
| حساب مدیر پنل / محیط آزمایشی | شما؛ حساب سازنده محدود یا بسته | فهرست مدیرها را خودتان میبینید |
| فضای پشتیبان | شما | فایل پشتیبان دیروز را پیدا و یک بار برمیگردانید |
بندهای مالکیت را از همان قرارداد بنویسید؛ نمونه را در مالکیت سورس کد آوردهایم.
عددهایی که تا روز نود بعد از انتشار چک میکنید
API خوب بعد از تحویل هم خودش را نشان میدهد. لازم نیست داشبورد پیچیده داشته باشید؛ همین چند شاخص برای ماه اول تا روز نود کافی است:
| شاخص | چطور اندازه بگیرید | جهت خوب |
|---|---|---|
| نرخ خطای مسیرهای اصلی | گزارش ثبت خطا یا لاگ سرور | روند نزولی؛ خطای تکراری رفع شده |
| زمان پاسخ مسیرهای پرترافیک | پایش ساده یا گزارش ماهانه | در حد توافق؛ بدون افت ناگهانی در ساعت اوج |
| مغایرت با حسابداری / انبار | مقایسه روزانه یا هفتگی چند ده رکورد | مغایرت صفر یا مسیر اصلاح روشن |
| پرداختهای ناقص یا تکراری | گزارش درگاه و سفارشها | صفر مورد بدون توضیح |
| سهمیه پیامک و سقف API بیرونی | پنل سرویسها | قبل از رسیدن به سقف هشدار میگیرید |
| قطع سرویس طرف مقابل | هشدار و صف درخواستهای معوق | بعد از برگشتن سرویس، کارها بدون دوبارهکاری جلو میروند |
| درخواست تغییر خارج از محدوده | فهرست کتبی | برآورد و پرداخت جدا؛ قاطی گارانتی نشده |
| آمادگی نفر دوم | یک نفر با مستند یک مسیر را امتحان میکند | بدون تماس با سازنده اول کار راه میافتد |
تعرفه رسمی ۱۴۰۵ برای API؛ یک مثال محاسبه
اگر پیمانکار گفت «قیمت را با تعرفه نظام صنفی حساب کردهایم»، بدانید منظورش «فهرست بهای خدمات فاوا ۱۴۰۵» است. در این سند نرخ پایه هر نفر-ساعت برای شرکتها ۵۷۶ هزار تومان است. این عدد در ضریب نقش، مدرک، سابقه و رتبه شرکت ضرب میشود. مثلاً برنامهنویس درجهیک با کارشناسی و ۶ تا ۱۰ سال سابقه، در شرکت بدون رتبه، ساعتی حدود ۱٫۴۹ میلیون تومان حساب میشود.
یک مثال فرضی: اتصال ساده سایت به سامانه پیامک که ۶۰ ساعت کار برنامهنویس درجهیک ببرد، با این تعرفه حدود ۸۹ میلیون تومان درمیآید (۶۰ × ۱٫۴۹). مالیات بر ارزش افزوده ۱۰٪ هم جدا اضافه میشود. این عدد از بازه رایج بازار برای اتصال ساده بیشتر است، چون تعرفه مبنای قراردادهای دولتی و داوری است، نه قیمت اجباری بازار.
زمان را هم جدی بگیرید. برای مثال، نیاسا در صفحه خدماتش زمان تقریبی «API و یکپارچهسازی» را ۶ تا ۲۰ هفته اعلام کرده است (بررسی ۹ آبان ۱۴۰۵). اگر پیشنهادی برای اتصال سازمانی دوطرفه زمان خیلی کوتاهتری میدهد، بپرسید تست و مدیریت خطا در آن زمان جا شده یا نه. توضیح کامل تعرفه را در تعرفه طراحی سایت نظام صنفی ۱۴۰۵ آوردهایم.
چکلیست قبل از گرفتن قیمت API
- کدام سیستمها باید به هم وصل شوند؟ اسم و نسخه هر کدام.
- جهت داده: یکطرفه یا دوطرفه؟ هر چند وقت یک بار؟
- چه کسانی از API استفاده میکنند: اپ خودتان، نمایندگان، شرکای بیرونی؟
- فهرست بخشها: محصول، سفارش، مشتری، فاکتور، و هر چیز دیگر.
- قوانین خاص: تخفیف، پورسانت، رزرو موجودی، مالیات.
- مستندات و دسترسی تست سرویسهای طرف مقابل را دارید؟
- حجم تقریبی درخواستها در روز و ساعت اوج.
- اگر یکی از سرویسها قطع شد، چه رفتاری انتظار دارید؟
- حسابها و توکنها به نام چه کسی ساخته میشوند؟
- بعد از تحویل، چه کسی API را پایش و نگهداری میکند؟
- مستند OpenAPI با نسخه روی سرور یکی است و دکمه امتحان در آن کار میکند.
- یک پرداخت آزمایشی موفق و یک ناموفق انجام دادهام و سفارش درست ثبت شده است.
- کلیدهای سرویسهای بیرونی بعد از تحویل عوض شده و دسترسی سازنده به سرور اصلی محدود شده است.
- ثبت خطا و هشدار فعال است و میدانم پیام قطعی به چه کسی میرسد.
- هزینه ماهانه سرور، پیامک و پشتیبانی را جدا از قیمت ساخت در بودجه نوشتهام.
سؤالهای رایج
چرا یک نفر برای همان API قیمت خیلی کمتری داده است؟
معمولاً به خاطر حذف مستندات، تست، مدیریت خطا یا امنیت. API بدون اینها کار میکند تا روزی که کار نکند. پیشنهادها را بر اساس فهرست خروجیها و جدول مقایسه بالا کنار هم بگذارید.
REST بهتر است یا GraphQL؟
برای بیشتر کسبوکارها REST سادهتر، رایجتر و کافی است. GraphQL وقتی ارزش دارد که چند نوع اپ با نیازهای داده متفاوت به یک سیستم وصل میشوند. این تصمیم فنی است و برنامهنویس باید دلیلش را به زبان ساده توضیح دهد.
ساخت API چقدر طول میکشد؟
اتصال ساده به یک سرویس چند روز تا چند هفته و یکپارچهسازی سازمانی چند ماه طول میکشد. بیشترین تأخیر معمولاً از دریافت دسترسی و مستندات سرویس طرف مقابل است، نه خود کدنویسی.
نرمافزار حسابداری ما API ندارد؛ باز هم میشود وصل شد؟
گاهی بله، از راه خروجی و ورودی فایل یا اتصال کنترلشده به پایگاه داده. این روشها حساسترند و باید با پشتیبانی آن نرمافزار هماهنگ شوند. قبل از قیمت دادن، برنامهنویس باید نسخه نرمافزار و روشهای رسمی اتصالش را بررسی کند.
بعداً میتوانیم API را به شرکای دیگر هم بدهیم؟
اگر از اول با کلید جداگانه برای هر مصرفکننده، محدودیت درخواست و نسخهبندی ساخته شده باشد، بله. اضافه کردن اینها بعداً هم ممکن است ولی گرانتر است.
امنیت API را چطور بسنجم؟
بپرسید ورود چطور انجام میشود، دسترسی هر نقش چطور محدود شده، ورودیها چطور بررسی میشوند و تعداد درخواستها محدود است یا نه. برای API که اطلاعات مالی یا شخصی دارد، بررسی امنیتی مستقل هم بخواهید.
اگر سازنده API در دسترس نباشد چه میشود؟
اگر مستندات کامل، کد و حسابها به نام شما تحویل شده باشد، برنامهنویس دیگری میتواند ادامه دهد. بدون مستندات، عملاً به یک نفر وابستهاید.
قیمت اتصال به API دیگران چقدر است؟
اگر منظورتان وصل شدن سایت یا پنل خودتان به سرویس بیرونی (درگاه، پیامک، حسابداری، بازارگاه) است، در بازار ۱۴۰۵ اتصال ساده معمولاً حدود ۳۰ تا ۷۰ میلیون تومان و کار سازمانی دوطرفه حدود ۲۰۰ تا ۵۰۰ میلیون تومان است. بعضی اتصالهای خیلی کوچک از حدود ۱۰ میلیون شروع میشوند. قیمت نهایی بعد از دیدن مستند و دسترسی آزمایشی طرف مقابل مشخص میشود؛ جدول نوعکار بالاتر را ببینید.
آیا OpenAPI لازم است؟
برای هر API که قرار است اپ، پنل، شریک یا برنامهنویس دیگری از آن استفاده کند، بله. OpenAPI همان قرارداد کتبی بین سازنده و مصرفکننده است: مسیرها، ورودیها، خطاها و نمونه درخواست. بدون آن، نفر بعدی هفتهها وقت تلف میکند یا به سازنده اول وابسته میمانید. برای یک اسکریپت داخلی یکبارمصرف گاهی سادهتر هم کافی است، ولی همان را هم بهتر است مکتوب کنید.
اتصال سایت به API قیمت ارز یا طلا هم همین هزینه را دارد؟
معمولاً کار سادهتری است، چون داده فقط یکطرفه خوانده میشود. ولی کش روی سرور، سرویس پشتیبان و نمایش زمان بهروزرسانی را نباید حذف کرد. جزئیاتش را در API قیمت ارز برای سایت نوشتهایم.
هزینه پشتیبانی API بعد از تحویل چقدر است؟
در فهرست بهای خدمات فاوا ۱۴۰۵، پشتیبانی سالانه نرمافزار ۲۵ تا ۳۵ درصد هزینه تولید در نظر گرفته شده است. در بازار مدلها فرق دارد؛ ماهانه ثابت یا ساعتی با سقف. هر مدلی که باشد، زمان پاسخ و کارهای داخل قرارداد را مکتوب کنید.
مطالب مرتبط
- یکپارچه سازی API؛ اتصال به حسابداری، پیامک و درگاه
- هزینه ساخت پنل مدیریت ۱۴۰۵
- برنامهنویس بکاند پروژهای
- برنامهنویس جنگو و پایتون
- اتوماسیون فرایند کسبوکار
- ساخت ربات تلگرام برای کسبوکار
- قرارداد برنامهنویسی
- سند نیازمندی نرمافزار
- استخدام برنامهنویس پروژهای
- پشتیبانی و نگهداری ماهانه سایت
- API قیمت ارز برای سایت ۱۴۰۵
- اتصال سایت به ایمالز ۱۴۰۵
- حسابداری فروشگاه اینترنتی ۱۴۰۵
- تعرفه طراحی سایت نظام صنفی ۱۴۰۵
برآورد API پروژه شما
پونوکد API را با Django REST Framework، مستندات OpenAPI و احراز هویت امن میسازد. جزئیات این خدمت را در صفحه طراحی و توسعه API و بقیه خدمات را در صفحه خدمات ببینید. اگر API بخشی از یک سایت جدید است، طراحی سایت و عوامل قیمت در صفحه قیمت را هم بخوانید. اگر پنل مدیریت هم لازم دارید، هزینه ساخت پنل مدیریت ۱۴۰۵ کمک میکند بودجه را کامل ببینید. برای انتخاب فریلنسر یا تیم هم مشاوره فنی نرمافزار را ببینید.
اگر چند پیشنهاد گرفتهاید و نمیدانید کدام واقعبینانه است، همانها را بفرستید تا در یک جلسه کوتاه آنلاین بگوییم چه چیزهایی در هر کدام جا افتاده است.
برای بررسی رایگان محدوده کار، فهرست سیستمهایی را که باید به هم وصل شوند آماده کنید و با ۰۹۹۱۵۶۱۵۹۴۶ تماس بگیرید، در تلگرام پیام بدهید (t.me/resonea) یا فرم تماس را پر کنید.



