API für externe Verwaltungssysteme

1. Was die APIs ermöglichen

Mit einem API-Schlüssel kannst du von deiner Software aus den Kalender deiner Sportstätten lesen und beschreiben:

• Sportstätten und Spielfelder lesen mit ihren Identifikatoren, die für alle anderen Aufrufe benötigt werden;
• die Buchungen lesen für einen Zeitraum, eine Sportstätte oder ein einzelnes Spielfeld, um sie mit deinem Archiv abzugleichen;
• Buchungen erstellen von extern (zum Beispiel, wenn ein Kunde über deine Website bucht), mit denselben Prüfungen auf Überschneidungen und Sperrungen im Dashboard;
• eine bestehende Buchung ändern oder stornieren (Verschiebung von Uhrzeit oder Spielfeld, Zahlungseingang, Notizen, Stornierung);
• die Verfügbarkeit lesen eines Spielfelds an einem Tag: bereits belegte Slots, Öffnungszeiten und außerordentliche Schließungen, um freie Slots anzubieten, ohne die Regeln replizieren zu müssen;
• die Preisliste eines Spielfelds lesen, um dem Endkunden die Preise anzuzeigen.

Nicht Teil dieser API sind die Anfragen von Organisatoren zur Nutzung von Spielfeldern bei Turnieren (diese werden über die App genehmigt), das Erstellen von Anlagen und Spielfeldern sowie das Speichern von Zeiten, Schließungen und Preislisten: Dies sind Vorgänge im Betreiber-Panel.

2. Voraussetzungen und Aktivierung

1. Ein Spielfeldbetreiber-Konto VolleyFriends mit mindestens einer Anlage und einem Spielfeld.
2. Ein aktives Abonnement mit einem Tarif, der die Funktion „API für externe Verwaltungssysteme“ enthält. Die gesamte v1 — selbst reine Lesezugriffe — ist denjenigen vorbehalten, die diese Funktion haben: Es handelt sich um eine kostenpflichtige Funktion, nicht um ein Zubehör des Panels.
3. Ein im Verwaltungssystem generierter API-Schlüssel: admin.volleyfriends.com → Einstellungen → API-Schlüssel → Neuer Schlüssel.

Der Schlüssel hat das Format vfk_ gefolgt von 40 Hexadezimalzeichen (insgesamt 44 Zeichen) und wird nur ein einziges Mal direkt nach der Erstellung angezeigt: In der Datenbank verbleibt nur sein sha256-Hash, er ist also keinesfalls wiederherstellbar. Wenn du ihn verlierst, widerrufe ihn und generiere einen neuen. In der Liste im Panel siehst du nur das Präfix (z. B. vfk_9f2c), das Erstellungsdatum und das Datum der letzten Verwendung.

3. Authentifizierung

Jede Anfrage muss mit dem Header X-Api-Key authentifiziert werden. Es sind keine Token, Logins, Ablauffristen oder Erneuerungen erforderlich: Der Schlüssel bleibt gültig, bis du ihn widerrufst.

# Die Schlüssel auf dieser Seite sind Beispiele: Ersetze sie durch deine eigenen.
curl -s https://www.volleyfriends.com/api/manager-api/v1/venues   -H "X-Api-Key: vfk_9f2c41a7b83d05e6c19af4728b60d35e1c9a7f42"

In den folgenden Beispielen wird der Schlüssel aus der Umgebungsvariable VF_API_KEY ausgelesen, wie es sich auch in der Produktion empfiehlt.

Fehlender Header, kürzer als 12 Zeichen, unbekannt oder zu einem widerrufenen Schlüssel gehörend: Die Antwort ist 401 mit diesem Body.

{
  "error": "invalid_key",
  "message": "Chiave API mancante o non valida (header X-Api-Key)."
}

4. Basis-URL

https://www.volleyfriends.com/api

Die unten dokumentierten Pfade müssen an die Basis angehängt werden. Das Präfix /api gehört zum Reverse Proxy, daher lautet die vollständige Adresse eines Endpunkts beispielsweise:

GET https://www.volleyfriends.com/api/manager-api/v1/availability

Alle Antworten sind application/json mit UTF-8-Codierung. Anfragen mit Body (POST, PATCH) müssen Content-Type: application/json enthalten.

5. Rate Limiting

