tq share icon

tq share

天启数据
Join our community

Actions6

Overview

This node integrates with the Tianqi Data (天启数据) API service to perform various operations related to phone numbers and verification codes. Specifically, for the "拉黑手机号" (Blacklist Phone Number) operation, it allows users to add a phone number to a blacklist via the API. This can be useful in scenarios where you want to block or flag certain phone numbers from further processing or communication, such as preventing spam calls or fraudulent activities.

Practical examples:

  • Automatically blacklisting suspicious phone numbers collected during user registration.
  • Managing a list of blocked phone numbers to avoid sending verification codes or marketing messages.
  • Integrating with a phone verification workflow to mark numbers that should no longer receive messages.

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 one input item. For the blacklist operation, the output JSON object includes at least a message field indicating the status, typically "已拉黑" which means "Already Blacklisted".

Example output JSON snippet:

{
  "message": "已拉黑"
}

No binary data is produced by this node.

Dependencies

  • Requires an API key credential for the Tianqi Data API service.
  • The node makes HTTP requests to the base URL: https://api.tqsms.xyz/api.
  • Proper configuration of the API key credential within n8n is necessary for authentication.

Troubleshooting

  • Common issues:

    • Invalid or missing API token: Ensure the API key credential is correctly set up and valid.
    • Incorrect channel ID or phone number format: Verify that the inputs conform to expected formats.
    • Network connectivity problems: Confirm that the n8n instance can reach the external API endpoint.

  • Error messages:

    • If the API returns an error code, the node will throw an exception unless "Continue On Fail" is enabled.
    • When "Continue On Fail" is enabled, errors are returned as objects with an error property containing the error code.

To resolve errors, check the API credentials, input parameters, and network access.

Links and References

  • Tianqi Data official API documentation (if publicly available)
  • n8n HTTP Request node documentation for understanding request options
  • General best practices for managing blacklists in telephony or messaging systems

Discussion