Sandbox (test mühiti)

Test açarı sandbox mühitində işləyir. Sorğularınız canlı açarla olduğu kimi eyni şlüzdən keçir: açar, icazələr, sorğu limitləri, Idempotency-Key, sorğu yoxlamaları, tapşırıqlar, fayllar və vebhuklar real mühitdəki kimi işləyir. Yalnız işin özü simulyasiya olunur: heç bir alət işə düşmür, heç nə yaradılmır və ödəniş tutulmur.

Test açarı alın

Kabinetdə API → Açarlar bölməsini açın, Test açar növünü seçin və açarı yaradın. Test açarı gsk_test ilə başlayır. Ondan canlı açar kimi istifadə edin.

Sandbox mühitinin hər cavabında Grem-Sandbox: true başlığı olur ki, test jurnalı heç vaxt real işlə qarışdırılmasın - açar yoxlanılmazdan əvvəl verilən cavablar da (səhv formatlı JSON, 413, naməlum yol) daxil olmaqla.

Nə baş verir

• Sorğu yoxlamaları realdır. Real mühitin rədd edəcəyi sorğu sandbox mühitində də eyni status və səbəblə rədd edilir: çatışmayan sahə, kontent paketində 4-dən az foto, nə obyekt, nə təsvir, nə şəhər, nə də sahə göstərilməyən mətnlər. multipart sorğularının forma sahələri, başqa kateqoriyanın hesabat sahələri və evin heatingType dəyərləri, həmçinin yüklənmiş fayllar da yoxlanılır: onların növü və ölçüsü. Real mühitin kəsdiyi və ya əvəz etdiyi dəyərləri (uzun mətn, naməlum video length) sandbox da qəbul edir.
• Nəticələr nümunədir. Sinxron alətlər dərhal sabit nümunə dəyərlərlə cavab verir. Asinxron alətlər jobId qaytarır; tapşırıq təxminən 5 saniyəyə pending → running → nəticə mərhələlərindən keçir.
• Qiymətləndirmə hesabatının yoxlanılması real mühitdəki kimi nümunə extracted məlumatları ilə action_required vəziyyətində dayanır; onu POST /valuation/review/jobs/{id}/confirm ilə təsdiqləyin.
• Fayllar əvəzedicidir. PDF və şəkillər açıla bilən real fayllardır; video, docx və mətnlər düzgün məzmun növü olan qısa, işarələnmiş əvəzedicilərdir. Fayl yalnız bitmiş sandbox tapşırığı üçün, həmin alətin öz yolunda və tapşırığın qaytardığı artefakt identifikatoru ilə mövcuddur - əks halda 404. Avatar videosu real mühitdəki kimi bitmiş tapşırığın istənilən artefakt identifikatoru üçün verilir. Range işləyir (206, 416).
• Vebhuklar realdır. Test açarı yalnız sandbox vebhuk ünvanlarını yaradır və idarə edir. Onlar yalnız sandbox tapşırıqlarının hadisələrini alır - real mühitdəki kimi imzalanmış, təkrar cəhdli göndərişlər. Canlı ünvanlar heç vaxt sandbox hadisələrini almır, test açarı isə onları görə və dəyişə bilməz.

Nəticəni seçin

Grem-Simulate başlığı çağırışın və ya tapşırığın necə bitəcəyini seçir:

Dəyər böyük-kiçik hərfə həssas deyil. Naməlum dəyər 400 ilə cavablanır ki, yazı səhvi heç vaxt uğur kimi keçməsin. Canlı açarlar bu başlığı nəzərə almır.

curl -X POST https://developers.grem.capital/api/v1/text/generate \
  -H "Authorization: Bearer gsk_test_xxx" \
  -H "Content-Type: application/json" \
  -H "Grem-Simulate: failed" \
  -d '{"city":"Berlin","totalArea":64}'

Test açarı ilə nə etmək olar

Real mühitdən fərqlər

• Nəticələr sabit nümunələrdir, qiymətləndirmə və ya real mətnlər deyil. Onları istifadəçilərinizə göstərməyin.
• Sandbox objectId sahəsindəki obyektin mövcud olduğunu və sizə aid olduğunu yoxlamır; real mühit bu halda 403 və ya 404 ilə cavab verir.
• Tapşırıqlar və nəticələr bir gün saxlanılır.

Əlaqəli

• Sürətli başlanğıc
• Tapşırıqlar və nəticələr
• Vebhuklar