Das Limit liegt bei 120 Anfragen pro Minute pro API-Schlüssel (gleitendes Fenster von 1 Minute). Die Zählung erfolgt pro Schlüssel, nicht pro IP-Adresse: Die Verwaltungssysteme befinden sich oft hinter derselben Provider-Adresse, und ein Limit pro IP würde verschiedene Betreiber, die auf derselben Infrastruktur gehostet werden, benachteiligen. Wenn der Header X-Api-Key vollständig fehlt, fällt die Zählung auf die IP-Adresse zurück.

Jede Antwort enthält den Status des Zählers in den Headern x-ratelimit-limit, x-ratelimit-remaining und x-ratelimit-reset (Sekunden bis zum Reset). Bei Überschreitung wird auch retry-after hinzugefügt.

Antwort bei Überschreitung — 429

{
  "error": "rate_limited",
  "message": "Limite di 120 richieste al minuto superato per questa chiave API."
}

6. Endpunkte

Sechs Endpunkte, alle unter /manager-api/v1. Jeder Aufruf durchläuft dieselbe Kette von Prüfungen in dieser Reihenfolge: gültiger API-Schlüssel → Funktion „API für externe Verwaltungssysteme“ im Paket enthalten → Rate Limit → Validierung der Parameter → Überprüfung, ob die Ressource dir gehört.

6.1 Sportstätten und Spielfelder

Listet deine Sportstätten auf, jede mit ihren eigenen verschachtelten Spielfeldern. Dies ist der Ausgangspunkt: Die ids der Spielfelder (courtId) werden für alle anderen Endpunkte benötigt. Die Sportstätten sind nach Namen sortiert, die Spielfelder nach Namen.

Parameter

Keine.

Beispiel für eine Anfrage

curl -s https://www.volleyfriends.com/api/manager-api/v1/venues   -H "X-Api-Key: $VF_API_KEY"

Beispiel für eine Antwort — 200

{
  "venues": [
    {
      "id": "b3f8e5c1-2d47-4a90-8f31-6c0d9a7e4512",
      "name": "Centro Sportivo Aurora",
      "city": "Verona",
      "address": "Via delle Palestre 12",
      "verified": true,
      "courts": [
        {
          "id": "7c94a0d2-58b1-4e6f-9a3c-1d20f8b47e05",
          "venueId": "b3f8e5c1-2d47-4a90-8f31-6c0d9a7e4512",
          "name": "Campo 1",
          "surface": "parquet",
          "indoor": true,
          "lighting": true
        },
        {
          "id": "e2a71f64-9c03-4bd8-b512-38f6cd90a7e1",
          "venueId": "b3f8e5c1-2d47-4a90-8f31-6c0d9a7e4512",
          "name": "Campo 2 beach",
          "surface": "sabbia",
          "indoor": false,
          "lighting": true
        }
      ]
    }
  ]
}

Antwortfelder

Wenn das Konto noch keine Anlagen hat, lautet die Antwort {"venues": []}.

Spezifische Fehler

Keine außer den allgemeinen.

6.2 Buchungsliste

Gibt die Buchungen deiner Anlagen zurück, sortiert nach aufsteigender Startzeit. Die Liste ist paginiert: maximal limit Zeilen pro Aufruf (Standard 500, Obergrenze 1000) — wenn du genau limit Zeilen erhältst, rufe sie erneut mit erhöhtem offset für die nächste Seite auf. Filtere in der Produktionsumgebung dennoch immer mindestens nach Datumsbereich.

Parameter (Query-String)

Beispiel für eine Anfrage

curl -s -G https://www.volleyfriends.com/api/manager-api/v1/bookings   -H "X-Api-Key: $VF_API_KEY"   --data-urlencode "courtId=7c94a0d2-58b1-4e6f-9a3c-1d20f8b47e05"   --data-urlencode "from=2026-08-01"   --data-urlencode "to=2026-08-31"

Beispiel für eine Antwort — 200

{
  "bookings": [
    {
      "id": "9d51c7b4-0e28-4f3a-a6d9-72b48e105c3f",
      "venueId": "b3f8e5c1-2d47-4a90-8f31-6c0d9a7e4512",
      "courtId": "7c94a0d2-58b1-4e6f-9a3c-1d20f8b47e05",
      "courtName": "Campo 1",
      "startsAt": "2026-08-12T16:00:00.000Z",
      "endsAt": "2026-08-12T17:30:00.000Z",
      "customerName": "Marta Bellini",
      "customerPhone": "+39 340 1122334",
      "customerEmail": "marta.bellini@example.com",
      "priceCents": 3000,
      "playersCount": null,
      "status": "confirmed",
      "paymentMethod": null,
      "paymentLink": null,
      "notes": "Prenotato dal sito della struttura",
      "source": "api",
      "recurrenceId": null,
      "createdAt": "2026-07-28T09:14:02.517Z",
      "updatedAt": "2026-07-28T09:14:02.517Z"
    }
  ],
  "limit": 500,
  "offset": 0
}

