GREM API'si için minik ve bağımlılıksız bir istemci. Node 18+ ve modern tarayıcılarda çalışır (genel fetch ile Web Crypto kullanır).
Kurulum
Tek bir dosyadır - derleme adımı yok, bağımlılık yok. İndirin ve projenize bırakın:
Hızlı başlangıç
import { GremClient } from './grem';
const grem = new GremClient({ apiKey: process.env.GREM_API_KEY });
const { estimate } = await grem.valuation.express({
propertyCategory: 'apartment',
totalArea: 50,
});
console.log(estimate.pricePoint, estimate.currency);
Temel adres varsayılan olarak https://developers.grem.capital/api/v1 şeklindedir. Anahtarı kabinde oluşturun: Yapay zekâ araçları -> API -> Anahtarlar.
Arka plan görevleri
Uzun süren araçlar bir jobId döndürür. Sonucu yoklayın (yoklama ücretsizdir):
const { jobId } = await grem.content.generate({ /* ... */ });
const result = await grem.jobs.wait('content/generate', jobId);
Hatalar
2xx dışındaki yanıtlar bir GremError fırlatır (RFC 7807):
import { GremError } from './grem';
try {
await grem.valuation.express({ propertyCategory: 'apartment' }); // missing totalArea
} catch (e) {
if (e instanceof GremError) console.error(e.status, e.detail, e.requestId);
}
Idempotence
Bir POST isteğini güvenle yinelemek için idempotence anahtarı geçin:
await grem.valuation.express(input, crypto.randomUUID());
Webhook'lar
Her teslimin imzasını ham gövdeye karşı doğrulayın:
import { verifyWebhookSignature } from './grem';
app.post('/grem-hook', express.raw({ type: 'application/json' }), async (req, res) => {
const raw = req.body.toString('utf8');
const ok = await verifyWebhookSignature(process.env.GREM_WEBHOOK_SECRET, req.get('x-grem-signature'), raw);
if (!ok) return res.status(400).send('invalid signature');
const event = JSON.parse(raw);
// handle event.type / event.data ...
res.sendStatus(200);
});
Her yöntem, etkileşimli gezgindeki bir uç noktaya bire bir karşılık gelir. Altta yatan isteklere Hızlı başlangıç ve Webhook'lar yazılarından bakın.