Поделиться через

Phone Numbers - Purchase Phone Numbers

Служба:
Communication
Версия API:
2025-06-01

Приобретает номера телефонов.

POST {endpoint}/availablePhoneNumbers/:purchase?api-version=2025-06-01

Параметры URI

Имя В Обязательно Тип Описание
endpoint
 path True

string (url)

Ресурс связи, например https://resourcename.communication.azure.com
api-version
 query True

string

Версия API для вызова

Текст запроса

Имя Тип Описание
agreeToNotResell

boolean

Соглашение не перепродать номера телефонов. По умолчанию значение false, если оно не указано.
searchId

string

Идентификатор поиска.

Ответы

Имя Тип Описание
202 Accepted

Служба приняла запрос и начнет обработку позже. Он возвращает "Принято" немедленно и включает заголовок Operation-Location. Клиентская сторона должна дополнительно запрашивать состояние операции с помощью URL-адреса, указанного в заголовке Operation-Location.

Заголовки

  • Operation-Location: string
  • operation-id: string
  • purchase-id: string
Other Status Codes

CommunicationErrorResponse

Неудача

Примеры

Purchase phone numbers

Образец запроса

POST https://resourcename.communication.azure.com//availablePhoneNumbers/:purchase?api-version=2025-06-01

{
  "searchId": "378ddf60-81be-452a-ba4f-613198ea6c28"
}

Пример ответа

Код состояния:
202 
Operation-Location: /phoneNumbers/operations/purchase_378ddf60-81be-452a-ba4f-613198ea6c28
operation-id: purchase_378ddf60-81be-452a-ba4f-613198ea6c28
purchase-id: 378ddf60-81be-452a-ba4f-613198ea6c28

Определения

Имя Описание
CommunicationError

Ошибка служб коммуникации.
CommunicationErrorResponse

Ошибка служб коммуникации.
PhoneNumberPurchaseRequest

Запрос на покупку номера телефона.

CommunicationError

Object

Ошибка служб коммуникации.

Имя Тип Описание
code

string

Код ошибки.
details

CommunicationError[]

Дополнительные сведения об определенных ошибках, которые привели к этой ошибке.
innererror

CommunicationError

Внутренняя ошибка, если она есть.
message

string

Сообщение об ошибке.
target

string

Целевой объект ошибки.

CommunicationErrorResponse

Object

Ошибка служб коммуникации.

Имя Тип Описание
error

CommunicationError

Ошибка служб коммуникации.

PhoneNumberPurchaseRequest

Object

Запрос на покупку номера телефона.

Имя Тип Описание
agreeToNotResell

boolean

Соглашение не перепродать номера телефонов. По умолчанию значение false, если оно не указано.
searchId

string

Идентификатор поиска.