Felder einer Buchung

Die gleiche Struktur wird von POST und PATCH zurückgegeben (innerhalb des Schlüssels booking).

Spezifische Fehler

6.3 Neue Buchung

Erstellt eine Buchung auf einem deiner Spielfelder. Die Buchung wird mit source: "api" erstellt, damit sie im Dashboard von den manuell eingegebenen unterschieden werden kann, und der Betreiber erhält eine Push-Benachrichtigung „Neue Buchung“ in der App.

Es gelten dieselben Regeln wie im Dashboard, in dieser Reihenfolge:

1. Außerordentliche Schließung der Anlage am Startdatum → 409 venue_closed;
2. Überschneidung mit einer anderen, nicht stornierten Buchung desselben Spielfelds → 409 overlap;
3. Preis fehlt → wird aus der Preisliste des Spielfelds berechnet (null, wenn die Startzeit in kein Zeitfenster fällt). Wenn das Zeitfenster einen Preis pro Person hat, wird auch playersCount benötigt: Ohne diesen wird die Anfrage mit 400 players_required abgelehnt (es sei denn, es wird ein expliziter priceCents angegeben).

Die Öffnungszeiten blockieren nicht die Erstellung: Sie dienen der Information, der Betreiber bleibt souverän auf seinem eigenen Spielfeld. Wenn du Buchungen außerhalb der Öffnungszeiten verhindern willst, überprüfe selbst hours, das von /availability zurückgegeben wird, bevor du die POST aufrufst.

Anfrage-Body (JSON)

Beispiel für eine Anfrage

curl -s -X POST https://www.volleyfriends.com/api/manager-api/v1/bookings   -H "X-Api-Key: $VF_API_KEY"   -H "Content-Type: application/json"   -d '{
    "courtId": "7c94a0d2-58b1-4e6f-9a3c-1d20f8b47e05",
    "startsAt": "2026-08-12T18:00:00+02:00",
    "endsAt": "2026-08-12T19:30:00+02:00",
    "customerName": "Marta Bellini",
    "customerPhone": "+39 340 1122334",
    "customerEmail": "marta.bellini@example.com",
    "notes": "Prenotato dal sito della struttura"
  }'

Antwortbeispiel — 201

{
  "booking": {
    "id": "9d51c7b4-0e28-4f3a-a6d9-72b48e105c3f",
    "venueId": "b3f8e5c1-2d47-4a90-8f31-6c0d9a7e4512",
    "courtId": "7c94a0d2-58b1-4e6f-9a3c-1d20f8b47e05",
    "courtName": "Campo 1",
    "startsAt": "2026-08-12T16:00:00.000Z",
    "endsAt": "2026-08-12T17:30:00.000Z",
    "customerName": "Marta Bellini",
    "customerPhone": "+39 340 1122334",
    "customerEmail": "marta.bellini@example.com",
    "priceCents": 3000,
    "playersCount": null,
    "status": "confirmed",
    "paymentMethod": null,
    "paymentLink": null,
    "notes": "Prenotato dal sito della struttura",
    "source": "api",
    "recurrenceId": null,
    "createdAt": "2026-07-28T09:14:02.517Z",
    "updatedAt": "2026-07-28T09:14:02.517Z"
  }
}

Im Beispiel wurde priceCents nicht angegeben: 90 Minuten in einem Zeitraum von 20,00 €/Std. ergeben 3000 Cent (die Berechnung erfolgt proportional zu den tatsächlichen Minuten mit dem Tarif des Zeitraums, in dem die Buchung beginnt).

Spezifische Fehler

// 409 — Überschneidung
{ "error": "overlap", "message": "Il campo è già prenotato in quell'orario." }

// 409 — außerordentliche Schließung (der Grund, falls vom Betreiber angegeben, steht in der Nachricht)
{ "error": "venue_closed", "message": "Struttura chiusa in quella data (manutenzione)." }

6.4 Buchung bearbeiten

Aktualisiert eine bestehende Buchung. Es handelt sich um eine partielle Aktualisierung: Sende nur die Felder, die sich ändern, die anderen bleiben unverändert. Der Body muss mindestens ein Feld enthalten.

