WhatsApp Number Validator

Check if any phone number has WhatsApp registered. Supports single and batch validation with international number format.

原始信息汇总

WhatsApp Number Validator API 数据集概述

基本信息

• 数据集名称: WhatsApp Number Validator
• 类别: Communication
• 提供商: API Services
• 订阅者数量: 1
• 当前版本: v1

定价计划

• BASIC: $0.00 / 月
• PRO: $7.99 / 月
• ULTRA: $19.99 / 月
• MEGA: $49.99 / 月

核心功能

• 单号码验证
• 批量验证（每个请求最多20个号码）
• 支持国际号码格式（E.164）
• 内置缓存以实现快速重复查询
• 返回格式化号码和国家代码

支持的号码格式

• [phone]
• 5511999999999
• (11) 99999-9999
• [phone]（国际格式）

API端点

GET /validate — 单号码验证

检查单个电话号码是否注册了WhatsApp。

查询参数

参数	类型	必需	描述
phone	string	是	任意格式的电话号码
country	string	否	默认国家代码（默认：BR）

示例请求

GET /validate?phone=5511999999999&country=BR

示例响应 json { "success": true, "phone": "5511999999999", "formatted": "[phone]", "country": "BR", "hasWhatsApp": true, "cached": false, "checkedAt": "2024-01-01T12:00:00.000Z" }

POST /validate/batch — 批量验证

在单个请求中验证最多20个号码。

请求体（JSON）

参数	类型	必需	描述
phones	array	是	电话号码数组（最多20个）
country	string	否	默认国家代码（默认：BR）

示例请求 json { "phones": ["5511999999999", "5521988887777"], "country": "BR" }

示例响应 json { "success": true, "total": 2, "checkedAt": "2024-01-01T12:00:00.000Z", "results": [ { "input": "5511999999999", "phone": "5511999999999", "formatted": "[phone]", "country": "BR", "hasWhatsApp": true, "cached": false, "error": null } ] }

GET /validate/status — WhatsApp状态

返回WhatsApp客户端连接状态和缓存统计信息。

示例响应 json { "success": true, "whatsapp": { "ready": true, "state": "connected" }, "cache": { "hits": 42, "misses": 8, "keys": 50 } }

GET /health — 健康检查

示例响应 json { "status": "ok", "version": "1.0.0", "whatsapp": { "ready": true, "state": "connected" }, "uptime": 3600 }

认证

所有端点都需要X-RapidAPI-Key请求头（由RapidAPI自动添加）。对于本地测试，可使用X-API-Key请求头并附带您的API_SECRET_KEY。

错误代码

状态码	错误	描述
400	BadRequest	参数缺失或无效
401	Unauthorized	API密钥无效
422	InvalidPhoneNumber	无法解析电话号码
429	TooManyRequests	超出速率限制
503	ServiceUnavailable	WhatsApp客户端尚未就绪