Quick start

更新时间:
复制 MD 格式

Cell Phone Number Service is a phone number intelligence platform from Alibaba Cloud that provides capabilities such as number attribution query, phone number status query, and recycled phone number query. This document introduces the service's key concepts, billing methods, and workflow to help you get started. It also answers frequently asked questions (FAQ).

Key concepts

  • Capability

    Description

    number attribution query

    Queries attribution information for a phone number, including its province, city, base carrier, number portability status, and number segment.

    phone number status query

    Queries the real-time status of a phone number through carrier signaling. Statuses include active, powered-off, suspended, inactive, and busy.

    Note

    The phone number status query feature supports numbers from China Telecom, China Unicom, and China Mobile, but not from China Broadcasting Network.

    recycled phone number query

    Determines if a user's phone number is a recycled number reassigned by the carrier.

    time-on-network query

    Checks how long a phone number has been in service with its current carrier.

    carrier two-factor verification

    Verifies that a user's name and phone number match.

    carrier three-factor verification

    Verifies that a user's name, phone number, and ID card number match.

    UAID query

    Retrieves a user's phone number and International Mobile Equipment Identity (IMEI) without user interaction. The retrieved numbers are encrypted and cannot be decrypted, making them suitable for ad attribution analysis and enterprise risk control.

    ID card two-factor verification

    Verifies the consistency and authenticity of a user's name and ID card number.

    ID card three-factor verification

    Verifies that a user's name, ID card number, and portrait photo match official records.

    enterprise two-factor verification

    Verifies that an enterprise's name and organization code match, and returns its operational status.

    Supported entities include enterprises, public institutions, civil organizations, and individual organizations.

    enterprise three-factor verification

    Verifies that an enterprise's name, organization code, and legal representative's name match, and returns its operational status.

    Supported entities include all standard enterprises that can be queried in the National Enterprise Credit Information Publicity System.

    number encryption

    Encrypts the real phone numbers of your business and your customers into virtual numbers. By integrating with Alibaba Cloud's communication services, you can use these virtual numbers for voice calls and SMS messages to protect your data assets.

  • Cell Phone Number Service supports both pay-as-you-go and resource plan billing models. Charges are deducted from a resource plan first, if available. For detailed billing rules, see billing details.

  • For pay-as-you-go pricing and to purchase a resource plan, see Cell Phone Number Service Pricing.

Workflow

image

Prerequisites

  1. Register an account and complete enterprise real-name verification.

    • If you do not have an Alibaba Cloud account, register one and complete enterprise real-name verification.

    • If your Alibaba Cloud account has completed enterprise real-name verification, proceed to the next step.

  2. Activate Cell Phone Number Service.

  3. If you plan to use the service through APIs, you must also create an AccessKey.

    An Alibaba Cloud AccessKey is a security credential used to call APIs and access cloud resources. You can use an AccessKey belonging to your Alibaba Cloud account or a RAM user.

Step 1: Apply for capabilities

In the Cell Phone Number Service console, capabilities are listed as items in the Tag Marketplace. You must apply for and receive approval for each capability before you can use it.

  1. Log on to the Cell Phone Number Service console.

  2. In the left-side navigation pane, choose Tag Marketplace. Find the capability you want to use by browsing or searching, and then click Apply for Access.

  3. Complete the application form as prompted. The required materials and approval process may vary for different capabilities. For more information, see Application Material Requirements.

  4. Click Submit Application. You can track the approval status on the My Applications page. If your application is rejected, you can view the reason, make the necessary changes, and resubmit it.

Step 2: Use approved capabilities

Log on to the Cell Phone Number Service console and choose My Applications in the left-side navigation pane to view your approved capabilities. Obtain an authorization ID to use the service as described below:

API

After you obtain the authorization ID, call the relevant API. Refer to the return parameters in the API documentation to interpret the results.

  • Through the Alibaba Cloud OpenAPI Explorer:

    This method is ideal for developers who prefer an interactive interface or are new to Alibaba Cloud products. You can use the OpenAPI Explorer to debug API calls and get SDK request examples.

  • Through the Cell Phone Number Service SDK:

    This method is suitable for development using an SDK. It supports multiple programming languages, including Java, Go, PHP, Node.js, Python, and C#.

Console

  • Query a single phone number:

    Log on to the Cell Phone Number Service console. You can use the Cell Phone Number Service capabilities in the following ways, and the Query Results are returned on the right side of the console page:

    • In the left-side navigation pane, choose My Applications, find an approved capability, and click Use Now in the Actions column.

    • In the left-side navigation pane, choose Quick Start, select an industry, use case, and capability, enter the authorization ID and other parameters, and then click Query.

    • In the left-side navigation pane, choose Tag Marketplace, search for an approved capability, and click Use Now.

  • Query phone numbers in batches:

    Log on to the Cell Phone Number Service console and add a query task on the Offline tasks > Batch Query page. After the task is complete, you can export the results. For detailed steps, see Batch Query.

Step 3: View usage data

  • You can log on to the Overview page of the Cell Phone Number Service console, select a capability, and view its recent Usage Data.image

  • Log on to the Cell Phone Number Service console and choose Usage statistics in the left-side navigation pane. On this page, you can view Usage Data for the last month.

Step 4: View billing details

Log on to the Cell Phone Number Service console and choose Billing management in the left-side navigation pane:

  • On the Bills tab, you can view or export the bill amounts for each billable item in the current month.

  • On the Billing details tab, you can view more detailed billing information for each billable item.

  • On the Split bills tab, you can Customize bills. This allows you to generate bills summarized by authorization ID to track the spending for each ID.

FAQ

For frequently asked questions about Cell Phone Number Service, see Cell Phone Number Service FAQ.