Es gibt keinen Endpunkt zum Löschen: Um eine Buchung zu stornieren, wird status: "cancelled" gesetzt. Der Verlauf bleibt im Dashboard erhalten und der Slot wird wieder frei (stornierte Buchungen belegen das Spielfeld nicht und erzeugen kein overlap).

Pfadparameter

Anfrage-Body (JSON)

Alle Felder sind optional. Die als „aufhebbar“ markierten Felder akzeptieren null, um den Wert zu leeren.

Beispiel für eine Anfrage — Verschiebung und Einnahmen

curl -s -X PATCH   https://www.volleyfriends.com/api/manager-api/v1/bookings/9d51c7b4-0e28-4f3a-a6d9-72b48e105c3f   -H "X-Api-Key: $VF_API_KEY"   -H "Content-Type: application/json"   -d '{
    "startsAt": "2026-08-12T19:00:00+02:00",
    "endsAt": "2026-08-12T20:30:00+02:00",
    "status": "paid",
    "paymentMethod": "cash",
    "priceCents": 3000
  }'

Beispiel für eine Anfrage — Stornierung

curl -s -X PATCH   https://www.volleyfriends.com/api/manager-api/v1/bookings/9d51c7b4-0e28-4f3a-a6d9-72b48e105c3f   -H "X-Api-Key: $VF_API_KEY"   -H "Content-Type: application/json"   -d '{ "status": "cancelled" }'

Beispiel für eine Antwort — 200

Die aktualisierte Buchung im gleichen Format wie der POST:

{
  "booking": {
    "id": "9d51c7b4-0e28-4f3a-a6d9-72b48e105c3f",
    "venueId": "b3f8e5c1-2d47-4a90-8f31-6c0d9a7e4512",
    "courtId": "7c94a0d2-58b1-4e6f-9a3c-1d20f8b47e05",
    "courtName": "Campo 1",
    "startsAt": "2026-08-12T17:00:00.000Z",
    "endsAt": "2026-08-12T18:30:00.000Z",
    "customerName": "Marta Bellini",
    "customerPhone": "+39 340 1122334",
    "customerEmail": "marta.bellini@example.com",
    "priceCents": 3000,
    "playersCount": null,
    "status": "paid",
    "paymentMethod": "cash",
    "paymentLink": null,
    "notes": "Prenotato dal sito della struttura",
    "source": "api",
    "recurrenceId": null,
    "createdAt": "2026-07-28T09:14:02.517Z",
    "updatedAt": "2026-07-28T11:02:47.883Z"
  }
}

Spezifische Fehler

6.5 Verfügbarkeit eines Spielfelds an einem Tag

Gibt für ein Spielfeld und einen Tag die belegten Slots, die Öffnungszeiten dieses Wochentags und eine eventuelle außerordentliche Schließung zurück. Dies ist der Endpunkt, der verwendet werden sollte, um freie Slots auf einer externen Website zu berechnen, ohne die Regeln des Verwaltungssystems zu duplizieren: Ziehe die Buchungen vom Öffnungsfenster ab.

Es werden alle Slots aufgelistet, die das Spielfeld belegen, in jedem Status außer cancelled: also auch noch pending Online-Buchungsanfragen. Der Tag ist der lokale italienische Tag und die Intervalle sind halboffen: Eine Buchung, die genau um Mitternacht endet, gehört zum Vortag. Eine Buchung über Mitternacht hinweg erscheint an beiden Tagen, die sie schneidet, mit ihren tatsächlichen Zeitpunkten (die außerhalb des angeforderten Tages liegen können).

Parameter (Query-String)

Beispiel für eine Anfrage

curl -s -G https://www.volleyfriends.com/api/manager-api/v1/availability   -H "X-Api-Key: $VF_API_KEY"   --data-urlencode "courtId=7c94a0d2-58b1-4e6f-9a3c-1d20f8b47e05"   --data-urlencode "date=2026-08-12"

Beispiel für eine Antwort — 200

{
  "courtId": "7c94a0d2-58b1-4e6f-9a3c-1d20f8b47e05",
  "venueId": "b3f8e5c1-2d47-4a90-8f31-6c0d9a7e4512",
  "date": "2026-08-12",
  "timezone": "Europe/Rome",
  "hours": {
    "weekday": 2,
    "openMinute": 540,
    "closeMinute": 1380,
    "closed": false,
    "configured": true
  },
  "closure": null,
  "bookings": [
    {
      "startsAt": "2026-08-12T16:00:00.000Z",
      "endsAt": "2026-08-12T17:30:00.000Z",
      "status": "confirmed"
    },
    {
      "startsAt": "2026-08-12T18:00:00.000Z",
      "endsAt": "2026-08-12T19:00:00.000Z",
      "status": "paid"
    },
    {
      "startsAt": "2026-08-12T19:00:00.000Z",
      "endsAt": "2026-08-12T20:30:00.000Z",
      "status": "pending"
    }
  ]
}

