البداية
عنوان API، المصادقة، والجلسة والمفتاح.
مفتاح منفصل لكل جلسة. بعد توثيق الحساب: أنشئ جلسة، اربط واتساب، ثم أنشئ المفتاح من صفحة الجلسة. كل المسارات أدناه نسبية لعنوان API.
عنوان API
https://whatsapi.tprotool.com/v1/whatsapp
المصادقة — رأس الطلب
Authorization: Bearer tp_ins_… Content-Type: application/json
المفتاح يبدأ بـ tp_ins_ ويعمل على جلسته فقط. احفظه في الخادم لديك ولا تضعه في كود يصل للمتصفح.
الجلسة والمفتاح
GET /instances/{instance_id}
HTTP 200
{
"success": true,
"instance": {
"instance_id": "ins_…",
"display_name": "…",
"control_status": "running",
"engine_status": "WORKING",
"linked_phone": "9665xxxxxxxx"
},
"request_id": "…"
}
GET /instances/{instance_id}/api-key → { "instance_id": "ins_…", "key_prefix": "tp_ins_…" }
POST /instances/{instance_id}/api-key/rotate → { "api_key": "tp_ins_…", "key_prefix": "…" } instance_id هو نفس ins_… الظاهر في صفحة الجلسة. engine_status = WORKING يعني أن واتساب متصل وجاهز للإرسال.
التدوير يُصدر مفتاحاً جديداً ويوقف القديم فوراً — حدّث المفتاح في أنظمتك مباشرة.