Skip to main content
#P1757

PUT /v2/core/application_interface/status/{id}

Update Application Interface Status

این اندپوینت به منظور تغییر سریع وضعیت (Status) یک رابط نرم‌افزاری استفاده می‌شود. برخلاف متد ویرایش کلی، این متد تنها فیلد status را در دیتابیس بروزرسانی می‌کند.

Request Overview

URL: /v2/core/application_interface/status/{id}
Method: PUT
Controller: CoreController@updateStatusApplicationInterface
Middleware: authWithJwt

Access Control

  • نیاز به توکن احراز هویت (JWT) دارد.

Parameters

Parameter Type Location Description
id Integer Path شناسه یکتای رکورد در جدول application_interface.
status String Body وضعیت جدید برای اعمال (مثلاً active یا inactive).

Logic Details

عملیات به صورت مستقیم روی دیتابیس انجام می‌شود:

  1. ابتدا با استفاده از id دریافتی، کوئری آپدیت روی جدول application_interface اجرا شده و فیلد status با مقدار ورودی جایگزین می‌شود.
  2. بلافاصله پس از آپدیت، رکورد مورد نظر مجدداً از دیتابیس (با find($id)) بازیابی می‌شود تا آخرین وضعیت تایید شده برگردانده شود.

Response Structure

نمونه پاسخ موفق (200 OK)

{
    "payload": {
        "id": 15,
        "branch_id": 1,
        "type": "sms",
        "service": "irnoti",
        "object_type": "colleague",
        "object": 102,
        "settings": "{\"apiKey\":\"...\"}",
        "status": "inactive",
        "created_at": "2023-01-01 12:00:00",
        "updated_at": "2023-12-09 14:30:00"
    },
    "meta": {
        "timestamp": 1733754000
    }
}

Flowchart

Start Request (ID, Status)
↓
Update 'status' in DB
(Where ID = $id)
↓
Fetch Updated Record
(DB::find($id))
↓
Return JSON (Payload)
Back to top