دریافت مخاطب

حرفه‌ایکلید خواندن

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

GET…/public/contacts/{id}

یک مخاطب را با شناسه‌اش برمی‌گرداند.

درخواست
curl https://app.reshta.ir/api/v1/public/contacts/0192c4e8-7b1a-7c3e-9f20-5d6a1b2c3d4e \​  -H "Authorization: Bearer $RESHTA_API_KEY"​

سرآیندها

AuthorizationstringالزامیBearer و کلید API کسب‌وکار (rk_live_…).

پارامترهای مسیر

idstringالزامیشناسهٔ رکورد (UUID).

پاسخ‌ها و خطاها

200—موفق.
401unauthorizedکلید نیست، نادرست یا باطل است، یا سازنده‌اش دیگر فعال نیست.
404not_foundرکورد در این کسب‌وکار پیدا نشد.
429rate_limitedبیش از ۱۲۰ درخواست در دقیقه؛ Retry-After می‌گوید چند ثانیه صبر کنید.
پاسخ
{​  "id": "0192c4e8-7b1a-7c3e-9f20-5d6a1b2c3d4e",​  "first_name": "سارا",​  "last_name": "رضایی",​  "company_id": null,​  "company_name": null,​  "job_title": null,​  "national_id": null,​  "owner_id": "0192a7f0-3b4c-7d5e-8f60-718293a4b5c6",​  "lifecycle_stage": "lead",​  "birthday": null,​  "unsubscribed_email": false,​  "unsubscribed_sms": false,​  "is_sample": false,​  "source": null,​  "marketing_block_reason": null,​  "address": null,​  "custom": {},​  "emails": [],​  "phones": [​    { "id": "0192c4e8-7b1b-7a10-8c21-3d4e5f607182", "phone": "09121234567", "label": null, "is_primary": true }​  ],​  "created_at": "2026-10-26T14:05:12.000Z",​  "updated_at": "2026-10-26T14:05:12.000Z"​}​

کلید API بسازید و اولین درخواست را بفرستید

کلید در اپ رشتا ساخته می‌شود و فقط یک بار نشان داده می‌شود. API و وب‌هوک (بتا) در پلن حرفه‌ای و سازمانی است و کلید را فقط مدیر کسب‌وکار می‌سازد.

  1. ۱ورود به app.reshta.ir
  2. ۲اتصال ← توسعه‌دهنده
  3. ۳ساخت کلید API