tq share icon

tq share

天启数据
Join our community

Actions6

Overview

This node integrates with the Tianqi Data (天启数据) API to perform various operations related to phone number management and verification. Specifically, the "拉黑手机号" (Blacklist Phone Number) operation allows users to add a phone number to a blacklist, preventing its further use or processing within the system.

Common scenarios for this node include:

  • Managing phone numbers in marketing or verification workflows by blacklisting unwanted or fraudulent numbers.
  • Automating the process of blocking phone numbers that have been identified as problematic.
  • Integrating with Tianqi Data services to retrieve user wallet balances, obtain phone numbers, or fetch verification codes alongside blacklisting capabilities.

Practical example:

  • A user wants to block a suspicious phone number from receiving SMS messages or participating in verification processes. Using this node's "拉黑手机号" operation, they can input the channel ID and phone number to blacklist it via the Tianqi Data API.

Properties

Name Meaning
渠道ID The Channel ID associated with the phone number; identifies the source or category.
手机号码 The phone number to be blacklisted.

These properties are required inputs when performing the "拉黑手机号" operation.

Output

The node outputs a JSON array where each element corresponds to the result of processing an input item. For the "拉黑手机号" operation, the output JSON object includes at least a message field indicating the status, typically "已拉黑" meaning "blacklisted".

Example output JSON snippet:

{
  "message": "已拉黑"
}

No binary data is produced by this node.

Dependencies

  • Requires an API key credential for Tianqi Data API authentication.
  • Connects to the base URL: https://api.tqsms.xyz/api.
  • Uses HTTP GET requests to interact with the API endpoints.
  • No additional environment variables are needed beyond the API credential.

Troubleshooting

  • Common issues:

    • Invalid or missing API token: Ensure the API key credential is correctly configured in n8n.
    • Incorrect channel ID or phone number format: Validate inputs before execution.
    • Network connectivity problems: Verify access to https://api.tqsms.xyz/api.

  • Error messages:

    • If the API returns an error code, it will be included in the output under an error field if "Continue On Fail" is enabled.
    • Typical errors may relate to authorization failures or invalid parameters.

  • Resolution tips:

    • Double-check credentials and permissions.
    • Confirm that the channel ID and phone number exist and are valid.
    • Use "Continue On Fail" cautiously to handle partial failures gracefully.

Links and References

  • Tianqi Data official API documentation (if available) should be consulted for detailed API usage and parameter definitions.
  • n8n documentation on creating and using custom nodes: https://docs.n8n.io/creating-nodes/

Discussion