API-Referenz

Vollständige API-Dokumentation für die Visiono REST API.

API-Dokumentation

Vollständige API-Dokumentation

Interaktive API-Dokumentation mit Beispielen, Anfrage-/Antwort-Schemata und Test-Tools.

API-Dokumentation öffnen →

Schnelllinks

Ressource	Beschreibung
API-Dokumentation	Vollständige interaktive API-Referenz
API-Schlüssel	API-Schlüssel erstellen und verwalten
Webhooks	Ereignisbenachrichtigungen einrichten

API-Überblick

Basis-URL

https://api.visio.now/v1

Authentifizierung

Alle API-Anfragen erfordern Authentifizierung per API-Schlüssel:

curl -X GET "https://api.visio.now/v1/status" \
  -H "X-API-Key: ihr-api-schluessel"

Antwortformat

Alle Antworten sind JSON:

{
  "data": { ... },
  "meta": {
    "request_id": "req_abc123"
  }
}

Verfügbare Endpunkte

Fotoanfragen

Methode	Endpunkt	Beschreibung
GET	/photo-requests	Alle Fotoanfragen auflisten
POST	/photo-requests	Neue Fotoanfrage erstellen *
GET	/photo-requests/{id}	Bestimmte Anfrage abrufen
DELETE	/photo-requests/{id}	Anfrage löschen

* Free-Plan-Benutzer können die Parameter recipient_email oder send_email nicht verwenden. Siehe Free-Plan Einschränkungen.

Statistiken

Methode	Endpunkt	Beschreibung
GET	/stats	Nutzungsstatistiken und Plan-Info abrufen

Permanente Links

Methode	Endpunkt	Beschreibung
GET	/permanent-links	Alle Permanenten Links auflisten
POST	/permanent-links	Neuen Permanenten Link erstellen
GET	/permanent-links/{id}	Bestimmten Permanenten Link abrufen
PATCH	/permanent-links/{id}	Permanenten Link aktualisieren
DELETE	/permanent-links/{id}	Permanenten Link löschen

Status

Methode	Endpunkt	Beschreibung
GET	/status	API-Gesundheitsprüfung

Fehlerantworten

Fehlerformat

{
  "error": {
    "code": "validation_error",
    "message": "Die angegebenen Daten waren ungültig.",
    "details": {
      "instructions": ["Das Anweisungsfeld ist erforderlich."]
    }
  }
}

Häufige Statuscodes

Code	Beschreibung
200	Erfolg
201	Erstellt
400	Fehlerhafte Anfrage
401	Nicht autorisiert
403	Verboten
404	Nicht gefunden
422	Validierungsfehler
429	Rate-Limit überschritten
500	Serverfehler

Rate-Limits

Limit	Wert
Anfragen pro Minute	60
Anfragen pro Stunde	1.000

Rate-Limit-Header:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 45
X-RateLimit-Reset: 1609459200

SDKs und Bibliotheken

Derzeit ist die API REST-basiert. Offizielle SDKs kommen bald.

Community-Tools

Für Automatisierung, erwägen Sie:

• Zapier-Integration
• Make-Integration
• n8n-Integration

Free-Plan Einschränkungen

Der Developer Free Plan hat spezifische API-Einschränkungen:

E-Mail-Parameter verboten

Free-Plan-Benutzer erhalten 422-Fehler bei Verwendung von:

• recipient_email - E-Mail-Adressparameter
• send_email - Boolean-Flag zum Versenden von E-Mails

API-Fehlerantwort:

{
  "message": "The recipient email field is prohibited.",
  "errors": {
    "recipient_email": [
      "Email features are not available on the free plan. Upgrade to send photo requests via email."
    ]
  }
}

Workaround: Verwenden Sie die request_url aus erfolgreichen Antworten, um Links über andere Kanäle zu teilen (SMS, Chat, etc.).

Unterschiede bei Stats-Antwort

Free-Plan GET /stats Antworten enthalten:

• plan.email_enabled: false
• usage.is_lifetime_quota: true (100 Fotos insgesamt, nicht monatlich)
• usage.billing_period_start: null
• usage.billing_period_end: null

Siehe detaillierte Free-Plan-Dokumentation

Support

Brauchen Sie Hilfe mit der API?

• Prüfen Sie die vollständige API-Dokumentation
• Überprüfen Sie die API-Schlüssel-Einrichtung
• Konfigurieren Sie Webhooks für Echtzeit-Updates
• Kontaktieren Sie Support für Enterprise-Anforderungen

Verwandte Seiten

• API-Schlüssel - Authentifizierungs-Setup
• Webhooks - Ereignisbenachrichtigungen
• Integrationen - No-Code-Integrationen
• Nutzungslimits - Free-Plan Details