پرش به مطلب اصلی

بروزرسانی شماره دفترچه تلفن

این API به شما امکان بروزرسانی یک مخاطب موجود در دفترچه تلفن با استفاده از شناسه آن را می‌دهد. می‌توانید نام، شماره، ایمیل و گزینه‌های اضافی مخاطب را تغییر دهید.

📍 نقطه پایانی

PUT {base_url}/api/phonebooks/numbers/update-new/{contact_id}

🧾 هدرها

کلیدمقدار
AuthorizationYOUR_TOKEN_HERE
Content-Typeapplication/json

📤 بدنه درخواست

{
"pre": "Mr.",
"name": "name",
"number": "+989121236547",
"options": {
"124": "2025-05-20"
},
"phonebook_id": "12345"
}

📝 پارامترها

پارامترنوعالزامیتوضیحات
numberstringبلهشماره تلفن در فرمت E.164.
prestringخیرپیشوند نام (مثل آقای، خانم).
namestringخیرنام مخاطب.
emailstringخیرآدرس ایمیل مخاطب.
optionsobjectخیرگزینه‌های اضافی به عنوان جفت کلید-مقدار.
phonebook_idstringبلهشناسه دفترچه تلفنی که مخاطب به آن تعلق دارد.

✅ پاسخ موفق

{
"data": null,
"meta": {
"status": true,
"message": "انجام شد",
"message_parameters": [],
"message_code": "200-1"
}
}

❌ پاسخ خطا — توکن نامعتبر یا منقضی (401)

{
"data": null,
"meta": {
"status": false,
"message": "اطلاعات وارد شده صحیح نمی باشد",
"message_parameters": [],
"message_code": "400-1",
"errors": {}
}
}

🧪 مثال درخواست

curl --location --globoff --request PUT '{base_url}/api/phonebooks/numbers/update-new/234235' \
--header 'Authorization: Your Apikey/Token' \
--header 'Content-Type: application/json' \
--data '{
"pre": "Mr.",
"name": "name",
"number": "+989121236547",
"options": {
"124": "2025-05-20"
},
"phonebook_id": "12345"
}'