Updated on 2023-09-27 GMT+08:00

Deleting Data by Customer Number (cleancustpersonaldata)

Scenario

Delete data by customer number.

Method

POST

URI

https://Domain name/apiaccess/CC-Management/v1/clearUserInfo/cleancustpersonaldata. For example, the domain name is service.besclouds.com.

Request Description

Table 1 Request header parameters

No.

Name

Type

Mandatory or Not

Description

1

X-APP-Key

String

No

App key, which is the user ID.

2

Authorization

String

Yes

Authentication field. The format is Bearer {Value of AccessToken returned by the tokenByAkSk interface}. (A space is required after Bearer.)

3

Content-Type

String

No

Content type. Set this parameter to application/json.

Table 2 Request body parameters

No.

Name

Type

Mandatory or Not

Description

1.1

customNos

Array

Yes

List of customer numbers (a maximum of 1000 numbers, which can be calling numbers or called numbers).

Response Description

  • Status code: 200
Table 3 Response body parameters

No.

Name

Type

Mandatory or Not

Description

1.1

retMsg

String

Yes

Failure cause.

1.2

retCode

String

Yes

Return code. The value 0 indicates success. Other values indicate failure.

  • Status code: 400

    Incorrect request. Check the request path and parameters.

  • Status code: 401

    Unauthorized operation.

    1. Check whether you have purchased related services.

    2. Contact customer service to check the status of your account.

  • Status code: 404

    The requested content is not found. Check the request path.

  • Status code: 500

    Business failure. Check the values of parameters in the request.

Error Codes

None

Example

  • Request header:
    Content-Type: application/json  
    X-APP-Key: ************************************  
    Authorization: Bearer ********************************

    Request parameters:

    {
    	"customNos": ["135****1111", "wen11", "kehu@*****.com"]
    }

    Response parameters:

    {
    	"retCode": "0",
    	"retMsg": "VerifyParams success"
    }