Alle Ressourcen
    Dokumentation

    API-Dokumentation

    Binden Sie SkyGIS über unsere REST-API in Ihre Workflows ein. Automatisieren Sie Uploads, verwalten Sie Projekte und rufen Sie Daten programmgesteuert ab.

    Authentifizierung

    Jede API-Anfrage benötigt ein Bearer-Token. API-Schlüssel erzeugen Sie in Ihren Kontoeinstellungen unter Developer → API Keys.

    curl -H "Authorization: Bearer YOUR_API_KEY" \
     https://api.skygis.io/v1/projects
    Rate-Limits: Kostenloser Tarif: 100 Anfragen/Stunde. Core: 1.000/Stunde. Plus: 10.000/Stunde. Enterprise: individuelle Limits.

    Projekte

    Projekte auflisten

    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 anlegen

    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 löschen

    DELETE /v1/projects/:project_id

    Löscht ein Projekt mit allen zugehörigen Daten endgültig. Diese Aktion kann nicht rückgängig gemacht werden.

    Uploads

    Datei hochladen

    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

    Gibt eine Upload-ID zurück, mit der Sie den Verarbeitungsstatus verfolgen können. Große Dateien werden automatisch in Teilen hochgeladen.

    Verarbeitungsstatus abfragen

    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"
}

    Messungen

    Messung anlegen

    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" }
}

    Freigabe

    Freigabelink erstellen

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

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

    Webhooks

    Abonnieren Sie Ereignisse und werden Sie in Echtzeit benachrichtigt, wenn eine Verarbeitung abgeschlossen ist, Projekte freigegeben oder Speichergrenzwerte erreicht werden.

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

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

    SDKs und Bibliotheken

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