Dokumentáció

API-dokumentáció

Építse be a SkyGIS-t a munkafolyamataiba RESTful API-nk segítségével. Automatizálja a feltöltéseket, kezelje a projekteket, és nyerjen ki adatokat programból.

Hitelesítés

Minden API-kéréshez Bearer token szükséges. API-kulcsot a fiókbeállítások Developer → API Keys menüpontjában hozhat létre.

curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.skygis.io/v1/projects

Kéréskorlátok: Ingyenes csomag: 100 kérés/óra. Core: 1 000/óra. Plus: 10 000/óra. Enterprise: egyedi korlátok.

Projektek

Projektek listázása

GET /v1/projects

Response:
{
  "data": [
    {
      "id": "proj_abc123",
      "name": "Highway Survey Q1",
      "created_at": "2025-01-15T10:30:00Z",
      "storage_bytes": 5368709120,
      "status": "active"
    }
  ],
  "meta": { "total": 12, "page": 1 }
}

Projekt létrehozása

POST /v1/projects
Content-Type: application/json

{
  "name": "Bridge Inspection 2025",
  "description": "Quarterly scan of Main St bridge",
  "crs": "EPSG:32632",
  "tags": ["bridge", "infrastructure"]
}

Projekt törlése

DELETE /v1/projects/:project_id

Véglegesen törli a projektet és a hozzá tartozó összes adatot. A művelet nem vonható vissza.

Feltöltések

Fájl feltöltése

POST /v1/projects/:project_id/uploads
Content-Type: multipart/form-data

file: <binary>
format: "e57"    // optional, auto-detected
crs: "EPSG:4326" // optional, from file metadata

Feltöltési azonosítót ad vissza, amellyel követhető a feldolgozás állapota. A nagy fájlok automatikusan darabokban töltődnek fel.

Feldolgozási állapot lekérdezése

GET /v1/uploads/:upload_id

Response:
{
  "id": "upl_xyz789",
  "status": "processing", // queued | processing | ready | failed
  "progress": 0.65,
  "points_processed": 142000000,
  "estimated_completion": "2025-01-15T10:45:00Z"
}

Mérések

Mérés létrehozása

POST /v1/projects/:project_id/measurements
Content-Type: application/json

{
  "type": "distance",
  "points": [
    { "x": 548234.12, "y": 5765432.89, "z": 312.45 },
    { "x": 548267.34, "y": 5765445.12, "z": 314.22 }
  ]
}

Response:
{
  "id": "meas_001",
  "type": "distance",
  "result": { "value": 35.28, "unit": "meters" }
}

Megosztás

Megosztási link létrehozása

POST /v1/projects/:project_id/shares
Content-Type: application/json

{
  "permissions": ["view", "measure"],
  "expires_at": "2025-06-01T00:00:00Z",
  "password": "optional-password"
}

Webhookok

Iratkozzon fel eseményekre, és valós idejű értesítést kap, ha befejeződik a feldolgozás, ha megosztanak egy projektet, vagy ha a tárhely elér egy küszöbértéket.

POST /v1/webhooks
Content-Type: application/json

{
  "url": "https://your-app.com/webhooks/skygis",
  "events": ["upload.ready", "upload.failed", "project.shared"]
}

SDK-k és könyvtárak

Python - pip install skygis
JavaScript/TypeScript - npm install @skygis/sdk
CLI - brew install skygis-cli