KvartalAI.lt API

Integruokite Lietuvos nekilnojamojo turto duomenis į savo sistemas. Pilna REST API su autentifikacija, rate limiting ir webhooks.

Interaktyvi Dokumentacija (Swagger)Gauti API Raktą

API Raktai

Gaukite raktą paskyros nustatymuose. Kiekvienas raktas turi galiojimo laiką ir naudojimo limitus.

Rate Limiting

1000 užklausų/min su API raktu, 60/min be rakto. Headeriuose: X-RateLimit-Remaining, X-RateLimit-Reset.

Autentifikacija

Naudokite x-api-key headerį. Visi rašymo endpoint'ai reikalauja autentifikacijos.

Webhooks

Gaukite realaus laiko pranešimus apie naujus skelbimus, crowdfunding projektus, užsakymus.

Puslapiavimas

Visi sąrašo endpoint'ai palaiko ?page=1&limit=20 parametrus. Atsakyme: pagination objektas.

Atsakymo Formatas

Visi atsakymai: { success: boolean, data: T, pagination?: {...} }. Klaidos: { error: string }.

Greita Pradžia

1. Gaukite API raktą

Prisijunkite prie savo paskyros ir eikite į API Platforma skiltį. Sukurkite naują raktą.

2. Išbandykite

curl -H "x-api-key: JŪSŲ_RAKTAS" \
  "https://kvartalai.lt/api/v1/properties?city=Vilnius&limit=5"

3. Atsakymo formatas

{
  "success": true,
  "data": [...],
  "pagination": {
    "page": 1,
    "limit": 5,
    "total": 142,
    "totalPages": 29
  }
}

Endpoint'ai

GET
/api/v1/properties

Ieškoti NT skelbimų su filtrais

curl "https://kvartalai.lt/api/v1/properties?city=Vilnius&type=butas&limit=10"
GET
/api/v1/properties/{id}

Gauti skelbimo detales

curl "https://kvartalai.lt/api/v1/properties/clx..."
POST
/api/v1/properties🔒 Auth

Sukurti naują skelbimą

curl -X POST "https://kvartalai.lt/api/v1/properties" \
  -H "x-api-key: JŪSŲ_RAKTAS" \
  -H "Content-Type: application/json" \
  -d '{"type":"butas","title":"Butas Vilniuje","city":"Vilnius","price":150000}'
GET
/api/v1/crowdfunding

Peržiūrėti crowdfunding projektus

curl "https://kvartalai.lt/api/v1/crowdfunding?status=ACTIVE"
POST
/api/v1/crowdfunding/{id}/invest🔒 Auth

Investuoti į projektą

curl -X POST "https://kvartalai.lt/api/v1/crowdfunding/clx.../invest" \
  -H "x-api-key: JŪSŲ_RAKTAS" \
  -H "Content-Type: application/json" \
  -d '{"amount":1000}'
GET
/api/v1/services

NT paslaugų katalogas

curl "https://kvartalai.lt/api/v1/services"

Limitai ir Klaidos

Rate Limit Headers

X-RateLimit-Remaining: 998
X-RateLimit-Reset: 2026-01-01T00:01:00.000Z

Klaidų Kodai

401Trūksta arba neteisingas API raktas
429Viršytas rate limitas
404Resursas nerastas
400Netinkama užklausa
500Serverio klaida

AI Asistentas