Sandbox

Test anahtarı sandbox'ta çalışır. İstekleriniz canlı anahtardakiyle aynı ağ geçidinden geçer: anahtar, kapsamlar, limitler, Idempotency-Key, istek denetimi, işler, dosyalar ve webhook'lar canlı ortamdaki gibi çalışır. Yalnızca işin kendisi simüle edilir: hiçbir araç çalışmaz, hiçbir şey oluşturulmaz ve hiçbir ücret alınmaz.

Test anahtarı alma

Panelde API → Anahtarlar bölümünü açın, anahtar türü olarak Test seçin ve anahtarı oluşturun. Test anahtarı gsk_test ile başlar. Onu canlı anahtar gibi kullanın.

Her sandbox yanıtı Grem-Sandbox: true başlığını taşır; böylece bir test günlüğü asla gerçek işle karıştırılmaz; anahtar kontrol edilmeden önce verilen yanıtlar (bozuk JSON, 413, bilinmeyen yol) da dahil.

Ne olur

• İstek denetimi gerçektir. Canlı ortamın reddedeceği bir isteği sandbox aynı durum ve nedenle reddeder: eksik bir alan, içerik paketinde 4'ten az fotoğraf, ilan, açıklama, şehir ve alan olmadan metinler. multipart isteklerin form alanları, başka kategoriye ait rapor alanları ve evin heatingType değerleri ve yüklenen dosyaların türü ile boyutu da denetlenir. Canlı ortamın kestiği veya değiştirdiği şeyi (uzun bir metin, bilinmeyen bir video length değeri) sandbox da kabul eder.
• Sonuçlar örnektir. Eşzamanlı araçlar sabit örnek değerlerle hemen yanıt verir. Eşzamansız araçlar bir jobId döndürür; iş yaklaşık 5 saniyede pending → running → sonuç aşamalarından geçer.
• Rapor incelemesi canlı ortamdaki gibi extracted içinde örnek verilerle action_required durumunda durur; POST /valuation/review/jobs/{id}/confirm ile onaylayın.
• Dosyalar yer tutucudur. PDF'ler ve görseller açılabilen gerçek dosyalardır; video, docx ve metinler doğru içerik türüne sahip kısa, etiketli yer tutuculardır. Dosya yalnızca bitmiş bir sandbox işi için, o aracın kendi yolunda ve işin döndürdüğü bir yapıt kimliğiyle vardır; aksi halde 404. Avatar videosu, canlı ortamdaki gibi bitmiş bir işin herhangi bir yapıt kimliğiyle verilir. Range çalışır (206, 416).
• Webhook'lar gerçektir. Test anahtarı yalnızca sandbox webhook adresleri oluşturur ve yönetir. Bu adresler yalnızca sandbox işlerinin olaylarını alır: yeniden denemeli imzalı teslimler, tıpkı canlı ortamdaki gibi. Canlı adresler sandbox olaylarını asla almaz; test anahtarı onları göremez ve değiştiremez.

Sonucu seçme

Grem-Simulate başlığı, çağrının veya işin neyle biteceğini belirler:

Değerde büyük/küçük harf fark etmez. Bilinmeyen bir değer 400 döndürür; böylece bir yazım hatası asla başarı olarak geçmez. Canlı anahtarlar bu başlığı yok sayar.

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 anahtarı neler yapabilir

Canlı ortamdan farklar

• Sonuçlar sabit örneklerdir; bir değerleme veya gerçek metin değildir. Kullanıcılarınıza göstermeyin.
• Sandbox, objectId içindeki ilanın var olduğunu ve size ait olduğunu denetlemez; canlı ortam bu durumda 403 veya 404 döndürür.
• İşler ve sonuçlar bir gün saklanır.

İlgili makaleler

• Hızlı başlangıç
• İşler ve sonuçlar
• Webhook'lar