Overview
This node interacts with a third-party service to obtain mobile phone numbers and related data. It is particularly useful for scenarios where users need to programmatically retrieve phone numbers based on specific keywords, channels, or filters such as operator type or number segments. For example, it can be used in marketing automation to fetch valid phone numbers for campaigns, or in testing environments where phone numbers matching certain criteria are required.
The "获取手机号" (Get Phone Number) operation allows users to:
- Search for phone numbers by keyword.
- Select a channel associated with the keyword.
- Filter numbers by operator type (all, non-virtual, virtual).
- Specify exact phone numbers or number segments to narrow down results.
Properties
| Name | Meaning |
|---|---|
| 关键词 (search) | Keyword to search for phone numbers. Supports selecting from a searchable list. |
| 当前渠道 (remoteOptions) | The current channel selected based on the chosen keyword. This depends on the keyword selection. |
| 运营商 (operator) | Operator filter for the phone numbers: "全部" (All), "非虚拟" (Non-virtual), "虚拟" (Virtual). |
| 指定号码 (phone_num) | Specific phone number to retrieve. Allows fetching a particular number if known. |
| 指定号段 (scope) | Specific number segment to query, e.g., numbers starting with "137" or "1371". |
Output
The output is a JSON array where each element corresponds to the result of the phone number retrieval request for each input item. Each element contains fields returned by the external API, including but not limited to:
channelId: Identifier of the channel used for the phone number.- Other data fields as provided by the API response related to the phone number(s).
The node does not output binary data.
Dependencies
- Requires an API key credential for authentication with the external service at
https://api.tqsms.xyz/api. - The node makes HTTP requests to this API endpoint to perform operations.
- The node uses internal helper methods to load options dynamically for the keyword and channel selections.
Troubleshooting
Common issues:
- Invalid or missing API token will cause authentication failures.
- Selecting a keyword without available channels may result in empty or error responses.
- Specifying invalid phone numbers or number segments might return no data.
Error messages:
- Errors from the HTTP requests will be thrown unless "Continue On Fail" is enabled.
- If the API returns an error code, it will be included in the output when continuing on failure.
Resolutions:
- Ensure the API key credential is correctly configured and valid.
- Verify that the keyword and channel selections are correct and correspond to available data.
- Use valid phone number formats and number segments.
Links and References
- API Base URL — Official API endpoint used by the node.
- No additional public documentation was found within the source code. Users should refer to the service provider's official documentation for detailed API usage.