Antwortfelder

Spezifische Fehler

6.6 Preisliste eines Spielfelds

Die Preisliste des Spielfelds in schreibgeschützter Form: Sie dient dazu, dem Kunden vor der Buchung die Preise anzuzeigen, mit denselben Zeitfenstern, die das Verwaltungssystem zur automatischen Preisberechnung verwendet. Die Zeitfenster können nur über das Panel geändert werden. Sie sind nach aufsteigendem fromMinute sortiert.

Parameter (Query-String)

Beispiel für eine Anfrage

curl -s -G https://www.volleyfriends.com/api/manager-api/v1/rates   -H "X-Api-Key: $VF_API_KEY"   --data-urlencode "courtId=7c94a0d2-58b1-4e6f-9a3c-1d20f8b47e05"

Beispiel für eine Antwort — 200

{
  "courtId": "7c94a0d2-58b1-4e6f-9a3c-1d20f8b47e05",
  "rates": [
    {
      "id": "4a1e0b72-6d35-4c81-93af-0b7e2d5814c6",
      "label": "Mattina infrasettimanale",
      "daysMask": 31,
      "fromMinute": 480,
      "toMinute": 840,
      "pricePerHourCents": 1500,
      "pricingMode": "court",
      "minPlayers": null
    },
    {
      "id": "c07d9b31-8f42-4a05-b6e9-15d3c8017a2b",
      "label": "Serale",
      "daysMask": 127,
      "fromMinute": 1080,
      "toMinute": 1380,
      "pricePerHourCents": 600,
      "pricingMode": "person",
      "minPlayers": 10
    }
  ]
}

Antwortfelder

Spezifische Fehler

Ein Spielfeld ohne Preisliste antwortet mit 200 und "rates": [].

7. Datenkonventionen

7.1 Daten und Uhrzeiten

• Als Eingabe sind die Zeitpunkte ISO 8601-Strings mit obligatorischem Offset: 2026-08-12T18:00:00+02:00 oder 2026-08-12T18:00:00Z. Ein String ohne Offset (2026-08-12T18:00:00) wird mit 400 abgelehnt: Er wäre mehrdeutig, und für einen Kalender ist das eine Mehrdeutigkeit, die man mit um eine Stunde falschen Buchungen bezahlt.
• Als Ausgabe sind die Zeitpunkte immer in UTC mit dem Suffix Z und Millisekunden normalisiert: "2026-08-12T16:00:00.000Z". Konvertiere sie vor der Anzeige in die lokale Zeitzone.
• Die reinen Datumsangaben (date, closure.from, closure.to und from/to, wenn du sie in Form eines Tages verwendest) sind AAAA-MM-GG und beziehen sich auf den lokalen italienischen Tag.
• Die Intervalle sind halboffen [inizio, fine): 18:00–19:00 und 19:00–20:00 stehen nicht im Konflikt.

7.2 Zeitzone

Buchungen werden als absolute Zeitpunkte gespeichert, aber alle Kalenderregeln — Wochentag, Tarife der Preisliste, Öffnungszeiten, Schließungsdaten, Tagesgrenzen — werden in der Zeitzone Europe/Rome ausgewertet, wobei die Sommerzeit automatisch verwaltet wird. Das Feld timezone der Antwort von /availability deklariert dies explizit. Wenn dein Server in UTC oder einer anderen Zeitzone läuft, konvertiere die Minuten nicht manuell: Sie sind bereits in der lokalen italienischen Zeit ausgedrückt.

7.3 Minuten ab Mitternacht

Die Uhrzeiten „laut Kalender“ (openMinute, closeMinute, fromMinute, toMinute) sind ganze Zahlen von 0 bis 1440, die die Minuten ab der lokalen Mitternacht zählen. Umrechnungen: ore = ⌊m / 60⌋, minuti = m mod 60.

7.4 Beträge

Alle Beträge sind ganze Zahlen in Euro-Cent (priceCents, pricePerHourCents): kein Gleitkommawert, kein Währungssymbol. 2000 = 20,00 €. Bei einer Buchung bedeutet priceCents: null „Preis noch zu definieren“ und unterscheidet sich von 0, was „kostenlos“ bedeutet.

