Use NumberManagementReport to manage numbers online-Phone Number Protection(PNP)-阿里云帮助中心

You can subscribe to number management information (NumberManagementReport) via HTTP batch push to manage your numbers online.

Protocol specifications

Parameter	Description
Protocol	HTTP + JSON
Encoding	UTF-8

Request description

The request body is a JSON array. A single request can contain multiple records.

Request sample

[{
              "secret_no":"1575129****",
              "city":"Hangzhou",
              "partner_key":"FC10000011080****",
              "operating_time":"2019-01-01 00:00:00",
              "status":1   
}]

Field descriptions

Parameter name	Type	Example	Description
secretNo	String	1381111****	The privacy number.
city	String	Hangzhou	The city where the privacy number is registered.
partnerKey	String	FC1390000****	The number pool key.
operatingTime	String	2019-01-01 00:00:00	The time of the operation.
status	Number	1	The management status of the number. Valid values: 1: Create. 2: Delete.
vendor	long	1	The carrier. Valid values: 1: China Mobile. 2: China Unicom. 3: China Telecom.

Response specifications

Response example:

{
  "code" : 0,
  "msg" : "Accepted successfully"
}

Field descriptions:

Name	Type	Required	Example	Description
code	Number	Yes	0	The acknowledgement code.
msg	String	No	Accepted successfully	The description.

Note

The system only checks whether the `code` in the return value is a number and does not validate the content. A request is considered successful if the HTTP status code is 200. If the HTTP status code is not 200 or a timeout occurs, the system retries the push.
If a system exception or consumption failure occurs, return an HTTP 5xx status code.

Retry push

If a push fails, the system retries three times at intervals of 1 minute, 5 minutes, and 10 minutes. If the push is still unsuccessful after these attempts, no further retries are attempted.