Schnellstart

Öffnen Sie im Kabinett API → Schlüssel und klicken Sie auf Schlüssel erstellen. Der Schlüssel wird einmal angezeigt - speichern Sie ihn in einem Secret-Manager. Ein neuer Schlüssel erhält alle Bereiche; beim Erstellen können Sie sie einschränken. Details: Authentifizierung.

curl https://developers.grem.capital/api/v1/ping \
  -H "Authorization: Bearer gsk_live_xxx"

{"ok": true, ...} bedeutet, dass der Schlüssel funktioniert. GET /ping ist kostenlos und braucht keinen Bereich. Was der Schlüssel genau darf, zeigt GET /me.

Die Express-Bewertung antwortet sofort:

curl -X POST https://developers.grem.capital/api/v1/valuation/express \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: 6b1f0c2e-6c1e-4a8e-9f5d-3c2a1b0e9d87" \
  -d '{"propertyCategory":"apartment","addressText":"Torstraße 12, Berlin","totalArea":64,"rooms":2,"currency":"EUR"}'

{
  "estimate": { "pricePoint": <Zahl>, "rangeLow": <Zahl>, "rangeHigh": <Zahl>, "confidence": "<Stufe>", "currency": "EUR" },
  "requestId": "req_..."
}

Idempotency-Key macht eine Wiederholung sicher: dieselbe Anfrage mit demselben Schlüssel liefert das erste Ergebnis und belastet nicht erneut.

Lange Werkzeuge antworten mit 202 und einem Auftrag. Wenn Sie das Ergebnis per Webhook erhalten wollen, abonnieren Sie zuerst (Schritt 5): Ein vor dem Abonnement gestarteter Auftrag sendet sein Ereignis nicht.

curl -X POST https://developers.grem.capital/api/v1/text/generate \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"city":"Berlin","totalArea":64,"rooms":2,"propertyCategory":"apartment","language":"en"}'

{ "jobId": "...", "status": "...", "state": "pending", "requestId": "req_..." }

Fragen Sie den Status ab (kostenlos), bis state completed, partial oder failed ist:

curl https://developers.grem.capital/api/v1/text/generate/jobs/JOB_ID \
  -H "Authorization: Bearer gsk_live_xxx"

Wie Aufträge funktionieren und wie Sie die Dateien holen: Aufträge und Ergebnisse.

Statt abzufragen, abonnieren Sie das Ereignis - GREM sendet ein POST an Ihre URL, wenn der Auftrag fertig ist. Abonnieren Sie vor dem Start des Auftrags: Ein vor dem Abonnement gestarteter Auftrag sendet sein Ereignis nicht.

curl -X POST https://developers.grem.capital/api/v1/webhooks \
  -H "Authorization: Bearer gsk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/grem-hook","events":["text.completed","text.failed"]}'

Die Antwort enthält das Signaturgeheimnis whsec_... - es wird einmal angezeigt. Signatur prüfen: Webhooks.