API vasitəsilə alətlər

Son yeniləmə: 2026-10-023 dəq oxu

Kabinetdəki alətlərin eynisi proqram yolu ilə də əlçatandır. Alətin qiyməti kabinetdəki kimidir, üstəgəl bir API çağırışı (Limitlər və ödəniş). Baza ünvanı: https://developers.grem.capital/api/v1.

Siyahı

Alət	Sorğu	Scope	Necə işləyir
Ekspres qiymətləndirmə	`POST /valuation/express`	`tools:valuation`	dərhal
Tam qiymətləndirmə hesabatı	`POST /valuation/report`	`tools:valuation`	tapşırıq
İcarə qiymətləndirməsi	`POST /valuation/rent`	`tools:rent`	dərhal
Hesabatın yoxlanması	`POST /valuation/review`	`tools:review`	tapşırıq, fayl ilə, təsdiq gözləyir
Kontent paketi	`POST /content/generate`	`tools:contentgen`	tapşırıq
Elan mətnləri	`POST /text/generate`	`tools:text`	tapşırıq
Fotolardan video	`POST /video/create`	`tools:video`	tapşırıq, fayllar ilə
Avatar video	`POST /avatar/video`	`tools:avatar`	tapşırıq
Foto yaxşılaşdırma	`POST /photo/enhance`	`tools:photo`	tapşırıq, fayl ilə
Mərtəbə planının təmizlənməsi	`POST /floorplan/create`	`tools:floorplan`	dərhal (`202` artıq nəticəni ehtiva edir), fayl ilə
Elanın landing səhifəsi	`POST /site/create`	`tools:sitegen`	dərhal
PDF təqdimat	`POST /pdf/create`	`tools:pdf`	tapşırıq
Şəxsi flayer	`POST /flyer/create`	`tools:flyer`	dərhal
Sənədlərdən qaralama	`POST /draft/extract`	`tools:draft`	dərhal, fayllar ilə

Hər alətin sahələri, nümunələri və xətaları:

Qiymətləndirmə - ekspres, tam hesabat, icarə, hesabatın yoxlanması.
Kontent və video - kontent paketi, mətnlər, video, avatar.
Fotolar və mərtəbə planları - foto yaxşılaşdırma, mərtəbə planı.
Obyekt materialları - landing səhifə, PDF, flayer, qaralama.

Alətlərin giriş kimi qəbul etdiyi id-lər (səs, avatar, musiqi, yekun ifadə) və alətlərin cari əlçatanlığı: Arayış məlumatları.

Məlumatların göndərilməsi

JSON - əksər alətlər: Content-Type: application/json.
multipart/form-data - fayllı alətlər. Onların sahə quruluşu fərqlidir və bu vacibdir:
- foto yaxşılaşdırma və qaralama - parametrlər data sahəsində bir JSON sətri kimi, fayllar ayrı hissələr kimi;
- video - hər parametr ayrıca forma sahəsi kimi (prompt, length, musicTrackId ...), fotolar photos hissələri kimi;
- hesabatın yoxlanması və mərtəbə planı - fayl file hissəsində, parametrlər ayrı sahələr kimi.

Fayl gözləyən alətə JSON göndərilməsi 400 qaytarır.

Cavablar

Sinxron alət nəticə ilə 200 cavabı verir.
Asinxron alət tapşırıqla 202 cavabı verir; nəticəni sorğulama (polling) və ya vebhuk vasitəsilə alın (Tapşırıqlar və nəticələr).
Yaradılan fayllar GET /artifacts/{path} vasitəsilə endirilir.

Aləti işə salan hər sorğunu Idempotency-Key ilə göndərin (İdempotentlik).

API-də olmayanlar

3D tur və məhəllə üzrə bazar hesabatı hələlik yalnız kabinetdə əlçatandır.

Əlaqəli

Bu məqalə faydalı oldu?