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

معرفی وب سرویس

REST API ایده‌گستران امکان تبادل امن و ساخت‌یافته اطلاعات میان نرم‌افزار ایده‌پلاس و سامانه‌های بیرونی را فراهم می‌کند. این وب سرویس مبتنی بر استاندارد REST بوده و از JSON برای تبادل داده استفاده می‌کند.

کاربردهای اصلی وب سرویس

• دریافت اطلاعات کالا، موجودی و قیمت‌ها
• ارسال و ثبت فاکتور فروش و مرجوعی
• گزارش‌گیری از اسناد مالی و چک‌ها
• یکپارچه‌سازی نرم‌افزارهای فروشگاهی، حسابداری و ERP
• اتصال مستقیم نرم‌افزار ایده‌پلاس به سامانه‌های جانبی

ویژگی‌های فنی

• مبتنی بر معماری REST
• تبادل داده با فرمت JSON
• احراز هویت امن با Bearer Token
• پشتیبانی از صفحه‌بندی (Pagination)
• قابل استفاده در تمامی زبان‌ها و پلتفرم‌ها

مراحل دریافت دسترسی

1. ثبت درخواست اتصال از طریق واحد پشتیبانی ایده‌گستران
2. دریافت ClientId و ClientSecret اختصاصی
3. دریافت توکن امنیتی از سرویس Auth
4. ارسال Bearer Token در Header تمامی درخواست‌ها

Swagger-like API

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

Base Information

• Base URL: {BASE_URL}
• Content-Type: application/json
• Authentication: Bearer Token
• Current Version: v1.1

Headers مشترک

Authorization: Bearer {accessToken}
Content-Type: application/json

Authentication

GET /Items

POST /Factors/Insert

Validation Rule: Sum(RowSum) == TotalPrice

Error Codes

Changelog & Versioning

نسخه‌های قدیمی تا ۶ ماه پشتیبانی می‌شوند. برای تغییرات ناسازگار (Breaking Changes) اطلاع‌رسانی قبلی انجام خواهد شد.

نمونه درخواست و پاسخ

دریافت توکن

POST /Auth/Token
Content-Type: application/json

{
  "clientId": "YOUR_CLIENT_ID",
  "clientSecret": "YOUR_CLIENT_SECRET"
}

نمونه پاسخ

{
  "accessToken": "eyJhbGciOiJIUzI1NiIsInR5cCI6..."
}

دانلود مستندات

مستندات کامل وب سرویس شامل توضیح متدها، پارامترها و نمونه‌ها به همراه Postman Collection از طریق لینک‌های زیر قابل دریافت است.