Foydalanuvchilar

Foydalanuvchi — bu tizimda ro'yxatga olingan SIP (VoIP) telefon moduli (extension). Har bir foydalanuvchiga unikal ichki raqam va parol beriladi. Ushbu ma'lumotlar orqali IP-telefon yoki softphone (kompyuter/smartfon ilovasi) ulanadi.

Modul diapazoni

Foydalanuvchi raqamlari 100 dan 4999 gacha bo'lishi mumkin (3 yoki 4 xonali).

Asosiy tushunchalar

Atama	Izoh
Modul (Extension)	Ichki telefon raqami (masalan: 101, 1050)
Nom	Foydalanuvchini tanishtiruvchi matn
Parol	SIP autentifikatsiya uchun parol (min. 6 belgi)
Holat (State)	Foydalanuvchining mavjud kanallar ro'yhati va holati (massiv).
Reachable	Foydalanuvchining aktiv yoki aktiv emasligi
Yo'naltirish (Redirection)	Chaqiruvga qanchadur vaqt javob berilmay qolganda boshqa yerga yo'naltirilishi

Yo'naltirish (Redirections)

Agar foydalanuvchi javob bermasa, chaqiruv avtomatik boshqa raqamga yo'naltirilishi mumkin. 3 bosqichli yo'naltirish qo' llab-quvvatlanadi:

Bosqich	Kechikish (delay)	Yo'naltirish manzili (redirect)
1-bosqich	delay1 soniyadan keyin	redirect1 ga
2-bosqich	delay2 soniyadan keyin	redirect2 ga
3-bosqich	delay3 soniyadan keyin	redirect3 ga

Yo'naltirish manzili sifatida nima ishlatish mumkin?

Yo'naltirish manzili (redirect1, redirect2, redirect3) sifatida istalgan quyidagi modul raqami ishlatilishi mumkin:

• Boshqa foydalanuvchi: 101, 205
• Tashqi mobile raqam: [mobile-raqam]@[tashqi-raqam] 901234567@781130590,

---

API

Ogohlantirish

Barcha endpointlar Bearer token talab qiladi. Batafsil: Auth

Ro'yxat olish

Endpoint

GET /ats/ps-user

Response

Field	Type	Description
status	string	success yoki error
code	int	HTTP status kodi
result	array of PsUserResource	Foydalanuvchilar ro'yxati
message	string	Xabar

Example

{
  "status": "success",
  "code": 200,
  "result": [
    {
      "id": 101,
      "title": "Operator 1",
      "username": "101",
      "password": "secret123",
      "redirections": {
        "delay1": 30,
        "redirect1": "102",
        "delay2": null,
        "redirect2": null,
        "delay3": null,
        "redirect3": null
      },
      "state": [
        "available"
      ],
      "reachable": true
    }
  ],
  "message": "Ok"
}

---

Yaratish

Endpoint

POST /ats/ps-user

Request

Field	Type	Required	Description
title	string	Yes	Foydalanuvchi nomi (max 30 belgi)
number	integer	Yes	Modul raqami (3–4 xonali, 100–4999, unikal)
password	string	Yes	SIP paroli (min 6 belgi)

Example

{
  "title": "Operator 1",
  "number": 101,
  "password": "secret123"
}

Response

Field	Type	Description
status	string	success yoki error
code	int	HTTP status kodi (201)
result	PsUserResource	Yaratilgan foydalanuvchi
message	string	Sip user successfully created

---

Ko'rish

Endpoint

GET /ats/ps-user/{id}

Response

Field	Type	Description
status	string	success yoki error
code	int	HTTP status kodi
result	PsUserResource	Foydalanuvchi ma'lumotlari
message	string	Xabar

---

Yangilash

Endpoint

PUT /ats/ps-user/{id}

Request

Field	Type	Required	Description
title	string	Yes	Foydalanuvchi nomi (max 30 belgi)
number	integer	Yes	Modul raqami (3–4 xonali, 100–4999, unikal)
password	string	Yes	SIP paroli (min 6 belgi)

---

O'chirish

Endpoint

DELETE /ats/ps-user/{id}

Response

Field	Type	Description
status	string	success yoki error
code	int	HTTP status kodi
result	array	Bo'sh array
message	string	Sip user (if existed) successfully deleted

---

Yo'naltirishlarni yangilash

Endpoint

POST /ats/ps-user/{id}/redirections

Request

Field	Type	Required	Description
delay1	integer|null	No	1-bosqich kechikish (soniya, 1–3200)
redirect1	string|null	No	1-bosqich yo'naltirish manzili
delay2	integer|null	No	2-bosqich kechikish (soniya, 1–3200)
redirect2	string|null	No	2-bosqich yo'naltirish manzili
delay3	integer|null	No	3-bosqich kechikish (soniya, 1–3200)
redirect3	string|null	No	3-bosqich yo'naltirish manzili

Example

{
  "delay1": 30,
  "redirect1": "5401",
  "delay2": null,
  "redirect2": null,
  "delay3": null,
  "redirect3": null
}

---

Kontakt ro'yxatini olish (SIP contacts)

Endpoint

GET /ats/ps-user/contacts

Barcha ulanib turgan SIP qurilmalar ro'yxatini qaytaradi.

Response

Field	Type	Description
status	string	success yoki error
code	int	HTTP status kodi
result	array of PsContactResource	Kontaktlar ro'yxati

---

Bitta foydalanuvchi kontaktini olish

Endpoint

GET /ats/ps-user/{id}/contact

Response

Field	Type	Description
status	string	success yoki error
code	int	HTTP status kodi
result	PsContactResource	Kontakt ma'lumotlari