گروه‌ها و مخاطبین

ساخت گروه، افزودن مخاطب و ارسال بر اساس گروه.

POST /api/v1/contacts

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

POST /api/v1/contact-groups — ساخت گروه
POST /api/v1/contacts — افزودن مخاطب به گروه
GET /api/v1/contact-groups/{id}/contacts — فهرست مخاطبین گروه
DELETE /api/v1/contacts/{id} — حذف مخاطب

پارامترها

نام	نوع	الزامی	توضیح
`group_id`	integer	بله	شناسهٔ گروهی که مخاطب به آن اضافه می‌شود. مثال: 12
`name`	string	خیر	نام مخاطب. مثال: مریم رضایی
`mobile`	string	بله	شمارهٔ موبایل مخاطب. مثال: 09123456789

نمونه کد

cURL

curl -X POST https://api.irnoti.com/v1/contacts \
  -H "Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{ "group_id": 12, "name": "مریم رضایی", "mobile": "09123456789" }'

PHP

<?php

$payload = ['group_id' => 12, 'name' => 'مریم رضایی', 'mobile' => '09123456789'];

$ch = curl_init('https://api.irnoti.com/v1/contacts');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE),
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer sk_live_xxxxxxxxxxxxxxxx',
        'Content-Type: application/json',
    ],
]);

print_r(json_decode(curl_exec($ch), true));
curl_close($ch);