مخاطبین را از سیستم خودتان به رستاک وصل کنید

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

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

وب‌سرویس مخاطبین چه مشکلی را حل می‌کند

ورود دستی مخاطب برای تیم کوچک کافی است؛ وقتی فرم سایت یا سیستم دیگر منبع شماره است، باید همان داده با API در رستاک بنشیند تا پیگیری دو جا نماند.

مسیر /api/v1/contacts عملیات کامل REST دارد: لیست با جستجو و صفحه، ساخت، خواندن یک رکورد، به‌روزرسانی و حذف. احراز هویت با هدر Authorization و توکن rstk_ است. در پلن پایه وب‌سرویس قفل است.

برای چه کسی است

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

نمونه کاربرد

  • ثبت مخاطب از فرم تماس سایت
  • همگام‌سازی دفترچه با سیستم دیگر
  • خواندن موبایل برای ارسال از کانال خودتان

چرا این ابزار

  • CRUD کامل روی همان مدل مخاطب پنل
  • جستجو و صفحه‌بندی در لیست
  • نمونه JSON و curl در همین صفحه
  • لاگ درخواست در بخش توسعه‌دهندگان پنل

چطور از وب‌سرویس مخاطبین استفاده کنید

1

پلن و کلید

پلن حرفه‌ای یا سازمانی و کلید API از منوی توسعه‌دهندگان.

2

POST مخاطب

نام و موبایل را با Bearer به /api/v1/contacts بفرستید.

3

لیست و به‌روزرسانی

با GET فیلتر کنید و با PUT همان id را عوض کنید.

محدودیت صادقانه

برای اینکه با ابزار دیگری اشتباه گرفته نشود.

سقف مخاطب پلن اعمال می‌شود. توکن به فضای کاری مالک است نه هر کاربر مهمان. حذف برگشت‌ناپذیر است.

آدرس و احراز هویت

پایه REST: https://rastakcrm.ir/api/v1 — هدر Authorization: Bearer rstk_…

  • متدها: GET، POST، PUT، DELETE
  • لیست/اصل: https://rastakcrm.ir/api/v1/contacts
  • یک رکورد: https://rastakcrm.ir/api/v1/contacts/{id}
  • پلن حرفه‌ای یا سازمانی؛ کلید از بخش توسعه‌دهندگان پنل

نمونه بدنه ساخت (JSON)

{
    "first_name": "سارا",
    "last_name": "محمدی",
    "mobile": "09120000000",
    "email": "sara@example.com",
    "status": "active",
    "source": "website"
}

نمونه curl

list

curl -X GET \
  "https://rastakcrm.ir/api/v1/contacts" \
  -H "Authorization: Bearer rstk_YOUR_TOKEN" \
  -H "Accept: application/json"

create

curl -X POST \
  "https://rastakcrm.ir/api/v1/contacts" \
  -H "Authorization: Bearer rstk_YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "سارا",
    "last_name": "محمدی",
    "mobile": "09120000000",
    "email": "sara@example.com",
    "status": "active",
    "source": "website"
}'

get

curl -X GET \
  "https://rastakcrm.ir/api/v1/contacts/12" \
  -H "Authorization: Bearer rstk_YOUR_TOKEN" \
  -H "Accept: application/json"

update

curl -X PUT \
  "https://rastakcrm.ir/api/v1/contacts/12" \
  -H "Authorization: Bearer rstk_YOUR_TOKEN" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "first_name": "سارا",
    "last_name": "محمدی",
    "mobile": "09120000000",
    "email": "sara@example.com",
    "status": "active",
    "source": "website"
}'

delete

curl -X DELETE \
  "https://rastakcrm.ir/api/v1/contacts/12" \
  -H "Authorization: Bearer rstk_YOUR_TOKEN" \
  -H "Accept: application/json"

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

https://دامنه-شما/api/v1/contacts برای لیست و ساخت؛ /api/v1/contacts/{id} برای یک رکورد.

حداقل هویت فرد مثل نام و موبایل طبق نمونه JSON همین صفحه؛ status و source اختیاری‌اند.

اکسل دستی و دسته‌ای است؛ API برای اتصال زنده نرم‌افزار دیگر است.

محدودیت throttle روی مسیر API اعمال می‌شود؛ برای همگام‌سازی انبوه صفحه و تأخیر بگذارید.

وب‌سرویس در پلن حرفه‌ای و سازمانی است.

کلید را از پنل توسعه‌دهندگان بگیرید

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

ایجاد حساب