Asosiy tarkibga o'tish
Buyurtmani yangilash endpointi AgencyHandy-dagi mavjud buyurtmani (loyihani) o’zgartirish imkonini beradi — nomini, holatini, byudjetini, muddatini, tayinlangan menejerlarni va boshqalarni — bularning barchasini tashqi tizim yoki avtomatsiya skriptidan. Endpoint fayl biriktirmalarini ham qo’llab-quvvatlaydi, ular buyurtmaning tizim papkasiga qo’shib boriladi.
Ushbu endpointdan foydalanishdan oldin, API kaliti va Kompaniya ID sini olish uchun Boshlash qo’llanmasini bajaring.
Ushbu endpoint faqat x-api-key sarlavhasi o’rniga Authorization: Bearer <token> (kirgan a’zoning kirish tokeni) ishlatadi. Chaqiruvchingiz maqsadli kompaniyaning tasdiqlangan a’zosi sifatida autentifikatsiya qilinganligiga ishonch hosil qiling. Ruxsatsiz chaqiruvchilar 403 PermissionError oladi.

​
Oldindan talab qilinadigan shartlar

  • ✅ Tasdiqlangan ish muhiti a’zosi uchun to’g’ri Bearer token
  • ✅ GET {{URL}}/accounts/companies dan olingan Kompaniya ID si
  • ✅ Yangilamoqchi bo’lgan buyurtmaning Buyurtma ID si (Loyiha ID si, pid)

​
Endpoint

PUT {{URL}}/orders?pid=<ORDER_ID>
Content-Type: multipart/form-data — fayllar biriktirilmagan bo’lsa ham serverning multipart tahlilchisini qondirish uchun shu formatdan foydalaning.

​
Sarlavhalar

SarlavhaMajburiyTavsif
AuthorizationHaBearer <ACCESS_TOKEN> — kirgan a’zoning kirish tokeni.
companyidHaBuyurtma tegishli kompaniyaning Mongo ObjectId si.
clientidIxtiyoriyReal vaqtli mijoz socket ID si. Berilganda, bildirishnomalar uni o’z ichiga oladi.

​
So’rov parametrlari

​
pid
string
talab qilinadi
Yangilanadigan Buyurtma / Loyiha ID si. Bu so’rov satri parametri sifatida uzatiladi.

​
So’rov tanasi maydonlari

​
name
string
Buyurtma sarlavhasini yangilaydi. Kamida 2 belgi.
​
status
string
Buyurtmaning yangi holati. Quyidagilardan biri bo’lishi kerak: Pending, Ongoing, Review, Completed, Cancelled.Ruxsat etilgan o’tishlar:
  • Review faqat Ongoing yoki boshqa Review dan keyin kelishi mumkin. Pending dan to’g’ridan-to’g’ri Review ga o’tish 400 ValidationError qaytaradi.
  • Completed yoki Cancelled holatidagi buyurtmalar yangilanishi mumkin emas.
  • Mijozlar Pending dan o’tib ketgan buyurtmani bekor qila olmaydi.
​
budget
number
Umumiy byudjet miqdori. ≥ 0 bo’lishi shart. currency ham berilmasa buyurtmaning mavjud valyutasidan foydalanadi.
​
currency
string
Byudjet uchun valyuta kodi. Misol: USD, CAD, EUR.
​
quantity
number
Paket uchun sotib olingan birliklar soni. ≥ 1 bo’lishi shart.
​
deadline
string
Buyurtmaning tugash sanasi uchun ISO 8601 sana satri. Misol: "2025-12-31T00:00:00.000Z".
​
kickoffDate
string
Loyiha boshlanish sanasi uchun ISO 8601 sana satri.
​
notes
string
Jamoangizga ko’rinadigan ichki eslatmalar.
​
brief
string
Mijoz topshirig’i yoki loyiha xulosasi.
​
assignedProjectManagers
array
Ushbu buyurtmaga tayinlanadigan loyiha menejeri a’zo ID larining to’liq ro’yxati. Yangi ID lar jamoaga qo’shiladi; olib tashlangan ID lar o’chiriladi. Har bir ID bir xil kompaniya ichida projectManager roliga ega a’zoga tegishli bo’lishi kerak.
​
markTasksAsDone
boolean
status Completed yoki Cancelled bo’lganda majburiy. true bo’lganda, holat o’zgarishidan so’ng buyurtmadagi barcha vazifalar bajarilgan deb belgilanadi. false bo’lganda, vazifalar joriy holatida qoladi.
​
rejectRequestedTasks
boolean
Faqat status Completed yoki Cancelled bo’lganda ruxsat etiladi. true bo’lganda, holat yangilanishidan so’ng barcha kutilayotgan mijoz tomonidan so’ralgan vazifalar rad etiladi.
​
repeatCount
number
Faqat takrorlanish chastotasini o’zgartirishda obuna buyurtmalari uchun talab qilinadi. repeatDuration bilan birgalikda ishlating.
​
repeatDuration
string
Obuna buyurtmalari uchun repeatCount bilan birga talab qilinadi. Quyidagilardan biri: day, week, month, year.
​
billingCycleCount
number
Takroriy hisob-kitob tsikllarini ixtiyoriy cheklash. Standart 0 (cheklovsiz).
​
billingCycleEvent
string
Har bir hisob-kitob tsikli qanday boshqariladi. Quyidagilardan biri: createOrderWithTask, noChange.
​
files
file
Nol yoki undan ko’p fayl biriktirmalari. Fayllar buyurtmaning tizim papkasiga qo’shiladi; mavjud fayllar hech qachon qayta yozilmaydi. multipart/form-data kodlashidan foydalaning va har bir faylni files maydoni ostida biriktiring.

