Phone Numbers - Purchase Phone Numbers

Servizio:: Communication

Versione API:: 2025-06-01

Acquista numeri di telefono.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
endpoint	path	True	string (url)	Risorsa di comunicazione, ad esempio https://resourcename.communication.azure.com
api-version	query	True	string	Versione dell'API da richiamare

Corpo della richiesta

Nome	Tipo	Descrizione
agreeToNotResell	boolean	Contratto per non rivendere i numeri di telefono. Il valore predefinito è false se non specificato.
searchId	string	ID di ricerca.

Risposte

Nome	Tipo	Descrizione
202 Accepted		Il servizio ha accettato la richiesta e inizierà l'elaborazione in un secondo momento. Restituirà immediatamente 'Accepted' e includerà un'intestazione 'Operation-Location'. Il lato client deve eseguire ulteriori query sullo stato dell'operazione usando l'URL specificato nell'intestazione 'Operation-Location'. Intestazioni Operation-Location: string operation-id: string purchase-id: string
Other Status Codes	CommunicationErrorResponse	Fallimento

Nome

Tipo

Descrizione

202 Accepted

Il servizio ha accettato la richiesta e inizierà l'elaborazione in un secondo momento. Restituirà immediatamente 'Accepted' e includerà un'intestazione 'Operation-Location'. Il lato client deve eseguire ulteriori query sullo stato dell'operazione usando l'URL specificato nell'intestazione 'Operation-Location'.

Intestazioni

Operation-Location: string
operation-id: string
purchase-id: string

Other Status Codes

CommunicationErrorResponse

Fallimento

Esempio

Purchase phone numbers

Esempio di richiesta

HTTP

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

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

Risposta di esempio

Codice di stato:: 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

Definizioni

Nome	Descrizione
CommunicationError	Errore di Servizi di comunicazione.
CommunicationErrorResponse	Errore di Servizi di comunicazione.
PhoneNumberPurchaseRequest	Richiesta di acquisto per la ricerca del numero di telefono.

CommunicationError

Object

Errore di Servizi di comunicazione.

Nome	Tipo	Descrizione
code	string	Codice di errore.
details	CommunicationError[]	Altri dettagli sugli errori specifici che hanno causato questo errore.
innererror	CommunicationError	Errore interno, se presente.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

CommunicationErrorResponse

Object

Errore di Servizi di comunicazione.

Nome	Tipo	Descrizione
error	CommunicationError	Errore di Servizi di comunicazione.

PhoneNumberPurchaseRequest

Object

Richiesta di acquisto per la ricerca del numero di telefono.

Nome	Tipo	Descrizione
agreeToNotResell	boolean	Contratto per non rivendere i numeri di telefono. Il valore predefinito è false se non specificato.
searchId	string	ID di ricerca.