Phone Numbers - Purchase Phone Numbers

Serviço:

Communication

Versão da API:

2025-02-11

Compra números de telefone.

POST {endpoint}/availablePhoneNumbers/:purchase?api-version=2025-02-11

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
endpoint	path	True	string url	O recurso de comunicação, por exemplo, https://resourcename.communication.azure.com
api-version	query	True	string	Versão da API a ser invocada

Corpo da solicitação

Nome	Tipo	Description
searchId	string	A ID da pesquisa.

Respostas

Nome	Tipo	Description
202 Accepted		O serviço aceitou a solicitação e iniciará o processamento posteriormente. Ele retornará "Aceito" imediatamente e incluirá um cabeçalho "Operation-Location". O lado do cliente deve consultar ainda mais o status da operação usando a URL especificada no cabeçalho 'Operation-Location'. Cabeçalhos Operation-Location: string operation-id: string purchase-id: string
Other Status Codes	CommunicationErrorResponse	Fracasso

Exemplos

Purchase phone numbers

Solicitação de exemplo

HTTP

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

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

Resposta de exemplo

Código de status:

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

Definições

Nome	Description
CommunicationError	O erro dos Serviços de Comunicação.
CommunicationErrorResponse	O erro dos Serviços de Comunicação.
PhoneNumberPurchaseRequest	A solicitação de compra de pesquisa de número de telefone.

CommunicationError

Object

O erro dos Serviços de Comunicação.

Nome	Tipo	Description
code	string	O código de erro.
details	CommunicationError[]	Mais detalhes sobre erros específicos que levaram a esse erro.
innererror	CommunicationError	O erro interno, se houver.
message	string	A mensagem de erro.
target	string	O destino do erro.

CommunicationErrorResponse

Object

O erro dos Serviços de Comunicação.

Nome	Tipo	Description
error	CommunicationError	O erro dos Serviços de Comunicação.

PhoneNumberPurchaseRequest

Object

A solicitação de compra de pesquisa de número de telefone.

Nome	Tipo	Description
searchId	string	A ID da pesquisa.