​
Namuna so’rov

curl --request PUT "https://api.agencyhandy.com/orders?pid=ORDER_ID_HERE" \
  --header "Authorization: Bearer <ACCESS_TOKEN>" \
  --header "companyid: <COMPANY_ID>" \
  --form "name=Website Redesign" \
  --form "status=Review" \
  --form "budget=12000" \
  --form "currency=USD" \
  --form "quantity=1" \
  --form "assignedProjectManagers[]=PROJECT_MANAGER_ID" \
  --form "notes=Scope finalized with client." \
  --form "brief=Launch-ready design refresh."
Ekvivalent JSON yuklamasi (fayllar yuborishda multipart forma yozuvlariga aylantiring): 
{
  "name": "Website Redesign",
  "status": "Review",
  "budget": 12000,
  "currency": "USD",
  "quantity": 1,
  "assignedProjectManagers": ["{{PROJECT_MANAGER_ID}}"],
  "repeatCount": 3,
  "repeatDuration": "month",
  "billingCycleEvent": "createOrderWithTask",
  "notes": "Scope finalized with client.",
  "brief": "Launch-ready design refresh."
}

​
Javoblar

HTTP HolatiTavsif
200 OKYangilash muvaffaqiyatli bo’ldi.
400 ValidationErrorNoto’g’ri buyurtma ID si, bloklangan holat o’tishi yoki noto’g’ri shakllangan yuklamasida. Tegishli bo’lganda javob fieldName ni o’z ichiga oladi.
403 PermissionErrorChaqiruvchi tasdiqlangan a’zo emas, kompaniya roliga ega emas, ish muhiti obunasi muddati tugagan yoki mijoz ruxsat etilmagan bekor qilishga harakat qildi.
500 Internal Server ErrorQayta ishlanmagan istisno — server jurnallarini tekshiring.

​
Muvaffaqiyatli javob

{
  "message": "Project has been updated"
}

​
Biznes qoidalari va yon ta’sirlar

  • Holat o’tishlari cheklangan. Review faqat Ongoing yoki boshqa Review dan keyin kelishi mumkin. Pending → Review urinishi 400 ValidationError qaytaradi.
  • Holatni Pending dan Ongoing, Review yoki Completed ga o’zgartirish buyurtmaning fayl papkasini faollashtiradi, shunday qilib yuklangan fayllar loyiha jamoasiga kirish mumkin bo’ladi.
  • status ni Completed yoki Cancelled ga o’rnatish markTasksAsDone ning true yoki false ga aniq o’rnatilishini talab qiladi.
  • Review, Completed yoki Cancelled ga holat o’zgarishlari avtomatik ravishda mijoz bildirishnomalarini ishga tushiradi:
    • Review — ko’rib chiqish kerakligi haqida mijozni xabardor qiladi.
    • Completed — mijozga orderCompletion bildirishnomasi yuboradi.
    • Cancelled — mijozga orderCancellation bildirishnomasi yuboradi.
  • Har bir muvaffaqiyatli yangilanish ushbu hodisaga obuna qilingan faol webhookingiz bo’lsa, yangilangan buyurtma hujjati va biriktirma metadata bilan ORDER.UPDATED webhook hodisasini ishga tushiradi.