Docs

Hızlı başlangıç

Son güncelleme: 2026-07-212 dk okuma

GREM geliştirici API'si, araçlarımızı HTTPS üzerinden programlı olarak çağırmanızı sağlar: mülk değerlemesi, içerik üretimi, fotoğraf iyileştirme, avatarlı video, site ve PDF üretimi ile yapay zekâ sohbeti. İstekler ve yanıtlar JSON biçimindedir.

Temel adres

Tüm uç noktalar bu adresin altındadır:

https://developers.grem.capital/api/v1

1. API anahtarı alın

Kabinde Yapay zekâ araçları → API bölümünü açın ve Anahtarlar sekmesinde bir anahtar oluşturun. Gizli değer (gsk_live_…) bir kez gösterilir - hemen kopyalayın.

Anahtara parola gibi davranın: hesabınızın araçlarına ve ücretlendirmesine erişim verir. Onu asla sürüm denetimine koymayın ve tarayıcı kodunda açığa çıkarmayın.

2. İlk çağrı

GET /ping anahtarı doğrular ve ücretsizdir:

curl -H "Authorization: Bearer gsk_live_xxx" \
  https://developers.grem.capital/api/v1/ping
{ "ok": true, "subjectId": "…", "requestId": "req_…" }

3. Bir aracı çağırma

Eşzamanlı bir çağrı örneği - mülkün ekspres değerlemesi:

curl -X POST https://developers.grem.capital/api/v1/valuation/express \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"propertyCategory":"apartment","totalArea":50}'
{
  "estimate": { "pricePoint": 156250, "rangeLow": 125575, "rangeHigh": 207813, "currency": "USD" },
  "requestId": "req_…"
}

Uzun süren araçlar

İçerik üretimi, avatarlı video ya da PDF gibi araçlar bir görev döndürür (jobId içeren 202). Görevin durum uç noktasını yoklayın (bu ücretsizdir) ya da daha iyisi, tamamlandığında haberdar olmak için bir webhook kaydedin. Üretilen dosyalar kendi alan adımız üzerinden yapıt olarak sunulur.

Tüm uç noktaları inceleyin

Etkileşimli gezgin

İstekleri https://developers.grem.capital/docs adresindeki Swagger UI'da canlı deneyin.

OpenAPI tanımı

https://developers.grem.capital/openapi.json dosyasını Postman ya da Insomnia'ya alın veya ondan bir istemci üretin.

Sık sorulan sorular

API anahtarını nereden alırım?

Kabinde: Yapay zekâ araçları > API, «Anahtarlar» sekmesi. Gizli değer bir kez gösterilir - hemen kopyalayın.

Temel adres nedir?

https://developers.grem.capital/api/v1

Anahtarın çalıştığını nasıl kontrol ederim?

GET /ping çağrısını yapın - bu çağrı ücretlendirilmez.

Okuma istekleri ücretlendiriliyor mu?

Hayır. GET istekleri API çağrısı sayılmaz ve cüzdandan düşülmez; ertelenmiş görevlerin durumunu yoklamak da buna dahildir.

Çağrı 402 döndürürse ne yapmalı?

Cüzdanda para yetmiyor ya da tarifenin kotası bitmiş demektir. Bakiyeyi doldurun ya da daha üst bir tarifeye geçin.

Bu makale yardımcı oldu mu?