API: привязка и отвязка номера к SIM-карте

📌 PATCH (привязка / отвязка номера к SIM-карте)

🔹 Метод

PATCH /api/protected/phone/sim-cards/{iccid}

🎯 Назначение

Обновление SIM-карты по iccid. Используется для:

• 📞 привязки номера телефона (DID) к SIM-карте;
• ❌ отвязки номера от SIM-карты.

📝 Параметры

Параметр	Тип	Где передается	Описание
iccid	string	path	Уникальный идентификатор SIM-карты

📦 Тело запроса

{
  "did": "string"
}

Поле	Тип	Описание
did	string / null	Номер телефона (DID)

---

🚀 Рекомендуемый сценарий

1. Получить iccid нужной SIM-карты.

2. Выбрать доступный номер (DID).

3. Выполнить запрос PATCH:

   • ➕ указать номер в поле did — для привязки;
   • ➖ передать null — для отвязки.

4. Проверить результат через GET /sim-cards.

---

📞 Привязка номера к SIM-карте

Запрос

PATCH /api/protected/phone/sim-cards/8991101200003204512

{
  "did": "+48123456789"
}

✅ Результат

Номер будет привязан к указанной SIM-карте.

💡 Рекомендации

№	Рекомендация
1	Перед привязкой убедитесь, что номер не используется другой SIM-картой
2	Проверяйте корректность значения iccid
3	При получении ошибки 409 Conflict сначала отвяжите номер от текущей SIM-карты
4	Используйте формат запроса application/json

---

❌ Отвязка номера от SIM-карты

Запрос

PATCH /api/protected/phone/sim-cards/8991101200003204512

{
  "did": null
}

✅ Результат

Номер будет отвязан от SIM-карты.

⚠️ Важно

№	Ограничение
1	К одной SIM-карте может быть привязан только один номер (did)
2	Для привязки номер должен быть свободен и не связан с другой SIM-картой
3	Для отвязки необходимо передавать именно null, а не пустую строку
4	Обязательно указывайте корректный iccid
5	Формат запроса должен быть application/json

PATCH (привязка / отвязка номера к SIM-карте):

1. Метод: PATCH /api/protected/phone/sim-cards/{iccid}

2. Назначение: Обновление SIM-карты по iccid — используется для привязки или отвязки номера телефона (DID).

3. Параметры: iccid (string, path) — уникальный идентификатор SIM-карты

4. Тело запроса

   {
     "did": "string"
   }
   

   • did — номер телефона

Рекомендуемый сценарий

1. Получить iccid SIM-карты
2. Выбрать доступный номер (DID)
3. Выполнить PATCH:
   • с номером → привязка
   • с null → отвязка
4. Проверить результат через GET /sim-cards

Примеры:

• Привязка номера — PATCH /api/protected/phone/sim-cards/8991101200003204512

  {
    "did": "+48123456789"
  }
  

  Результат — номер будет привязан к SIM-карте.

  №	✅ Примечание:
  1	Перед привязкой проверяйте, что номер свободен
  2	Используйте null для отвязки (не пустую строку)
  3	Всегда проверяйте корректность iccid
  4	При ошибке 409 — сначала отвяжите номер от другой SIM

• Отвязка номера — PATCH /api/protected/phone/sim-cards/8991101200003204512

  {
    "did": null
  }
  

  Результат — номер будет отвязан от SIM-карты.

  №	⚠️Важно!
  1	У одной SIM-карты может быть только один номер (did)
  2	Номер должен быть свободен (не привязан к другой SIM)
  3	Обязательно указывать корректный iccid
  4	Формат запроса — application/json

---

🆘 Поддержка и помощь
❓ Заявки в техническую поддержку | 📚 База знаний MCN Telecom | ☎️ +7 (495) 105-99-99 | 📧 info@mcn.ru

Была ли эта статья полезной

Да, полезнаНет, не полезна