7.5 Status einer Buchung

7.6 Herkunft und Zahlungsmethode

Beide sind Textdomänen: Neue Werte können in Zukunft hinzugefügt werden, ohne die Version zu ändern, daher darf dein Code bei einem unbekannten Wert keinen Fehler verursachen.

7.7 Personenbezogene Daten der Kunden

Name, Telefonnummer und E-Mail-Adresse, die du bei den Buchungen übermittelst, sind personenbezogene Daten deiner Kunden: Du bist der Verantwortliche für die Datenverarbeitung, VolleyFriends speichert sie in deinem Auftrag als Auftragsverarbeiter gemäß Art. 28 GDPR. Sende nur das, was für die Verwaltung des Platzes erforderlich ist, und informiere deine Kunden. Details findest du in der Datenschutzerklärung.

8. Allgemeine Fehler

Jeder Fehler hat denselben Aufbau: einen stabilen Code in error, der für deinen Code gedacht ist, und eine message auf Italienisch, die für Menschen gedacht ist. Triff deine Entscheidungen basierend auf error und dem HTTP-Status, nicht auf dem Text der Nachricht, der sich ändern kann.

{
  "error": "overlap",
  "message": "Il campo è già prenotato in quell'orario."
}

Validierungsfehler fügen issues hinzu, die detaillierte Liste der Probleme Feld für Feld:

{
  "error": "invalid_input",
  "message": "Dati non validi",
  "issues": [
    {
      "code": "invalid_string",
      "validation": "datetime",
      "path": ["startsAt"],
      "message": "Invalid datetime"
    }
  ]
}

Ein nicht existierender Pfad unter der Basis antwortet mit 404; das Gleiche gilt für eine nicht vorgesehene Methode auf einem existierenden Pfad:

{
  "error": "not_found",
  "message": "Risorsa non trovata"
}

Die Antworten 502, 503 und 504 kommen vom Reverse Proxy, wenn die API nicht erreichbar ist (Neustart oder Wartung): In diesen Fällen ist der Body nicht garantiert im JSON-Format. Behandle sie als temporäre Fehler und versuche es mit Backoff erneut, ohne zu versuchen, deren Inhalt zu lesen.

9. Versionen und Kompatibilität

Die Version befindet sich im Pfad: /manager-api/v1. Es müssen keine Versions-Header oder Release-Daten angegeben werden: Die einzige derzeit veröffentlichte Version ist v1.

Was wir ohne Vorankündigung ändern können

• Felder hinzufügen zu bestehenden Antworten.
• Optionale Parameter hinzufügen zu Anfragen, mit einem Standardwert, der das aktuelle Verhalten beibehält.
• Neue Endpoints hinzufügen unter /v1.
• Werte hinzufügen zu offenen Textfeldern (source, paymentMethod, surface).
• Die message umformulieren bei Fehlern, während die error-Codes unverändert bleiben.

Was sich innerhalb von v1 nicht ändert

• Kein Feld wird aus den Antworten entfernt oder umbenannt.
• Kein Feld wird seinen Typ oder seine Bedeutung ändern.
• Kein derzeit optionaler Parameter wird zu einem Pflichtparameter.
• Die hier dokumentierten error-Codes und HTTP-Status bleiben unverändert.

Jede Änderung, die diese Garantien verletzt, wird unter einem neuen Präfix (/v2) eingeführt, wobei v1 in Betrieb bleibt und die betroffenen Betreiber vorab benachrichtigt werden.

Changelog

10. Unterstützung bei der Integration

Bei technischen Fragen, unerwartetem Verhalten oder Anfragen zu Endpunkten, die du hier nicht findest, schreibe uns über die Seite Kontakt. Um direkt zum Punkt zu kommen, gib in der Nachricht Folgendes an:

• Endpoint und Methode, die du aufrufst;
• Datum und Uhrzeit des Aufrufs (mit Zeitzone) und den erhaltenen HTTP-Code;
• Code error und Antwortnachricht;
• Präfix des verwendeten Schlüssels (z. B. vfk_9f2c).

Wenn du die Integration testen möchtest, ohne den echten Kalender zu beeinflussen, erstelle eine Testanlage mit einem eigenen Spielfeld und verwende diese: Alle Aufrufe sind auf die Anlagen des Schlüsselbesitzers beschränkt, sodass der Rest deines Kontos nicht betroffen ist.