راهنمای اپراتور — اتصال شاهکار HTTP به کارتابل ADSL

← بازگشت به راهنما

راهنمای اپراتور — اتصال شاهکار HTTP به کارتابل ADSL



> version: 1.1 | last_updated: 2026-08-10 | audience: admin / ops

هدف



استعلام شاهکار (`estelaam`) روی وضعیت **منتظر شاهکار** در pipeline ADSL به‌صورت خودکار اجرا شود.

پیش‌نیاز



  • **توکن API** را در یکی از این دو جا بگذارید:

  • - منو **Compliance → تنظیمات شاهکار** → درایور `api` → فیلد `api_key`
    - یا هدر `Authorization` عملیات با `{{shahkar_authorization}}`
  • اطلاعات هویتی مشتری در پروفایل کامل باشد:

  • - حقیقی ایرانی: نام، نام خانوادگی، پدر، تاریخ تولد، شناسنامه، کد ملی
    - اتباع / حقوقی: طبق نگاشت [شاهکار وضعیت‌های عملیاتی](./shahkar-workflow-actions.md)

    بدنهٔ `http.shahkar_estelaam` با `shahkar_dynamic_body` از مشتری ساخته می‌شود (نیازی به ویرایش دستی قالب نیست).

    جریان



    ```
    AAA ایجاد شد → منتظر شاهکار → (HTTP estelaam) → تأیید / رد
    ```

  • موفق → `شاهکار تأیید شد` → نصب

  • ناموفق → `شاهکار رد شد` → لغو و جمع‌آوری


  • تست دستی



  • کیس ADSL را روی وضعیت **منتظر شاهکار** بگذارید.

  • دکمه **اجرای عملیات وضعیت** را بزنید.

  • در تاریخچه، رویداد «اجرای عملیات» + **جزئیات عملیات / پاسخ** (HTTP status و body) را ببینید.


  • منبع فیلدها



    فیلدها از Party / حساب مشتری خوانده می‌شوند. جزئیات نگاشت چهار حالت حقیقی/حقوقی × ایرانی/غیرایرانی در [شاهکار وضعیت‌های عملیاتی](./shahkar-workflow-actions.md).

    مرتبط: [وضعیت‌های عملیاتی workflow](./workflow-actions.md)