Asosiy tarkibga o'tish
AgencyHandy API istalgan tashqi tizim yoki skriptdan lead yaratish, mijozlarni boshqarish, buyurtmalarni yangilash va boshqa ko’plab ishlarni avtomatlashtirishga imkon beradi. Har bir so’rov ish muhiti sozlamalaridan yaratgan API kaliti bilan autentifikatsiya qilinadi. Ushbu qo’llanma sizni hisob ma’lumotlarini olish va birinchi API chaqiruvini amalga oshirishda yo’llab-boradi.
API kalitini yaratish uchun AgencyHandy ish muhitida SuperAdmin yoki Admin bo’lishingiz shart.

​
Asosiy URL

Barcha API so’rovlari quyidagi manzilga yuboriladi: 
https://api.agencyhandy.com
API hujjatlaridagi barcha namuna so’rovlarda {{URL}} ni ushbu asosiy URL bilan almashtiring.

​
1-qadam: API kalitini yarating

1

Ish muhiti konfiguratsiyasini oching

Quyidagi manzil orqali ish muhiti sozlamalariga o’ting:
{{workspaceUrl}}/workspace-config?tab=api-key
Bu Workspace Configuration ichidagi API Key tabini ochadi.
2

API kalitini yarating va nusxalang

Generate (yoki kalit allaqachon mavjud bo’lsa Regenerate) tugmasini bosing. API kalitini nusxalang va uni xavfsiz joyda saqlang — uni parol kabi muomala qiling. AgencyHandy sahifadan chiqib ketganingizdan so’ng uni yana ko’rsatmaydi.
API kalitini qayta yaratish oldingi kalitni darhol bekor qiladi. Eski kalitdan foydalanadigan mavjud integratsiyalar yangi kalit bilan yangilanmaguncha ishlashni to’xtatadi.

​
2-qadam: Kompaniya ID sini oling

Ko’pgina API endpointlari so’rov qaysi ish muhitiga qaratilganligini ko’rsatuvchi companyid sarlavhasini talab qiladi. Kompaniya ID sini olish uchun quyidagi endpointdan foydalaning.

​
Endpoint

GET {{URL}}/accounts/companies

​
Sarlavhalar

SarlavhaQiymat
x-api-keySizning API kalitingiz

​
Namuna so’rov

cURL
curl --request GET "https://api.agencyhandy.com/accounts/companies" \
  --header "x-api-key: <YOUR_API_KEY>"

​
Namuna javob

{
  "message": "Companies associated with API token.",
  "companies": [
    {
      "_id": "6525994184e9ddd79853450e",
      "name": "onethread123",
      "logo": "",
      "extraSmallLogo": "",
      "largeLogo": ""
    }
  ]
}
1

Kompaniya ID sini toping

Javobda companies massivi ichidagi _id maydonini toping. Bu sizning Kompaniya ID ingiz.
const companyId = response.companies[0]._id;
// e.g. "6525994184e9ddd79853450e"
2

Kompaniya ID sini saqlang

Kompaniya ID sini keyingi barcha API so’rovlarida ishlatish uchun saqlang. Uni companyid sarlavhasi sifatida uzatasiz:
SarlavhaQiymat
x-api-keySizning API kalitingiz
companyidSizning Kompaniya ID ingiz

​
Autentifikatsiya xulosasi

Har bir autentifikatsiya qilingan API so’rovi kamida quyidagilarni talab qiladi: 
x-api-key: <YOUR_API_KEY>
companyid: <YOUR_COMPANY_ID>
API kaliti va Kompaniya ID si qo’lingizda bo’lgach, AgencyHandy API-ning qolgan qismidan foydalanishga tayyorsiz. Quyidagi endpoint qo’llanmalaridan biriga davom eting.