البداية

البداية

عنوان 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 يعني أن واتساب متصل وجاهز للإرسال.

التدوير يُصدر مفتاحاً جديداً ويوقف القديم فوراً — حدّث المفتاح في أنظمتك مباشرة.