#Nutzungsregeln

Die Schnittstelle verbindet Ihr System mit dem Betrieb von LOGICAR: jeder Aufruf mit einem Live-Schlüssel kann eine Fahrt auslösen. Diese Regeln halten das für alle Beteiligten verlässlich. Vertraglich maßgeblich sind die AGB für Auftraggeber und Ihre Vereinbarung mit uns; diese Seite erklärt, was das für die Anbindung heißt.

#Zweck

• Die Schnittstelle dient dazu, Aufträge Ihres Unternehmens einzustellen und zu verfolgen.
• Aufträge über einen Live-Schlüssel sind verbindlich — wie ein im Portal angelegter Auftrag. Zum Ausprobieren gibt es die Sandbox; Testaufträge im Echtbetrieb bitte nicht.
• Ein Zugang gehört zu einem Konto. Wer für mehrere Unternehmen arbeitet (etwa ein Dienstleister), nutzt je Unternehmen dessen Zugang.

#Sicherheit

• Schlüssel und Webhook-Geheimnisse gehören auf den Server, in einen Secret-Store — nie in Browser, App oder Repository (Anmeldung).
• Jede Webhook-Nachricht wird vor der Verarbeitung geprüft.
• Webhook-Adressen zeigen auf Systeme, die Sie selbst betreiben oder beauftragt haben.
• Ist ein Schlüssel oder Geheimnis nach außen gelangt: sofort zurückziehen bzw. erneuern und uns informieren.
• Sicherheitslücke gefunden? Bitte vertraulich an uns melden (Kontakt), nicht öffentlich. Wir antworten und halten Sie über die Behebung auf dem Laufenden.

#Last

• Die Drossel gilt je Zugang. Verteilen Sie Aufrufe gleichmäßig, statt sie gesammelt zu schicken, und halten Sie sich an Retry-After.
• Abfragen ersetzen keine Webhooks: den Stand eines Auftrags in kurzen Abständen zu erfragen belastet beide Seiten und ist langsamer.
• Last- und Sicherheitstests gegen die Schnittstelle — auch gegen die Sandbox — nur nach Absprache.

#Datenschutz

• Nur Nötiges übertragen. Namen und Telefonnummern von Ansprechpartnern gehören in einen Auftrag, wenn dort abgeholt oder übergeben wird. Weitere personenbezogene Daten nicht.
• endCustomerEmail nur mitschicken, wenn der Empfänger über die Überführung informiert werden soll — er bekommt dann E-Mails von uns.
• Auch in die Sandbox gehören keine echten personenbezogenen Daten. Nehmen Sie Beispieldaten.
• Webhooks enthalten nur, was Sie als Auftraggeber brauchen; Einkaufspreise und Daten von Fahrern gehören nicht dazu.
• Es gilt unsere Datenschutzerklärung.

#Wenn etwas schiefgeht

Bei Missbrauch oder einem Sicherheitsrisiko — etwa einem Schlüssel, der offensichtlich in fremden Händen ist, oder einem Endpunkt, der fremde Systeme belastet — sperren wir den Schlüssel oder pausieren den Endpunkt und melden uns bei Ihnen. Der Normalfall ist das nicht: bei Fehlern in Ihrer Anbindung helfen wir, statt zu sperren.