vFound StartseiteKostenlose Testphase anfragen
ENTWICKLER

Die vFound API und Webhooks

Verbinden Sie die vFound Suite mit den Systemen, die Sie bereits betreiben: Immobilienverwaltung, Service Desks, Personal- und Studierendensysteme, Scanner im Postraum, Data Warehouses oder Ihre eigenen Apps. Lesen und ändern Sie Datensätze in jedem Produkt, halten Sie Ihre Personenliste synchron, erhalten Sie innerhalb von Sekunden einen signierten Webhook, wenn etwas passiert, und lassen Sie KI-Assistenten am Empfang helfen.

Sie möchten eine geführte Einrichtung? Die vFound Integrationsanleitungen gibt es für Cloudbeds, OfficeRnD Flex, Microsoft Entra, Slack, Microsoft Teams, Google Chat, Kalender, Zapier und MCP-Clients.

Authentifizierung

Jeder Standort hat die API. Ein Inhaber oder Manager erstellt unter Einstellungen, Für Entwickler bis zu 10 Schlüssel und legt fest, was jeder Schlüssel darf. Der vollständige Schlüssel wird nur einmal angezeigt. Senden Sie ihn als Bearer-Token:

curl https://vfound.io/api/v1/items \
  -H "Authorization: Bearer vf_live_xxxxxxxxxx_…"
ScopeErlaubtEndpunkte
items:readFundsachen, Kategorien und Wechsel zwischen Standorten lesenGET /items, /items/{id}, /categories, /item-transfers
items:writeFundsachen hinzufügen und aktualisieren sowie zwischen Standorten senden oder empfangenPOST /items, PATCH /items/{id}, POST /item-transfers und dessen Abbruch und Empfang
claims:writePrüfungen der Eigentümerschaft durch Personen, Entscheidungen, Freigabe der Herausgabe und Abholung erfassenPOST /claims/{id}/verification, /claims/{id}/decision, /claims/{id}/release-approval, /claims/{id}/handover
lost_reports:writeVerlustmeldungen von Gästen für ein Kontaktcenter erstellenPOST /lost-reports
claims:readRückgabeanfragen lesen, mit den Kontaktdaten der anfragenden PersonGET /claims, /claims/{id}
lost_reports:readVerlustmeldungen von Gästen lesenGET /lost-reports
analytics:readDie Analysenübersicht lesenGET /analytics
parcels:readPakete lesen, mit Name und E-Mail-Adresse der jeweiligen empfangenden PersonGET /parcels, /parcels/{id}
parcels:writeErfassen, übergeben, zurückgeben und erinnernPOST /parcels und dessen Aktionen
checkroom:readTickets, Stationen, Veranstaltungen, die Ausgabeschlange und Berichte lesenGET unter /checkroom
checkroom:writeAbgaben erfassen, zurückgeben, als bereit markieren und Stationen oder Veranstaltungen verwaltenPOST und PUT unter /checkroom
loans:readGeräte lesen und wer sie hatGET /loans, /loans/items und jeweils ein einzelner Eintrag
loans:writeGeräte hinzufügen, ausgeben, verlängern und zurücknehmenPOST und PATCH unter /loans
visitors:readBesuche lesenGET /visitors, /visitors/{id}
visitors:writeEinladen, an- und abmelden, stornieren, einen Pass sendenPOST /visitors und dessen Aktionen
visitors:screeningBestätigen, dass der Treffer einer Besucherprüfung kontrolliert wurde: screening_reviewed senden oder einen Besuch freigeben, den ein Treffer zurückhält. Standardmäßig aus; was der Schlüssel tut, wird als Handlung des Schlüssels mit seinem Namen aufgezeichnetPOST /visitors, /visitors/{id}/sign-in, /visitors/{id}/approve
people:readDie Personenliste lesenGET /people, /people/{id}
people:writePersonen hinzufügen, aktualisieren, synchronisieren und entfernenPOST, PATCH und DELETE unter /people
stays:readPrivaten Kontext zu Hotelaufenthalten und dessen Korrekturverlauf lesenGET /stays, /stays/{stay}
stays:writeKontext zu Aufenthalten aus einem Hotelsystem idempotent hinzufügen oder aktualisierenPOST /stays
school:readVerspätetes Kommen und frühes Gehen von Schülern aus dem Schulsekretariat lesenGET /school/movements
school:writeSchüler aus dem Schulverwaltungssystem hinzufügen oder aktualisierenPUT /school/pupils
queue:readWarteschlangen, Tickets, gebuchte Zeiten, Nachrichten, Umfragewerte und den Warteschlangenbericht lesenGET unter /queue
queue:writePersonen zu einer Warteschlange hinzufügen, aufrufen, ihre Tickets abschließen, Zeiten buchen und stornieren und Wartenden schreibenPOST unter /queue
webhooks:manageDie eigenen Webhook-Adressen des Schlüssels abonnieren und abbestellen, für Ereignisse, deren Daten der Schlüssel lesen kannGET, POST und DELETE /webhooks

Fundsachen, Rückgabeanfragen, Verlustmeldungen und Analysen brauchen vFound Lost & Found; Pakete brauchen vFound Parcels; Tickets brauchen vFound Checkroom; Geräte brauchen vFound Equipment; Besuche brauchen vFound Visitors; die Personenliste braucht Parcels, Visitors oder Equipment; Hotelaufenthalte brauchen Lost & Found oder Parcels; das Schulsekretariat braucht Visitors mit eingeschaltetem Schulsekretariat (es antwortet mit 404, solange es aus ist); Warteschlangen und Tickets brauchen vFound Queue. Ein Produkt, das für den Standort nicht freigeschaltet ist, antwortet mit 403.

Ein Schlüssel handelt als die Person, die ihn erstellt hat, und funktioniert nicht mehr, wenn diese Person den Standort nicht mehr verwaltet, es sei denn, die Anfrage nennt in X-Acting-User ein Teammitglied (siehe Im Namen eines Teammitglieds handeln). Änderungen mit einem Schlüssel laufen über dieselben Regeln, E-Mails und denselben Prüfpfad wie am Empfang, und jeder Eintrag im Prüfpfad hält den Schlüssel fest, der die Änderung vorgenommen hat. Jeder Schlüssel kann 120 Anfragen pro Minute stellen. Basisadresse: https://vfound.io/api/v1. Listen liefern 25 Datensätze pro Seite (bis zu 100 mit per_page) und akzeptieren page; die meisten lassen sich außerdem mit updated_since (ISO 8601) und search filtern, wie unten aufgeführt.

Testschlüssel

Ein als Testschlüssel erstellter Schlüssel beginnt mit vf_test_ und kann nur queue:read und queue:write enthalten. Er arbeitet auf einer einzigen gekennzeichneten Testwarteschlange, Test line (sandbox) (Warteschlange 1, Schalter 1), und nirgends sonst: Dieselben Queue-Adressen wie bei einem Live-Schlüssel für Warteschlangen, Zeitfenster, Tickets, /queue/join, nächste aufrufen, aufrufen, bedient, nicht erschienen und entfernen antworten aus der Testwarteschlange; jede andere Adresse antwortet mit 403 und code: test_key. Ein Testschlüssel liest oder ändert nie eine echte Warteschlange oder ein echtes Ticket und sendet keine E-Mail, keine SMS, keinen Browser-Hinweis und keinen Webhook. Ein Testschlüssel ignoriert Idempotency-Key: Dieselbe Anfrage, zweimal gesendet, wird zweimal ausgeführt. Antworten enthalten "sandbox": true und den Header X-Vfound-Sandbox: 1. Eine Testwarteschlange fasst bis zu 100 Tickets pro Schlüssel, ohne E-Mail-Adresse, und sie werden mit dem Schlüssel und nach sieben Tagen gelöscht. Verwenden Sie erfundene Namen.

Sichere Wiederholungen

Senden Sie bei einem POST, PATCH oder DELETE einen Idempotency-Key-Header (ein beliebiger eindeutiger Wert mit bis zu 191 sichtbaren Zeichen, etwa eine UUID). Wenn die Verbindung abbricht und Sie dieselbe Anfrage innerhalb von 24 Stunden mit demselben Schlüssel erneut senden, wiederholt vFound die Änderung nicht: Es antwortet mit der ersten Antwort und dem Header Idempotent-Replayed: true. Derselbe Schlüssel mit einer anderen Anfrage wird abgelehnt (422, idempotency_key_reused); ein Schlüssel, dessen erste Anfrage noch läuft, antwortet mit 409 (idempotency_in_progress). Nachdem persönliche Daten von Findern oder anfragenden Personen gelöscht wurden, liefern gespeicherte Antworten für diesen Standort stattdessen 410 ohne die gelöschten Daten; aktualisieren Sie den Datensatz, statt den alten Schreibvorgang mit einem neuen Schlüssel zu wiederholen. Serverfehler werden nicht gespeichert, daher führt eine Wiederholung danach die Anfrage erneut aus. Eine Antwort mit etwas, das nur einmal angezeigt wird, etwa das Signaturgeheimnis aus POST /webhooks oder ein Kiosk-Kopplungscode, wird ebenfalls nie gespeichert: Eine Wiederholung führt die Anfrage erneut aus. Prüfen Sie daher GET /webhooks, bevor Sie dieselbe Adresse zweimal abonnieren.

Im Namen eines Teammitglieds handeln

Eine App, die Ihr Team am Empfang nutzt, etwa eine Stations- oder Depot-App, kann angeben, für welches Teammitglied sie handelt. Senden Sie X-Acting-User mit der Anmelde-E-Mail-Adresse oder der Nutzer-ID der Person. Sie muss aktuell ein aktives Mitglied des Standorts des Schlüssels sein. Die Anfrage läuft dann als diese Person: Der Verlauf der Fundsache und der Verlauf der Rückgabeanfrage nennen diese Person statt des Erstellers des Schlüssels, und der Prüfpfad nennt diese Person, den Schlüssel und den Manager, der den Schlüssel erstellt hat. Sie darf nur tun, was sowohl die Scopes des Schlüssels als auch ihre eigene Rolle am Standort erlauben: Ein Betrachter kann nur lesen, Mitarbeitende können zusätzlich Fundsachen, Rückgabeanfragen, Verlustmeldungen, Pakete, Garderobentickets, Geräte, Besuche und Hotelaufenthalte ändern, und Inhaber und Manager können jeden Scope nutzen, den der Schlüssel hat. Ein Name, der kein aktives Mitglied des Standorts ist, wird mit 403 und acting_user_refused abgelehnt, mit derselben Meldung, ob die Adresse existiert oder nicht; ein Scope, den die Rolle der Person nicht erlaubt, wird mit 403 und acting_user_role abgelehnt. Sichere Wiederholungen werden pro Person geführt, daher wird die gespeicherte Antwort einer Person nie für eine andere wiedergegeben. Der Header funktioniert nur mit Standortschlüsseln, nicht mit einem Assistenten, der sich per Anmeldung verbindet und bereits als die Person handelt, die ihn verbunden hat. vFound prüft, dass die genannte Person ein aktives Mitglied ist; es verlangt nicht, dass sie sich anmeldet. Nennen Sie daher nur Personen aus einer App, bei der sich Ihr Team anmeldet. Ohne den Header funktioniert ein Schlüssel genau wie bisher.

OpenAPI

Die gesamte API, jedes Ereignis und jedes Objekt ist in einer OpenAPI-3.1-Datei beschrieben: vfound.io/openapi/v1.json. Importieren Sie sie in Postman, Insomnia oder Ihren eigenen Codegenerator. Ein Test hält sie mit der API im Gleichschritt, daher führt sie nie einen Endpunkt auf, den es nicht gibt, und lässt keinen aus, den es gibt.

Fertige Verbindungen zu Betriebssystemen

Inhaber und Manager richten diese schreibgeschützten Anbieterverbindungen unter Einstellungen, Verbindungen, Betriebssysteme ein. Sie sind von der öffentlichen REST-API getrennt: Der Kunde erstellt und kontrolliert die Zugangsdaten des Anbieters, die Verbindung muss vor der Aktivierung einen Test bestehen, wiederholte Fehler pausieren nur diese Verbindung, und die manuelle Arbeit bleibt möglich.

SystemWas vFound liestvFound Bereiche
CloudbedsMinimaler Reservierungs- und Zimmerkontext über einen vom Kunden kontrollierten Objektschlüssel, der auf read:reservation beschränkt ist. Teil von vFound Enterprise.Private Aufenthalte für Lost & Found und Parcels
OfficeRnD FlexMitglieds-ID, Name, E-Mail-Adresse und aktiver Status über flex.community.members.read, mit optionalem Standortfilter.Die gemeinsame Personenliste für Parcels, Equipment und Visitors
Microsoft Entra IDNutzer-ID, Anzeigename, E-Mail-Adresse und aktiver Status über Microsoft-Graph-Delta-Updates und die vom Administrator genehmigte Berechtigung User.Read.All.Die gemeinsame Personenliste für Parcels, Equipment und Visitors

Das sind vom Kunden eingerichtete API-Verbindungen, keine Aussagen über eine Zertifizierung durch den Anbieter. Das Testen, Einschalten und Synchronisieren einer Verbindung gehört zu vFound Enterprise. Die Entra-Verbindung ist insbesondere keine App im Microsoft Marketplace.

Oracle OPERA Cloud ist nicht verfügbar. Der Server-Adapter, der bei Fehlern sperrt (fail-closed), bleibt deaktiviert, bis Oracle-Zugang, Freigabe des Hotels, genaue Umgebungskonfiguration und Abnahme im Live-Betrieb abgeschlossen sind. Er wird nicht als zertifiziert oder vom Kunden validiert beworben.

Fundsachen

AnfrageWas sie tutScope
GET/itemsFundsachen, zuletzt geänderte zuerst. Filter: status, search (Wörter im Titel, in der Beschreibung, Marke, Farbe oder in den Tags), updated_since (ISO 8601), page, per_page (bis zu 100).items:read
GET/items/{id}Eine Fundsache anhand ihrer ID.items:read
GET/categoriesDie Kategorienamen, die eine Fundsache haben kann.items:read
POST/itemsEine Fundsache hinzufügen. Sie wird auf Ihrer Gästeseite veröffentlicht, löst Hinweise und den Abgleich aus und erscheint in Ihrem Prüfpfad wie eine von Hand erfasste.items:write
PATCH/items/{id}Details oder Status ändern.items:write
GET/item-transfersFundsachen, die dieser Standort an einen anderen Standort derselben Kundengruppe gesendet hat oder von dort erhält, unterwegs befindliche zuerst. Listet außerdem die Standorte auf, an die Sie senden können (destinations), und die Lagerbehälter dieses Standorts (bins). Filter: status (in_transit, received oder cancelled), direction (incoming oder outgoing).items:read
POST/item-transfersEine Fundsache, die auf ihren Eigentümer wartet, an einen anderen Standort der Gruppe senden: item_id, destination_business_id und eine optionale note. Nur für Schlüssel, die ein Inhaber oder Manager erstellt hat. Die Fundsache verschwindet von der Gästeseite des sendenden Standorts (sofern dieser Standort seine Fundsachen zeigt) und kann sich bis zu ihrer Ankunft nicht ändern. Eine Fundsache mit einer Rückgabeanfrage bleibt, wo sie ist.items:write
POST/item-transfers/{id}/cancelDer sendende Standort nimmt die Fundsache zurück, bevor sie empfangen wurde.items:write
POST/item-transfers/{id}/receiveDer empfangende Standort bestätigt die Ankunft, mit bin_id (erforderlich, wenn der Standort Lagerbehälter hat) oder location. Die Fundsache gehört dann zu diesem Standort, mit ihren Fotos, ihrem Verlauf und ihren Daten, und wird wie eine neu erfasste Fundsache mit den Verlustmeldungen dieses Standorts abgeglichen.items:write

Werkzeuge für Lost & Found und Checkroom am Empfang

Neue E-Mail-Einstellungen sind standardmäßig aus. Zählungen per Scan und Abweichungen beim Schließen dienen nur der Prüfung. P90 verwendet das 90. Perzentil nach dem Nearest-Rank-Verfahren aus gültigen Zeitstempel-Intervallen; fehlen Stichproben, wird null zurückgegeben. Die Kapazität in physischen Stücken warnt, blockiert die Abgabe aber nie. Die Anfragefelder stehen in der OpenAPI-Beschreibung. Einrichtungsvorlagen und Einstellungen erfordern einen Inhaber oder Manager.

Methode und PfadWas sie tutScope
GET /lost-found/context-schemaVersionierte Felddefinitionen für privaten Kontext lesen, ohne Datensatzwerte. Jeder der genannten Lese-Scopes genügt.items:read oder lost_reports:read
GET /lost-found/desk-settingsOptionale Einstellungen für den Empfang lesen.lost_reports:read
PUT /lost-found/desk-settingsEinstellungen für den Empfang ersetzen; nur Inhaber oder Manager. Neue E-Mail-Einstellungen sind standardmäßig aus.lost_reports:write
GET /checkroom/desk-settingsOptionale Einstellungen für den Empfang lesen.checkroom:read
PUT /checkroom/desk-settingsEinstellungen für den Empfang ersetzen; nur Inhaber oder Manager. Neue E-Mail-Einstellungen sind standardmäßig aus.checkroom:write
GET /lost-found/countsDie letzten 30 Scan-Zählsitzungen auflisten.items:read
POST /lost-found/countsEine Momentaufnahme der gehaltenen Gegenstandskennungen für eine reine Berichtszählung erstellen; keine Änderungen der Verwahrung.items:write
GET /lost-found/counts/{id}Eine Zählung mit den Werten für fehlende, unerwartete und nicht mehr vorhandene Gegenstände lesen.items:read
POST /lost-found/counts/{id}/scanEinen Scan eines QR-Codes oder kurzen Gegenstandsetiketts erfassen; mehrfach gescannte bekannte Gegenstände zählen einmal.items:write
POST /lost-found/counts/{id}/finishEine Zählung abschließen, ohne Gegenstände zu ändern.items:write
GET /lost-found/queuesDie gespeicherten Arbeitslisten des aktuellen Schlüsselerstellers an diesem Standort auflisten.lost_reports:read
PUT /lost-found/queues/{id}Ihre eigene gespeicherte Arbeitsliste ersetzen; die zugrunde liegenden Fundsachen und Rückgabeanfragen bleiben unverändert.lost_reports:write
DELETE /lost-found/queues/{id}Ihre eigene gespeicherte Arbeitsliste löschen; die zugrunde liegenden Fundsachen und Rückgabeanfragen bleiben unverändert.lost_reports:write
POST /lost-found/queuesEine benannte Vorlage für eine Arbeitsliste für den aktuellen Schlüsselersteller speichern.lost_reports:write
GET /lost-found/queues/{id}Die aktuellen Datensätze hinter einer gespeicherten Arbeitsliste lesen. Eingehende Übergaben öffnen die bestehende Ansicht für Übergaben mit ihren Berechtigungen.lost_reports:read, items:read, claims:read
POST /lost-found/intake-reviewDeterministische Hinweise zu Vollständigkeit und Datenschutz zurückgeben; keine KI und keine Änderungen.items:read
GET /checkroom/templatesReine Einrichtungsvorlagen auflisten; nur Manager.checkroom:read
PUT /checkroom/templates/{id}Eine Einrichtungsvorlage als Manager ersetzen; die zugrunde liegenden Veranstaltungen, Stationen und Tickets bleiben unverändert.checkroom:write
DELETE /checkroom/templates/{id}Eine Einrichtungsvorlage als Manager löschen; die zugrunde liegenden Veranstaltungen, Stationen und Tickets bleiben unverändert.checkroom:write
POST /checkroom/templatesDie Stationskonfiguration einer Veranstaltung ohne Gäste oder Tickets speichern; nur Manager.checkroom:write
POST /checkroom/templates/{id}/applyEine neue Veranstaltung und Stationen erstellen; Überschneidungen mit aktiven Nummernbereichen lassen den gesamten Vorgang scheitern.checkroom:write

Lost & Found Kontaktcenter und Verwahrung

Von Menschen bediente Integrationen können eine Verlustmeldung von Gästen erstellen, eine Prüfung der Eigentümerschaft erfassen, über eine Rückgabeanfrage entscheiden und die physische Abholung erfassen. Neue Schreib-Scopes müssen ausdrücklich ausgewählt werden; bestehende Schlüssel erhalten sie nicht. Keiner dieser Schreibvorgänge für Rückgabeanfragen oder Verbleib wird als MCP- oder Ask-vFound-Werkzeug angeboten. Ihre Integration ist dafür verantwortlich, die bedienende Person zu identifizieren und zu autorisieren: Der Prüfpfad nennt den Manager, der den Schlüssel erstellt hat, und, wenn die Integration X-Acting-User sendet, auch das genannte Teammitglied, das vFound nicht authentifiziert.

Methode und PfadWas sie tutScope
POST /lost-reportsAufnahme über das Kontaktcenter: first_name, last_name, email, title und description; optional phone, category id, colour_brand, place_lost, date_lost und language. Sendet die normale Gästebestätigung mit privatem Link und startet die 90-tägige Beobachtung. Eine Einwilligung für das Telefon wird nie unterstellt. Die bestehenden Grenzen für offene Meldungen gelten.lost_reports:write
PUT /lost-reports/{id}Bearbeiten, was verloren wurde, mit dem Fingerabdruck, den GET /lost-reports zurückgibt. Titel und Beschreibung sind erforderlich. Eine ausgelassene Journey behält die gespeicherten Details; bei deaktivierter Erfassung werden Änderungen am Kontext abgelehnt. Änderungen der Kontaktdaten erfordern den separaten Ablauf der verifizierten Kontaktdaten.lost_reports:write
GET /lost-reports/{id}/matchesBis zu 24 aktuelle Kandidaten nach Text und Kategorie, jeweils mit match.label, reason und source. Frische gespeicherte KI-Einschätzungen verwenden cached_ai; sonst wird ein Stichwortvorschlag als possible gekennzeichnet. Kein neuer Modellaufruf und keine Entscheidung über die Eigentümerschaft.lost_reports:read und items:read
GET /items/{id}/matchesPassende Meldungs-ID und Titel ohne Kontaktdaten der meldenden Person; bis zu 24 Treffer aus den letzten 1,000 offenen Meldungen. Dieselben Quellenbezeichnungen und kein neuer Modellaufruf.items:read und lost_reports:read
POST /claims/{id}/verificationverified (boolean) und method (distinctive_details, purchase_proof oder staff_review) erfassen. Bestätigung durch eine Person, keine automatische Echtheitsprüfung von Dokumenten; keine Dokumentkopie und kein Freitext als Nachweis. Die letzte Prüfung muss bestanden sein, bevor die API die Annahme zulässt.claims:write
POST /claims/{id}/decisionstatus: open, accepted, rejected, expired, ready_for_pickup, ready_for_shipment, shipped oder handed_to_courier. Der bestehende Zustandsautomat und die zweite Freigabe gelten. Manuelle Versandfelder folgen den Regeln des Arbeitsbereichs. Bei accepted bringt eine optionale return (pickup oder shipment) die Rückgabeanfrage in derselben Anfrage in diese Phase, mit einer E-Mail an die anfragende Person; wenn eine Herausgabe mit hohem Wert noch ihre zweite Freigabe braucht, bleibt die Rückgabeanfrage auf accepted und return_notice nennt den Grund (dieselbe Anfrage noch einmal ändert nichts). Ein optionales arranged_by (site oder owner) gibt an, wer einen Kurier oder eine Postrückgabe bucht, und jede Antwort zur Rückgabeanfrage zeigt es an. Ohne arranged_by bedeutet eine in shipment gesendete Lieferadresse (oder eine, die die Rückgabeanfrage schon hat), dass Ihr Team es verschickt, wie bisher; andernfalls entscheidet die Einstellung des Standorts für Lost & Found. owner bedeutet, dass der Kurier der anfragenden Person die Fundsache abholt: Es wird keine Adresse verlangt, eine mit owner gesendete Adresse wird abgelehnt, und shipped wird abgelehnt. Wenn ihr Kurier sie abholt, senden Sie handed_to_courier mit der Kurierfirma in shipment.carrier und ihrer Buchungsreferenz in shipment.tracking_number; die Rückgabeanfrage wird abgeschlossen. Um zu ändern, wer bucht, setzen Sie die Rückgabeanfrage auf ready_for_pickup und mit arranged_by zurück auf ready_for_shipment.claims:write
POST /claims/{id}/release-approvalEin anderer Manager gibt die Herausgabe einer angenommenen Fundsache mit hohem Wert frei, unter denselben Prüfungen wie im Arbeitsbereich.claims:write
GET /claims/{id}/custodyVerlauf der Prüfungen und Phasen, Freigebender sowie Name und Zeit der Abholung lesen. signature_recorded ist ein boolescher Wert; weder ein Unterschriftsbild noch eine private Dateiadresse wird offengelegt.claims:read
POST /claims/{id}/handoverDie physische Abholung ab ready_for_pickup erfassen, mit handover.name und, wenn erforderlich, einer PNG-Daten-URL in handover.signature. Wiederholte Aufrufe nach dem Abschluss behalten die erste Quittung.claims:write
POST /items/{id}/dispositionkind donated/disposed, recipient bei einer Spende, optionale notes. Das Datum der Verwahrung und die Prüfungen auf ausstehende oder angenommene Rückgabeanfragen gelten. Gibt die nummerierte Sammelquittung zurück.items:write

Verwenden Sie für Wiederholungen von Schreibvorgängen einen Idempotency-Key. Ein Prüfeintrag authentifiziert weder ein Ausweisdokument noch gibt er selbst die Eigentümerschaft frei. Die erste Erstellung einer Meldung folgt dem Ablauf für Gäste, einschließlich der am Standort eingeschalteten KI; GET-Listen der Treffer verwenden gespeicherte Einschätzungen und nur die Textsuche. Das sind allgemeine REST/OpenAPI-Operationen; keine WSO2-Installation und kein nativer Konnektor wurde zertifiziert.

Eine Fundsache hinzufügen

curl https://vfound.io/api/v1/items -X POST \
  -H "Authorization: Bearer $VFOUND_KEY" -H "Content-Type: application/json" \
  -d '{"title":"Black leather wallet","category":"Wallets & Purses","found_date":"2026-09-23",
       "location":"Front desk","colour":"Black","brand":"Fossil","tags":["leather","cards"],
       "photo":"data:image/jpeg;base64,…","photo_public":true}'

Felder: title und category sind erforderlich. Optional: found_date, found_time (HH:MM), keep_until, location, description, colour, brand, tags, value_band (unknown, low, medium, high), notes (nur für Mitarbeitende), photo (eine Base64-Daten-URL bis 8 MB) und photo_public. Über die API gesendete Fotos werden vom Datenschutzfilter von vFound AI nicht geprüft; setzen Sie daher photo_public für jedes Foto, das persönliche Daten zeigt, auf false.

Das Fundsachen-Objekt

{"id":"9b2f…","title":"Black leather wallet","status":"in_care","category":"Wallets & Purses",
 "found_date":"2026-09-23","found_time":"14:30","keep_until":"2026-10-21","location":"Front desk",
 "description":null,"colour":"Black","brand":"Fossil","tags":["leather","cards"],"value_band":"low",
 "photo_public":true,"photo_url":"https://vfound.io/uploads/…","transfer":null,"created_at":"…","updated_at":"…"}

Der Status ist einer von in_care, in_transit (auf dem Weg zu einem anderen Standort; transfer nennt dann beide Standorte), claimed, expired, donated, disposed oder trash. Ein PATCH darf in_care, expired, donated, disposed oder trash setzen; Rückgaben an einen Gast laufen über Rückgabeanfragen.

Anfragen

AnfrageWas sie tutScope
GET/claimsRückgabeanfragen, zuletzt geänderte zuerst. Filter: status, updated_since, page, per_page.claims:read
GET/claims/{id}Eine Rückgabeanfrage anhand ihrer Referenz.claims:read
{"id":"k3f9x2a1b7c4d8e6","status":"ready_for_pickup","item":{"id":"9b2f…","title":"Black leather wallet"},
 "claimant":{"first_name":"Ana","last_name":"Ruiz","email":"ana@example.com","phone":null},
 "description":"…","place_lost":"Bar","date_lost":"2026-09-22","language":"es","arranged_by":null,"created_at":"…","updated_at":"…"}

Status der Rückgabeanfrage: unread, open, accepted, awaiting_information, ready_for_pickup, ready_for_shipment, shipped, closed, rejected oder expired (angenommen, aber nie abgeholt). arranged_by gibt an, wer einen Kurier oder eine Postrückgabe bucht: venue (Ihr Team verschickt) oder owner (der Kurier der anfragenden Person holt ab); null, wenn die Rückgabeanfrage keine solche Rückgabe hat. Die Angaben der anfragenden Personen sind personenbezogene Daten: Bewahren Sie sie nur so lange auf, wie Sie sie brauchen.

Verlustmeldungen

GET/lost-reports listet auf, was Gäste als verloren gemeldet haben, mit status (open oder closed), den Kontaktdaten der meldenden Person, der verwendeten Sprache und einem geteilten „Wo ist?“-Link. Scope: lost_reports:read.

Analysen

GET/analytics?days=30 liefert dieselbe Übersicht wie Berichte: erfasste und zurückgegebene Fundsachen, Rückgabequote, mittlere Tage bis zur Rückgabe, wo Fundsachen gelandet sind, Kategorien, Hotspots, die geschäftigsten Tage, Leistung des Teams, der Verlauf und Feedback von Gästen. days ist 7, 30, 90 oder 365. Scope: analytics:read.

Hotelaufenthalte

Der Aufenthaltskontext ist privat für den Standort und bewusst minimal. Er enthält eine stabile Aufenthaltsreferenz, eine optionale Gastreferenz, den Namen des Gastes, An- und Abreise, die Zeitzone der Quelle, das aktuelle Zimmer, den Status und die Zeitstempel der Quelle. Er enthält nie Preise, Zahlungsdaten, Treuedaten, Ausweisdokumente, Vorlieben oder andere Reservierungsnotizen.

AnfrageWas sie tutScope
GET/staysAufenthalte auflisten. Filter: search (Gast, stabile Referenz oder aktuelles Zimmer), state, source, page und per_page. Ein Treffer beim Zimmer hilft nur bei der Navigation; er deutet nie auf Eigentümerschaft hin.stays:read
GET/stays/{stay}Ein Aufenthalt und sein nachvollziehbarer Verlauf von Quelle und Korrekturen.stays:read
POST/staysDen über external_stay_ref identifizierten Datensatz der API-Quelle erstellen oder aktualisieren. Senden Sie source_updated_at; verspätete oder wiederholte Ereignisse, die nicht neuer sind als das gespeicherte, werden bestätigt, ohne neuere Daten zu ersetzen.stays:write
curl https://vfound.io/api/v1/stays -X POST \
  -H "Authorization: Bearer $VFOUND_KEY" -H "Idempotency-Key: pms-event-901" \
  -H "Content-Type: application/json" \
  -d '{"external_stay_ref":"BOOK-100","guest_name":"Avery Chen","current_room":"412",
       "stay_state":"in_house","source_timezone":"America/New_York","source_updated_at":"2026-10-03T12:00:00Z"}'

Fundsachen und Pakete akzeptieren optional stay_id und room_at_event. Wenn das Zimmer zum Ereignis fehlt, hält vFound das aktuelle Zimmer des Aufenthalts fest. Diese Momentaufnahme ändert sich nach einem Zimmerwechsel nicht; der Datensatz zeigt auch das aktuelle Zimmer, sodass der Empfang beides sieht.

Parcels

AnfrageWas sie tutScope
GET/parcelsPakete, zuletzt geänderte zuerst. Filter: status (waiting, collected oder returned), search (Empfänger, Einheit, Sendungsnummer, Absender oder Abholcode), updated_since.parcels:read
GET/parcels/{id}Ein Paket.parcels:read
POST/parcelsEin Paket für recipient_email (abgeglichen mit Ihrer Personenliste) oder recipient_name erfassen, mit optionalen unit, carrier, tracking, sender und shelf. Die Person erhält ihren Abholcode per E-Mail, es sei denn, notify ist false.parcels:write
POST/parcels/{id}/collectÜbergeben: collected_by (erforderlich) und eine optionale signature (eine PNG-Daten-URL).parcels:write
POST/parcels/{id}/returnAn den Absender zurücksenden, mit einer optionalen note.parcels:write
POST/parcels/{id}/remindDem Empfänger eine Erinnerung zur Abholung per E-Mail senden.parcels:write
POST/parcels/trackingEine Sendungsnummer normalisieren und UPS, FedEx, USPS, DHL, Amazon oder einen internationalen S10-Versanddienst erkennen. Ein gültiger GS1-SSCC wird als Sendungsverfolgung akzeptiert; eine GS1-Produktkennung wird erkannt, aber nie als Paketnummer behandelt.parcels:read
GET/parcels/pickup-queuePersonen, die gemeldet haben, dass sie am Empfang sind, mit der Anzahl ihrer Pakete und den Regalen.parcels:read
POST/parcels/pickup-queue/{id}/serveEine Ankunft am Empfang als bedient markieren.parcels:write
POST/parcels/bulk-remindErinnerungen per E-Mail für bis zu 200 ausgewählte wartende Pakete senden.parcels:write
POST/parcels/bulk-returnBis zu 200 ausgewählte wartende Pakete an den Absender zurücksenden.parcels:write
GET/parcels/shelvesKapazitäten der Paketregale und aktuelle Belegung.parcels:read
POST/parcels/shelvesEin Regal erstellen oder seine Kapazität ändern.parcels:write
GET/parcels/analyticsMenge, Verteilung der Versanddienste, Zeit bis zur Abholung, Quote nicht abgeholter Pakete und die am stärksten genutzten Regale.parcels:read
GET/parcels/outgoingAusgehende Pakete, die für einen Kurier bereit sind oder übergeben wurden.parcels:read
POST/parcels/outgoingEin ausgehendes Paket erfassen.parcels:write
POST/parcels/outgoing/{id}/handoffDen Kurier und die Unterschrift bei der Übergabe erfassen.parcels:write
GET/parcels/roundsZustellrunden und ihre Stopps.parcels:read
POST/parcels/roundsEine Runde für einen Campus oder ein Büro aus wartenden Paketen erstellen.parcels:write
POST/parcels/rounds/{round}/stops/{stop}/deliverEinen Stopp mit Name und Unterschrift der empfangenden Person abschließen.parcels:write
GET/parcels/couriersKuriere, die über Visitors erfasst wurden, mit status in oder out.parcels:read
{"id":412,"status":"waiting","recipient":{"name":"Ana Ruiz","email":"ana@example.com","unit":"Room 214","reference":"S1044"},
 "carrier":"UPS","tracking":"1Z999AA10123456784","sender":null,"size":"small","shelf":"B2","pickup_code":"KQHRER",
 "notified_at":"…","collected_at":null,"collected_by":null,"returned_at":null,"created_at":"…","updated_at":"…"}

Der Abholcode wird nur angezeigt, solange das Paket wartet. Die Angaben der Empfänger sind personenbezogene Daten: Bewahren Sie sie nur so lange auf, wie Sie sie brauchen.

Checkroom

AnfrageWas sie tutScope
GET/checkroom/ticketsTickets, zuletzt geänderte zuerst, mit status (pending, in, returned, left oder moved), der Nummer, dem Abgegebenen, einzeln gekennzeichneten piece_records, den Angaben des Gastes, falls vorhanden, der am Empfang erfassten Gebühr und den Zeiten. Filter: status, search (Gast, Zimmer, Ticketnummer, Stückkennzeichnung oder Ticketcode), updated_since.checkroom:read
GET/checkroom/tickets/{id}Ein Ticket.checkroom:read
POST/checkroom/ticketsEtwas annehmen und die nächste freie Nummer erhalten: kind (coat, bag, luggage oder other, erforderlich), pieces, optional piece_details mit je einer Art und einem Aufbewahrungsort für jedes Stück, guest_name, guest_email, guest_room, collect_by für Gepäck, notes, fee_method (cash oder card), station_id, event_id, storage_location, language und photo. Die Antwort enthält außerdem einmalig guest_ticket (den Code und die private Ticketadresse), um sie dem Gast als QR-Code zu zeigen oder auszudrucken; Lesezugriffe, Listen und Webhooks enthalten sie nie.checkroom:write
POST/checkroom/tickets/{id}/hand-backZurückgeben, sobald Ihr System das Ticket des Gastes gelesen hat, mit optionalen collected_by und signature. Senden Sie piece_ids, um ausgewählte Stücke zurückzugeben und die anderen offen zu lassen; lassen Sie es weg, um jedes offene Stück zurückzugeben. without_ticket hält fest, dass der Gast sein Ticket verloren hat, und braucht dann collected_by und signature.checkroom:write
GET/checkroom/stationsDie Garderobenstationen des Standorts, Nummernbereiche und Aufbewahrungsorte auflisten.checkroom:read
POST/checkroom/stationsEine Station mit einem sich nicht überschneidenden Nummernbereich erstellen.checkroom:write
PUT/checkroom/stations/{id}Eine Station, ihren Nummernbereich, die Aufbewahrungsorte oder den aktiven Status ändern.checkroom:write
GET/checkroom/eventsVergangene und kommende Veranstaltungen der Garderobe auflisten.checkroom:read
POST/checkroom/eventsEine Veranstaltung mit erwarteter Menge und Stationen erstellen.checkroom:write
PUT/checkroom/events/{id}Zeiten, Prognose oder Stationen einer Veranstaltung ändern.checkroom:write
GET/checkroom/exit-queueTickets, deren Gäste den Empfang gebeten haben, ihre Sachen bereitzumachen.checkroom:read
POST/checkroom/tickets/{id}/readyEin wartendes Ticket als bereit markieren und den Gast benachrichtigen.checkroom:write
GET/checkroom/reportTicketmenge, Stoßzeiten, Rückgabezeit und Gebühren nach Zahlungsart und Mitarbeitenden.checkroom:read
GET/checkroom/exportDie Zeilen des Garderobenberichts als formelsicheres CSV herunterladen.checkroom:read

Queue

Warteschlangen, die Personen darin und die Schalter, zu denen sie aufgerufen werden. Jede Änderung läuft über dieselben Schritte wie am Empfang, mit demselben Verlauf, als Ersteller des Schlüssels oder als das in X-Acting-User genannte Teammitglied. Ein Ticket enthält nie die E-Mail-Adresse des Gastes oder seine Antworten auf die Fragen der Warteschlange.

AnfrageWas sie tutScope
GET/queue/linesWarteschlangen mit ihrem aktuellen Zustand, den wartenden Personen und einer geschätzten Wartezeit für jemanden, der sich jetzt anstellt.queue:read
GET/queue/lines/{id}Eine Warteschlange.queue:read
GET/queue/ticketsTickets eines Standorttags (day, standardmäßig heute), in der Reihenfolge des Aufrufs; filtern Sie nach line und status.queue:read
GET/queue/tickets/{id}Ein Ticket.queue:read
GET/queue/reportTickets, bediente Personen, nicht Erschienene, Personen, die gegangen sind, sowie mittlere Warte- und Servicezeit in Minuten für die letzten days.queue:read
POST/queue/ticketsEine Person zu einer Warteschlange hinzufügen, wie es der Empfang tut.queue:write
POST/queue/call-nextDie nächste Person an einen Schalter aufrufen (counter_id). Zwei Aufrufende bekommen nie dieselbe Person; data ist null, wenn niemand wartet.queue:write
POST/queue/tickets/{id}/callEine ausgewählte Person an einen Schalter aufrufen.queue:write
POST/queue/tickets/{id}/servedDie Person am Schalter als bedient markieren.queue:write
POST/queue/tickets/{id}/no-showEine aufgerufene Person, die nicht gekommen ist, als nicht erschienen markieren.queue:write
POST/queue/tickets/{id}/removeEine Person aus der Warteschlange nehmen.queue:write
GET/queue/bookingsGebuchte Zeiten, früheste zuerst, mit from, to, line, status und der Seiteneinteilung. Nie die E-Mail-Adresse der Person.queue:read
POST/queue/bookingsEine der freien Zeiten auf der Seite für gebuchte Zeiten einer Warteschlange für eine Person buchen (line_id, starts_at, email).queue:write
POST/queue/bookings/{id}/cancelEine gebuchte Zeit stornieren; die Person erhält eine E-Mail, dass das Team sie storniert hat.queue:write
POST/queue/bookings/{id}/arrivedEine Person mit gebuchter Zeit anmelden; ihr Ticket wird nach der gebuchten Zeit eingeordnet.queue:write
POST/queue/tickets/{id}/arrivedEine Person, die sich vor ihrer Ankunft angestellt hat, als anwesend markieren.queue:write
GET/queue/tickets/{id}/messagesDie Nachrichten zwischen einer Person in der Warteschlange und dem Team, älteste zuerst. Beim Lesen werden die Nachrichten der Person als gelesen markiert.queue:read
POST/queue/tickets/{id}/messagesEiner Person in der Warteschlange schreiben (body, 1 bis 500 Zeichen), als Teammitglied des Schlüssels.queue:write
GET/queue/surveyUmfragewerte nach dem Service: Antworten, Durchschnitt, jede Bewertung, nach Warteschlange, Service, Schalter und Teammitglied (der Durchschnitt eines Teammitglieds erscheint ab 5 Antworten). Nie Kommentare.queue:read
GET/queue/performanceSchlichte Zahlen für jedes Teammitglied über dieselben Tage wie der Bericht. Keine Punktzahl und keine Rangliste.queue:read
GET/queue/lines/{id}/slotsDie offenen gebuchten Zeiten einer Warteschlange, wie ihre Buchungsseite sie anbietet.queue:read
POST/queue/joinEine Nummer für einen Gast Ihrer eigenen Website ziehen, nach den Regeln für Gäste (offene Warteschlange, Grenzen, erforderliche Antworten und Einwilligungsfelder). Senden Sie es von Ihrem Server: Der Schlüssel ersetzt das Captcha.queue:write
GET/queue/tickets/lookupTickets anhand der Nummer finden, die der Gast hält.queue:read
GET/queue/tickets/{id}/statusWas die eigene Ticketseite des Gastes zeigt: Platz, Schätzung und Satz.queue:read
GET/queue/tickets/{id}/historyDie Schritte eines Tickets. Wer sie ausgeführt hat, ist team, guest, api (ein Anstellen über einen Schlüssel) oder system (automatisch erledigt, etwa das automatische Nicht-Erscheinen), nie ein Name.queue:read
GET/queue/customers/historyBesuche von jemandem, der darum gebeten hat, sich gemerkt zu werden, gefunden per E-Mail-Adresse, solange der Standort die Wiedererkennung eingeschaltet hat. Sie sagt dem Schlüsselinhaber, ob eine E-Mail-Adresse zu einem gemerkten Besucher gehört.queue:read
GET/queue/insightsZahlen für dieselben Tage wie der Bericht: Personen, die gingen, bevor sie aufgerufen wurden, Personen mit gebuchter Zeit und ohne Termin, der Anteil, der innerhalb des Wartezeitziels aufgerufen wurde, nach Warteschlange und Woche, und die Stoßzeiten aus vergangenen Wochen. Nur Zahlen; nie ein Name oder eine Antwort.queue:read
GET/queue/report-dataDie Queue-Tickets, wie der Berichtsgenerator sie liest (fields[], limit bis zu 1000, offset), für BI-Werkzeuge. Der Name des Gastes ist nie enthalten.queue:read

Equipment

AnfrageWas sie tutScope
GET/loansAusgegebene Geräte, zuletzt geänderte zuerst, mit status (out, returned oder lost), ob es overdue ist, dem Gerät, der Person, die es hat, und den Zeiten. Filter: status (out, returned, lost oder overdue), search (Name, E-Mail-Adresse oder Referenz der Person), updated_since.loans:read
GET/loans/{id}Eine Ausgabe.loans:read
POST/loansEtwas ausgeben: item_id oder item_code (der Code auf dem Etikett oder der Link, den sein QR-Code enthält), borrower_name (erforderlich), optional person_id, um die Personenliste zu verknüpfen, borrower_email für eine Quittung, borrower_reference, due_at, note, language und signature.loans:write
POST/loans/{id}/extendMehr Zeit geben: ein neues due_at. Die Person, die das Gerät hat, erhält die neue Zeit per E-Mail.loans:write
POST/loans/{id}/returnZurücknehmen, mit optionalen condition (good, damaged oder incomplete), note und set_aside, um das Gerät zur Reparatur beiseitezulegen.loans:write
POST/loans/returnsMehrere Dinge gemeinsam zurücknehmen: loan_ids (1 bis 50), mit denselben optionalen condition, note und set_aside für alle. Ganz oder gar nicht: Ist eines schon zurück oder nicht gefunden, ändert sich nichts. Eine Person mit E-Mail-Adresse erhält für jede Ausgabe eine Quittung, die alles aufführt, was zurückkam, und jede Ausgabe sendet ihr eigenes Ereignis loan.returned.loans:write
GET/loans/itemsAlles, was der Empfang ausgibt, nach Namen. Filter: status (available, out, repair oder retired), search (Name, Inventarnummer oder Etikettencode), updated_since.loans:read
GET/loans/items/{id}Ein Gerät, mit dem Link, den der QR-Code seines Etiketts enthält.loans:read
GET/loans/items/{id}/ticketsTickets, die für dieses Gerät an das eigene Jira, Zendesk oder ServiceNow des Standorts gesendet wurden (Beta), mit dem zuletzt zurückgelesenen Status.loans:read
POST/loans/itemsGeräte hinzufügen: name (erforderlich), category, tag, location, notes, loan_hours (für wie viele Stunden es üblicherweise ausgegeben wird), photo, product und variant (Einheiten eines Produkts und einer Variante können als eines gebucht werden) und copies, um bis zu 50 identische, nummerierte Geräte hinzuzufügen.loans:write
PATCH/loans/items/{id}Seine Details ändern oder status auf available, repair oder retired setzen. product und variant ändern seine Produktfamilie; cleaning_status needs_cleaning markiert es als wartend auf die Reinigung und null markiert es als gereinigt. Geräte zeigen product, variant, cleaning_status und cleaning_since.loans:write
GET/loans/items/{id}/tagOb ein NFC- oder RFID-Tag verknüpft ist, und die letzten vier Hex-Ziffern seiner Seriennummer.loans:read
PUT/loans/items/{id}/tagEinen Tag über seine Seriennummer verknüpfen, so wie ein Handy sie liest oder ein Lesegerät in Tastaturform sie tippt (Hex, umgekehrtes Hex oder dezimal); er ersetzt jeden Tag, den das Gerät hatte.loans:write
DELETE/loans/items/{id}/tagDen Tag des Geräts entfernen.loans:write
POST/loans/checkoutsEin bis 50 Geräte in einer atomaren Ausgabe ausgeben oder ein gespeichertes Set ausgeben. Sie akzeptiert eine Person, eine Rückgabezeit, eine Notiz und eine optionale Unterschrift sowie Bestandszeilen (stock), die auf derselben Quittung ausgegeben und in stock zurückgemeldet werden. custom_values setzt die benutzerdefinierten Attribute des Standorts für die Ausgabe.loans:write
GET/loans/kitsGespeicherte Gruppen von Geräten, die üblicherweise zusammen ausgegeben werden.loans:read
POST/loans/kitsEin Set aus insgesamt mindestens zwei Teilen speichern: benannte item_ids, lines (eine Anzahl aus einer Kategorie) und child_kit_ids (Sets darin, bis zu drei Ebenen), stock_lines (gezählter Bestand, der mit ausgegeben und nie für eine Buchung zurückgehalten wird), optional locked, damit seine benannten Geräte nur gemeinsam hinausgehen.loans:write
PUT/loans/kits/{id}Ein gespeichertes Set und seine Geräte ändern.loans:write
GET/loans/trainingsDie Schulungen, die eine Kategorie oder ein Gerät verlangen kann, bevor jemand es nutzt (eingerichtet unter Equipment, Richtlinien, Schulung).loans:read
GET/loans/trainings/{id}/holdersWer eine Schulung hat, ab wann und bis wann, und ob sie abgelaufen ist.loans:read
POST/loans/trainings/{id}/holdersEiner Person aus der Personenliste eine Schulung zuordnen oder sie erneuern, mit einem optionalen Nachweisdokument.loans:write
DELETE/loans/trainings/{id}/holders/{person}Einer Person eine Schulung entziehen, samt ihrem Nachweisdokument.loans:write
GET/loans/borrower-typesDie Nutzerarten: das Gerätelimit jeder Art, die übliche Dauer und die Kategorien, die ihre Personen sehen und nutzen können (eingerichtet unter Equipment, Richtlinien, „Personenarten“). Ein leeres Limit oder eine leere Dauer bedeutet, dass die eigene des Standorts gilt.loans:read
GET/loans/borrower-types/{id}/membersWer eine Nutzerart hat.loans:read
POST/loans/borrower-types/{id}/membersPersonen aus der Personenliste eine Nutzerart zuordnen (bis zu 500 auf einmal).loans:write
PUT/loans/borrower-types/{id}/members/{person}Die Zugehörigkeit einer Person zu einer Nutzerart ändern: ihren Starttag, ihren Endtag (danach sehen sie weiterhin, was die Art zeigt, können es aber nicht mehr reservieren oder nutzen) und eine Notiz dazu, wo eine Gebühr erhoben wurde. vFound nimmt keine Zahlung entgegen.loans:write
DELETE/loans/borrower-types/{id}/members/{person}Einer Person eine Nutzerart entziehen.loans:write
GET/loans/creditsKürzlich vergebene Buchungsguthaben und das Guthaben einer Person. Guthaben ist eine Anzahl, die Buchungen verbrauchen, nie Geld.loans:read
POST/loans/creditsEiner Person Buchungsguthaben geben oder mit einer negativen Zahl welches zurücknehmen (Inhaber und Manager).loans:write
GET/loans/holdsAktive Sperren für die Ausgabe: Solange eine besteht, wird der Person nichts ausgegeben und sie kann nichts buchen.loans:read
POST/loans/holdsEine Sperre für die Ausgabe an eine Person verhängen, mit optionalem Grund (für das Team aufbewahrt, nie in der E-Mail), Endzeit und E-Mail an die Person.loans:write
POST/loans/holds/{id}/liftEine Sperre aufheben.loans:write
GET/loans/spacesRäume, Arbeitsplätze, Parkplätze und andere Orte, die der Standort für eine Zeit bucht, optional gefiltert nach type. Jeder ist ein Eintrag der Art space und wird nie ausgegeben.loans:read
POST/loans/spacesEinen Raum oder Platz mit seiner Art, der Zahl der Personen, die er fasst, und seinem Ort hinzufügen.loans:write
PUT/loans/spaces/{id}Einen Raum oder Platz ändern.loans:write
GET/loans/spaces/availabilityJeden Raum oder Platz mit seinen offenen Buchungen zwischen from und to (bis zu 31 Tage), mit dem Namen der Person, der Zahl der Teilnehmenden und eventuellen Anweisungen zum Aufbau.loans:read
POST/loans/spaces/{id}/bookEinen Raum oder Platz für eine Person und eine Zeit buchen, allein oder mit Geräten (ganz oder gar nicht), mit Anweisungen zum Aufbau für das Team.loans:write
POST/loans/reservation-groups/{id}/partsEin Gerät oder eines aus einer Kategorie zu einer Set- oder Warenkorbbuchung hinzufügen, geprüft wie eine neue Buchung. Bei einem gesperrten Set abgelehnt. Ein Teil aus einer Kategorie, die das Risikoformular des Standorts abdeckt, braucht risk_answers, und die Bewertung der Buchung wartet auf eine neue Prüfung.loans:write
POST/loans/reservations/{id}/remove-partEin Teil aus einer Set- oder Warenkorbbuchung herausnehmen; das letzte Teil wird mit der Buchung storniert.loans:write
GET/loans/placesDie eigenen verschachtelten Orte des Standorts: Gebäude, Räume, Regale, Einsatzorte und Lastwagen. Die place_id eines Geräts legt fest, wo es steht, und füllt seine location und sub_location.loans:read
GET/loans/category-treeDie Gerätekategorien als Baum gruppiert, übergeordnete zuerst. Regeln und Buchungen gelten weiterhin für die eigene Kategorie eines Geräts.loans:read
GET/loans/asset-modelsModelle, aus denen neue Geräte erstellt werden. Senden Sie asset_model_id bei POST /loans/items, um jedes leer gelassene Detail zu füllen.loans:read
GET/loans/items/{id}/linksDie Verknüpfungen eines Geräts mit anderen Geräten desselben Standorts: funktioniert mit, eine Alternative, ersetzt.loans:read
POST/loans/items/{id}/linksEin Gerät mit einem anderen desselben Standorts verknüpfen, mit einer Notiz.loans:write
DELETE/loans/items/{id}/links/{link}Eine Verknüpfung von beiden Geräten entfernen.loans:write
POST/loans/kits/{id}/moveEin Set an einen Ort des Standorts verschieben: Jedes benannte Gerät darin und in den Sets darin geht in einem Zug dorthin (Inhaber und Manager).loans:write
GET/loans/items/{id}/meter-readingsEingetippte Zählerstände für ein Gerät, neueste zuerst.loans:read
POST/loans/items/{id}/meter-readingsEinen Zählerstand erfassen. Ein Wartungsplan mit every_meter ist fällig, sobald der Zähler so weit gelaufen ist; Zählerstände können nur steigen.loans:write
GET/loans/contractsLieferantenverträge, verknüpft mit den Geräten, die sie abdecken (Inhaber und Manager).loans:read
GET/loans/resaleZum Verkauf eingestellte Geräte mit ihrem Angebotspreis und Buchwert (Inhaber und Manager). Nur eine Liste: Es wird nichts beworben oder verkauft.loans:read
GET/loans/pointsAbhol- und Rückgabepunkte, die eine Buchung nennen kann.loans:read
POST/loans/pointsEinen Punkt hinzufügen (Inhaber und Manager). Eine Buchung nennt mit pickup_point_id und dropoff_point_id einen Punkt zum Abholen und einen zum Zurückgeben.loans:write
PUT/loans/points/{id}Einen Punkt ändern oder abschalten.loans:write
GET/loans/projectsProjekte, zu denen eine Buchung gehören kann. Für ein Projekt wird nichts abgeholt, bis es genehmigt ist.loans:read
POST/loans/projectsEin Projekt hinzufügen (wartet auf Genehmigung).loans:write
POST/loans/projects/{id}/decisionEin Projekt genehmigen oder ablehnen (Inhaber und Manager).loans:write
GET/loans/risk-assessmentsRisikobewertungen, die auf eine Prüfung warten (oder nach status), mit den Antworten der Person.loans:read
POST/loans/risk-assessments/{id}/reviewEine Risikobewertung genehmigen oder ablehnen (Inhaber und Manager). Eine Ablehnung storniert die Buchung.loans:write
POST/loans/reservation-seriesEin Gerät, eine Kategorie oder einen Raum oder Platz jeden Tag oder jede Woche buchen (repeat: frequency, every, weekdays, count oder until, skip_conflicts). Jeder Termin folgt den Buchungsregeln und zählt die Termine davor mit; es wird nichts gebucht, wenn einer vergeben ist, es sei denn, skip_conflicts ist an. Höchstens 52 Termine, innerhalb eines Jahres.loans:write
POST/loans/reservations/{id}/moveEine Reservierung, mit jedem Teil einer gemeinsam gebuchten Set- oder Warenkorbbuchung, auf neue Zeiten oder ein anderes Gerät derselben Kategorie verschieben. Erneut geprüft wie eine neue Buchung; ganz oder gar nicht.loans:write
GET/loans/waitlistPersonen, die auf eine vergebene Zeit warten, nach status (standardmäßig waiting).loans:read
POST/loans/waitlistJemanden auf die Warteliste für ein Gerät, eine Kategorie oder einen Raum oder Platz und eine Zeit setzen. Wird die Zeit frei, wird die erste Person, deren Zeit jetzt passt, gebucht und per E-Mail benachrichtigt.loans:write
POST/loans/waitlist/{id}/cancelJemanden von der Warteliste entfernen.loans:write
GET/loans/feesDas Gebührenbuch, neueste zuerst (filtern nach party_key, kind, status, billing_code, from, to), mit den Gebühreneinstellungen des Standorts und allen, die etwas schulden oder eine Kaution hinterlegt haben. Beträge sind ganze Zahlen in der kleinsten Einheit der Währung. vFound erfasst Gebühren; es wickelt nie eine Zahlung ab.loans:read
GET/loans/fees/partyEine Person (person_id oder party_key): was sie je Währung schuldet, hinterlegte Kautionen, Einträge und Rechnungen.loans:read
GET/loans/fees/billing-codesBerechnet, erlassen, beglichen und noch offen je Abrechnungscode und Währung für einen Zeitraum; format=csv für eine CSV-Datei.loans:read
POST/loans/fees/chargesEine Gebühr für Schaden, Ersatz oder anderes erfassen, oder eine Gebühr mit Preis über fee_template_id. Die Steuer des Standorts gilt, es sei denn, taxable ist false.loans:write
POST/loans/fees/paymentsGeld erfassen, das der Standort selbst entgegengenommen hat (bar, mit dem eigenen Kartenterminal, per Überweisung). Es begleicht offene Gebühren, älteste zuerst.loans:write
POST/loans/fees/depositsEine Kaution erfassen, die der Standort entgegengenommen hat; hinterlegt, bis sie zurückgegeben oder einbehalten wird.loans:write
POST/loans/fees/deposits/{id}/returnEine hinterlegte Kaution zurückgeben.loans:write
POST/loans/fees/deposits/{id}/keepEine hinterlegte Kaution oder einen Teil davon einbehalten (Inhaber und Manager, mit Begründung); der einbehaltene Teil zählt als Zahlung.loans:write
POST/loans/fees/{id}/waiveErlassen, was eine Gebühr noch braucht (Inhaber und Manager, mit Begründung).loans:write
POST/loans/fees/{id}/voidEine versehentlich erfasste Zahlung ungültig machen (Inhaber und Manager, mit Begründung). Wird die Zahlung ungültig gemacht, die eine einbehaltene Kaution erzeugt hat, wird dieser Betrag wieder als Kaution hinterlegt.loans:write
GET/loans/{id}/feesWas dem Empfang für eine zurückgegebene Ausgabe angeboten wird: das noch nicht erfasste Verspätungsentgelt, der Ersatzwert bei Verlust oder Schaden, hinterlegte Kautionen.loans:read
POST/loans/{id}/late-fineDas Verspätungsentgelt für eine verspätet zurückgekommene Ausgabe hinzufügen, gezählt ab dem Zeitpunkt der Rückkehr. Einmal pro Ausgabe.loans:write
GET/loans/invoicesRechnungen, neueste Nummer zuerst.loans:read
POST/loans/invoicesEine nummerierte Rechnung für die offenen Gebühren einer Person in einer Währung ausstellen.loans:write
POST/loans/invoices/{id}/voidEine Rechnung ungültig machen (Inhaber und Manager, mit Begründung); reissue überträgt ihre offenen Gebühren auf eine neue, die sie ersetzt.loans:write
GET/loans/reservationsReservierungen nach Startzeit, optional gefiltert nach status oder from.loans:read
POST/loans/reservationsEin bestimmtes Gerät oder ein Gerät einer Kategorie für eine Person und ein Zeitfenster reservieren. custom_values setzt die benutzerdefinierten Attribute des Standorts für die Buchung.loans:write
POST/loans/reservations/{id}/approveEine Reservierung genehmigen, die auf Prüfung wartet. Hat der Standort Genehmigungsschritte, zeichnet ein Schlüssel einen Schritt nur für das Teammitglied ab, das er in X-Acting-User nennt, eine Assistentenverbindung zeichnet nie einen ab, und niemand zeichnet einen Schritt einer Buchung ab, die er selbst gemacht hat (approval_not_yours). Dieselbe Regel gilt für das Buchen trotz eines Konflikts.loans:write
POST/loans/reservations/{id}/cancelEine ausstehende, genehmigte oder bereite Reservierung stornieren.loans:write
POST/loans/reservations/{id}/pickupDas reservierte Gerät atomar übergeben und die Reservierung als abgeholt abschließen.loans:write
POST/loans/reservation-groupsEin Set (kit_id) oder einen Warenkorb (items: ein Gerät oder eine Kategorie und Menge je Zeile) für eine Person und ein Zeitfenster reservieren: jedes Teil oder keines. Das Genehmigen, Stornieren oder Abholen eines Teils wirkt auf jedes offene Teil.loans:write
GET/loans/downtimesDatierte Zeitfenster, in denen ein Gerät nicht gebucht oder ausgegeben werden kann und die noch nicht zu Ende sind (item_id schränkt auf ein Gerät ein).loans:read
POST/loans/downtimesEinem Gerät ein Zeitfenster hinzufügen: loan_item_id, starts_at, ends_at und ein optionaler reason. Abgelehnt, solange eine Buchung oder Ausgabe das Gerät für irgendeinen Teil dieser Zeit hält.loans:write
DELETE/loans/downtimes/{id}Ein Zeitfenster entfernen.loans:write
GET/loans/extra-values/{type}/{id}Die benutzerdefinierten Attribute des Standorts für eine Person (person), eine reservation oder eine checkout, mit den für diese Art von Datensatz definierten Feldern.loans:read
PUT/loans/extra-values/{type}/{id}Diese Attribute setzen, geprüft gegen die Felder des Standorts und deren Bedingungen für die Anzeige.loans:write
GET/loans/closuresTage, an denen der Geräteempfang geschlossen ist und die noch nicht zu Ende sind.loans:read
POST/loans/closuresEine Schließung hinzufügen: starts_on und ends_on als Daten in der Zeitzone des Standorts, bis zu 366 Tage. Eine optionale note bleibt intern; public_message (bis zu 300 Zeichen) wird den Personen angezeigt. Bestehende Notizen werden nie in die Nachricht an die Personen kopiert.loans:write
DELETE/loans/closures/{id}Eine Schließung entfernen.loans:write
GET/loans/rulesStandardwerte des Standorts, Kategorieregeln für Dauer, Limits, Sperren bei Überfälligkeit, Genehmigung und Buchungsregeln (Pufferzeiten zwischen Buchungen, Mindestvorlauf, wie weit im Voraus) sowie Schließungen.loans:read
POST/loans/rulesEine Kategorieregel erstellen oder ersetzen. Weggelassene Felder der Buchungsregeln behalten ihre gespeicherten Werte.loans:write
GET/loans/timelineKapazitätsprüfungen für ganze Tage nach Gerät oder Kategorie. Erforderlich sind die inklusiven, in der Ortszeit des Standorts angegebenen Daten from und until, höchstens 31 Tage, von heute bis nächstes Jahr; optional group=item|category, item_id, genaue category, page (50 Zeilen). Zellen sind true, false oder null (unsicher). Benachbarte Tage garantieren keine durchgehende Buchung.loans:read
GET/loans/warrantiesErfasste Garantiedaten; filter=soon|expired|all, genaue category, page (50 Zeilen). Soon umfasst heute bis 30 Tage im Voraus. Die persönliche Anmeldung für Erinnerungen erfolgt im Arbeitsbereich.loans:read
GET/loans/utilizationVerstrichene Stunden je Gerät aus dem erfassten Statusverlauf. Erforderlich sind die inklusiven, in der Ortszeit des Standorts angegebenen Daten from und until innerhalb der letzten 365 Tage, begrenzt auf jetzt; optional item_id, genaue category, format=csv. JSON liefert genaue Sekunden; die Stunden im CSV haben sechs Dezimalstellen. Verfügbar schließt Ausgegebenes ein; Reparatur, Wartung und andere nicht verfügbare Zeit sind ausgeschlossen. Frühere Ausfallzeiten sind unbekannt. Die Summen stimmen mit den Zeilen der Geräte überein.loans:read
GET/loans/maintenanceVerlauf von Wartung, Kalibrierung, Sicherheitsprüfung, Inspektion, Reinigung, Reparatur und Notizen; filtern nach Gerät, anstehender Arbeit oder Arbeitsaufträgen (offen oder alle) und ihrem Techniker.loans:read
POST/loans/maintenanceWartung und die nächste Fälligkeit für ein Gerät erfassen. Mit plan_id die erledigte Arbeit eines wiederkehrenden Plans, die dessen nächste Runde startet.loans:write
GET/loans/service-plansWiederkehrende Pläne für Wartung, Kalibrierung, Sicherheitsprüfung, Inspektion und Reinigung, mit der Angabe, ob jeder nach Datum, nach Stunden der Ausgabe oder nach Anzahl der Ausgaben fällig ist.loans:read
POST/loans/service-plansEinem Gerät einen wiederkehrenden Plan hinzufügen (Inhaber und Manager).loans:write
PUT/loans/maintenance/{id}Einen Arbeitsauftrag ändern oder abschließen: Status, Techniker, Lieferant, Kosten und bei done sein Ergebnis und ob das Gerät wieder in Betrieb geht.loans:write
GET/loans/maintenance/costsKosten für Wartung, Reparatur und Reinigung je Gerät, aus abgeschlossenen Einträgen und erledigten Arbeitsaufträgen.loans:read
GET/loans/items/{id}/lifecycleDer Datensatz eines Geräts zu Kauf, Abschreibung, Versicherung und Abgang, mit seinem Wert heute (Inhaber und Manager).loans:read
PUT/loans/items/{id}/lifecycleKaufpreis, Datum, Lieferant und Bestellung, die Abschreibungsmethode (linear oder degressiv), Nutzungsdauer und Restwert sowie die Versicherung speichern (Inhaber und Manager).loans:write
POST/loans/items/{id}/disposeErfassen, wie ein Gerät ausgeschieden ist (verkauft, verschrottet, gespendet, recycelt, verloren oder gestohlen); es wird ausgemustert, und seine offenen Buchungen und Arbeitsaufträge werden storniert.loans:write
DELETE/loans/items/{id}/disposeEinen versehentlich erfassten Abgang rückgängig machen; das Gerät ist wieder verfügbar.loans:write
GET/loans/valuationDer Wert der Geräte an einem Datum, auf den Cent genau, mit Summen für das, was noch gehalten wird (Inhaber und Manager).loans:read
POST/loans/service-plans/importPläne aus einer CSV-Datei mit den dokumentierten Spalten prüfen oder hinzufügen, wobei Geräte über die Inventarnummer benannt werden (Inhaber und Manager).loans:write
POST/loans/maintenance/work-orders/importOffene Arbeitsaufträge aus einer CSV-Datei mit den dokumentierten Spalten prüfen oder hinzufügen (Inhaber und Manager).loans:write
GET/loans/maintenance/plannerGeplante Arbeit und offene Arbeitsaufträge nach dem eigenen Tag des Standorts für bis zu 62 Tage, optional für einen Techniker.loans:read
GET/loans/fundingWas jeder Fonds, jeder Zuschuss oder jede Kostenstelle gekauft hat und welche Arbeit ihnen belastet wurde, filterbar nach Fonds und Datum (Inhaber und Manager). Nur ein Datensatz: vFound nimmt keine Zahlung entgegen.loans:read
GET/loans/substancesDas Gefahrstoffverzeichnis: Stoff, Ort, Gefahrenklassen und Prüftermine. Ein Verzeichnis dessen, was der Standort angibt; vFound gibt keine Sicherheitsberatung.loans:read
POST/loans/substancesEinen Stoff hinzufügen, mit seinem Sicherheitsdatenblatt als PDF oder Foto (Inhaber und Manager).loans:write
PUT/loans/substances/{id}Einen Stoff ändern oder sein Datenblatt ersetzen (Inhaber und Manager).loans:write
DELETE/loans/substances/{id}Einen Stoff und sein aufbewahrtes Datenblatt entfernen (Inhaber und Manager).loans:write
GET/loans/licencesLizenzen für die Geräte des Standorts mit Plätzen, Enddatum und den Geräten, auf denen sie installiert sind (Inhaber und Manager). Es wird kein Lizenzschlüssel gespeichert.loans:read
POST/loans/licencesEine Lizenz hinzufügen (Inhaber und Manager).loans:write
PUT/loans/licences/{id}Eine Lizenz und den Ort ihrer Installation ändern.loans:write
DELETE/loans/licences/{id}Eine Lizenz entfernen.loans:write
GET/loans/expiriesVersicherungen und Lizenzen, die bald enden oder bereits beendet sind (Inhaber und Manager).loans:read
GET/loans/stocktakesAktuelle Inventuren der Geräte mit Zahlen zu gescannten und fehlenden Geräten.loans:read
POST/loans/stocktakesEine offene Inventur für den Standort starten, für alles, für einen Ort, eine Kategorie oder ein Set oder für das, was eine Person hat (custodian_id), optional einem Teammitglied zugewiesen (assigned_to).loans:write
POST/loans/stocktakes/{id}/scanEin Gerätetikett, eine Inventarnummer oder eine Seriennummer in die offene Inventur einscannen.loans:write
POST/loans/stocktakes/{id}/scan-manyBis zu 2,000 Codes auf einmal zählen (ein RFID-Lesegerät in Tastaturform oder eine Liste); jeder zählt einmal, und nicht zugeordnete Codes kommen zurück.loans:write
PUT/loans/stocktakes/{id}/assignDie offene Inventur einem Teammitglied zum Zählen geben (assigned_to) oder niemandem (null).loans:write
POST/loans/stocktakes/{id}/finishDie Inventur abschließen und die Liste der fehlenden Geräte zurückgeben.loans:write
GET/loans/stocktake-schedulesInventuren, die sich von selbst öffnen, einmalig oder wiederkehrend.loans:read
POST/loans/stocktake-schedulesEine Inventur planen, einmalig, wöchentlich, monatlich, alle drei Monate oder jährlich, zur eigenen Tageszeit des Standorts.loans:write
PATCH/loans/stocktake-schedules/{id}Einen Plan ändern, pausieren oder fortsetzen.loans:write
DELETE/loans/stocktake-schedules/{id}Einen Plan löschen; von ihm geöffnete Inventuren bleiben bestehen.loans:write
GET/loans/last-seenWo jedes Gerät zuletzt gescannt wurde, wenn der Standort Scan-Positionen speichert (nur von Teammitgliedern, die zugestimmt haben; nie von einem Schlüssel).loans:read
GET/loans/transfersEingehende und ausgehende Übergaben von Geräten für diesen Standort.loans:read
POST/loans/transfersGeräte für einen anderen berechtigten Standort derselben Kundengruppe vorbereiten.loans:write
POST/loans/transfers/{id}/sendErfassen, dass vorbereitete Geräte den Ausgangsstandort verlassen haben.loans:write
POST/loans/transfers/{id}/receiveGeräte am Zielstandort mit ihrem Ort und ihrem Zustand bei der Ankunft entgegennehmen.loans:write
POST/loans/transfers/{id}/cancelEine vorbereitete Übergabe vor dem Versand abbrechen.loans:write
POST/loans/transfers/{id}/rejectEine vorbereitete Übergabe am Zielstandort vor dem Versand ablehnen.loans:write
POST/loans/transfers/{id}/exceptionEin Problem erfassen, während Geräte unterwegs sind.loans:write
POST/loans/importBis zu 5,000 CSV-Zeilen mit den Spaltenüberschriften von vFound, Snipe-IT, Sortly oder Cheqroom als Vorschau anzeigen oder importieren.loans:write

Visitors

AnfrageWas sie tutScope
GET/visitorsBesuche, zuletzt geänderte zuerst, mit status (expected, in, out, cancelled oder missed), dem Besucher, dem Gastgeber, dem Passcode, solange er gültig ist, und den Zeiten. Filter: status, search (Besucher, Firma, Gastgeber oder Passcode), updated_since.visitors:read
GET/visitors/{id}Ein Besuch.visitors:read
POST/visitorsEinen Besucher einladen oder anmelden. Akzeptiert werden die Felder für Besucher, Gastgeber und Zeit sowie visitor_type_id, Antworten, Gültigkeitsdaten und eine tägliche oder wochentägliche Wiederholung.visitors:write
POST/visitors/{id}/sign-inEinen erwarteten Besucher anmelden; der Gastgeber wird benachrichtigt. Senden Sie answers für ein Gruppenmitglied, dessen Besucherart erforderliche Fragen hat, und id_expires_on mit identity_checked, wenn der Standort das Ablaufdatum eines physischen Ausweises erfasst. Der Besuch enthält dann id_expires_on und id_expired.visitors:write
POST/visitors/{id}/group/sign-inAlle aus der Gruppe des Besuchs anmelden, die heute erwartet werden, mit einer E-Mail an den Gastgeber; wer ein eigenes Foto, eine eigene Ausweisprüfung, Unterschrift, Antworten oder Bedingungen braucht, steht in skipped.visitors:write
POST/visitors/{id}/sign-outSie abmelden.visitors:write
POST/visitors/{id}/cancelEine Einladung stornieren.visitors:write
POST/visitors/{id}/send-passDen Pass erneut per E-Mail senden.visitors:write
POST/visitors/{id}/approveEinen ausstehenden Besuch freigeben und den Pass senden.visitors:write
POST/visitors/{id}/denyEinen ausstehenden Besuch ablehnen.visitors:write
GET/visitors/{id}/badgeDen im Browser druckbaren Besucherausweis herunterladen. Wählen Sie für size 4x3, brother oder dymo.visitors:read
GET/visitors/{id}/cardOb der Besuch eine RFID-Karte hat, und ihre letzten vier Zeichen (nie die Nummer). Aus, bis der Standort Karten und Schlüsselanhänger einschaltet.visitors:read
POST/visitors/{id}/cardEinem erwarteten oder angemeldeten Besuch eine Karte über ihre Nummer geben; eine Nummer ist jeweils nur für einen Besuch aktiv.visitors:write
DELETE/visitors/{id}/cardDie Karte zurücknehmen.visitors:write
GET/visitors/{id}/assetsDie Dinge, die dem Besuch übergeben wurden, von Hand eingetragen.visitors:read
POST/visitors/{id}/assetsEin dem Besuch übergebenes Ding erfassen, mit einem optionalen Tag.visitors:write
POST/visitors/{id}/assets/{asset}/returnEin Ding als zurückgegeben markieren.visitors:write
GET/visitor-assets/not-returnedDinge, die Besuchern übergeben und noch nicht zurückgegeben wurden, neueste zuerst.visitors:read
GET/visitors/{id}/fast-trackOb der Besuch einen gültigen Schnellzugangscode hat, bis wann und wie oft er verwendet wurde (nie der Code, den nur der Besucher sieht).visitors:read
POST/visitors/{id}/fast-trackEinem wiederkehrenden Besucher einen Schnellzugangscode geben, der days gilt (1 bis 365).visitors:write
DELETE/visitors/{id}/fast-trackDen Code zurücknehmen.visitors:write
GET/visitor-typesBesucherarten und ihre Fragen, Bedingungen, Ausweise, Freigaben und Aufbewahrung auflisten (retention_days ist null, wenn die Art dem Standard des Standorts folgt).visitors:read
POST/visitor-typesEine Besucherart erstellen.visitors:write
PATCH/visitor-types/{id}Die Felder der Besucherart ändern, die Sie senden.visitors:write
DELETE/visitor-types/{id}Eine Besucherart deaktivieren, ohne frühere Besuche zu ändern.visitors:write
GET/visitor-roll-callDie letzte Anwesenheitskontrolle und ihre Live-Zahlen abrufen. Eine laufende Anwesenheitskontrolle nimmt jeden auf, der sich seit ihrem Start angemeldet hat; eine, die 6 Stunden lang läuft, wird beendet.visitors:read
POST/visitor-roll-callEine Anwesenheitskontrolle starten, optional einschließlich der heute erwarteten Besucher und aller, die auf Freigabe warten.visitors:write
PATCH/visitor-roll-call/entries/{entry}Einen Eintrag als in Sicherheit oder vermisst markieren.visitors:write
POST/visitor-roll-call/{id}/finishDie aktive Anwesenheitskontrolle beenden und ihren Bericht behalten.visitors:write
GET/staff-attendanceDie Anwesenheit der Mitarbeitenden für einen Zeitraum nach der Uhr des Standorts auflisten (standardmäßig heute, höchstens 366 Tage) oder mit open=true nur Personen, die jetzt angemeldet sind. Enthält nie die E-Mail-Adresse der Person.visitors:read
POST/staff-attendanceEine Person aus der Liste der Mitarbeitenden anmelden (mode office oder remote) oder abmelden, mit denselben Regeln wie am Empfang. Setzt voraus, dass die Anmeldung für Mitarbeitende am Standort eingeschaltet ist.visitors:write
POST/staff-presenceBis zu 50 Anwesenheitsereignisse (in, out oder muster) aus Ihrem Ausweis-, Zeiterfassungs- oder WLAN-System senden, jedes mit einer Person aus der Liste der Mitarbeitenden über Referenz, externe ID oder E-Mail-Adresse. Setzt voraus, dass die Anmeldung für Mitarbeitende und der Anwesenheits-Feed am Standort eingeschaltet sind. Antwortet, was pro Ereignis geschehen ist, nie wer.visitors:write
POST/visitors/{id}/cateringDie Catering-Anfrage eines erwarteten oder angemeldeten Besuchs aus den Optionen, die der Standort auflistet, erstellen, ändern oder (ohne Einträge) entfernen. Sendet eine E-Mail an das Catering-Postfach des Standorts; vFound bestellt nichts und nimmt keine Zahlung entgegen. Setzt voraus, dass Catering am Standort eingeschaltet ist.visitors:write
GET/workplace/spacesDie Arbeitsplätze, Besprechungsräume und Parkplätze auflisten, die Personen am Standort buchen können.visitors:read
GET/workplace/freePlätze finden, die für eine ganze Zeit frei sind (höchstens 7 Tage), wobei ein für eine andere Person reservierter Arbeitsplatz ausgelassen wird.visitors:read
GET/workplace/bookingsBuchungen von Arbeitsplätzen, Räumen und Parkplätzen in einem Zeitraum von höchstens 31 Tagen auflisten. Enthält nie die E-Mail-Adresse der Person.visitors:read
POST/workplace/bookingsEinen Platz für eine Person buchen, einmalig oder als wiederkehrende Buchung (täglich oder wöchentlich, bis zu 52 Mal, ganz oder gar nicht), nach den Reservierungsregeln von Equipment.visitors:write
POST/workplace/bookings/{id}/cancelEine Buchung stornieren oder mit scope following oder series ihre späteren Termine.visitors:write
POST/workplace/bookings/{id}/check-inEine Buchung anmelden, ab 15 Minuten vor ihrem Beginn bis zu ihrem Ende.visitors:write
POST/visitors/{id}/roomEinen Besprechungsraum für einen Besuch buchen, ab der Zeit des Besuchs; der Raum folgt dem Besuch.visitors:write
GET/appointment-pagesDie Terminseiten des Standorts, ihre Zeiten und die Angabe auflisten, ob jede jetzt für Besucher offen ist.visitors:read
GET/visitor-roll-call/archiveBeendete Anwesenheitskontrollen (Notfälle, Übungen und Hinweise) auflisten, neueste zuerst.visitors:read
GET/visitor-roll-call/{id}Eine Anwesenheitskontrolle mit ihren Personen, ihrem Zeitverlauf, den Absuchungen und der Zahl der Nachrichten.visitors:read
POST/visitor-roll-call/{id}/peopleEine Person (einen Mitarbeiter, eine andere Person oder einen Auftragnehmer) zur laufenden Anwesenheitskontrolle hinzufügen.visitors:write
POST/visitor-roll-call/{id}/scanEinen Besucher über seinen Passlink oder Code an einem Sammelpunkt als in Sicherheit markieren.visitors:write
POST/visitor-roll-call/{id}/sweepsEine Zone als abgesucht und frei oder als mit Personen darin erfassen.visitors:write
POST/visitor-roll-call/{id}/messagesEine Nachricht an alle, an Personen, die noch nicht in Sicherheit sind, oder an Personen, die Hilfe brauchen, senden. Sie geht per E-Mail, Browser-Hinweis und, über den eigenen Anbieter des Standorts, per SMS oder WhatsApp, mit einem privaten Link, um mit „in Sicherheit“ oder „brauche Hilfe“ zu antworten.visitors:write
GET/visitor-roll-call/{id}/people/{entry}/messagesDie Unterhaltung mit einer Person in einer Anwesenheitskontrolle: was das Team ihr gesendet hat und was sie von ihrem privaten Link zurückgeschrieben hat, älteste zuerst. Antworten Sie über den Nachrichten-Endpunkt mit audience entry.visitors:read
POST/visitor-hazard-alertsEine Warnung, die ein Teammitglied verfasst und an eine gewählte Gruppe sendet: hazard, message und group (on_site, visitor_type, host oder tenant, mit group_ref). Sie startet eine Anwesenheitskontrolle der Art hazard für diese Gruppe. vFound liest keinen Wetter-, Nachrichten- oder Bedrohungs-Feed: Es wird nichts gesendet, es sei denn, Sie senden diese Anfrage. Antwortet mit 409, solange eine andere Anwesenheitskontrolle läuft.visitors:write
POST/visitor-help-alertsLeise um Hilfe bitten: Die dafür gewählten Teammitglieder werden benachrichtigt; kein Besucher sieht etwas.visitors:write
GET/visitor-kiosksGekoppelte, ausstehende und widerrufene Kiosk-Geräte auflisten.visitors:read
POST/visitor-kiosks/pairingEinen Kopplungscode mit acht Zeichen erstellen, der zehn Minuten gilt.visitors:write
DELETE/visitor-kiosks/{id}Ein Kiosk-Gerät widerrufen.visitors:write
PUT/visitor-kiosks/{id}/settingsDie Einstellungen eines Kiosks ändern: eine E-Mail, wenn er eine Anzahl von Minuten lang nicht gesehen wurde, Rückkehr zum Start nach einer ruhigen Zeit, eine Unterschrift bei der Anmeldung und das Drucken des Ausweises vom Tablet. Alles ist anfangs aus.visitors:write
GET/visitor-analyticsSummen nach Tag, Stunde, Art und Gastgeber sowie die durchschnittliche Aufenthaltsdauer des letzten Jahres.visitors:read
GET/visitor-registrationDen Link des Standorts zur Selbstregistrierung abrufen und ob er eingeschaltet ist.visitors:read
GET/school/movementsVerspätetes Kommen und frühes Gehen von Schülern, älteste zuerst, ab since (standardmäßig die letzten 24 Stunden), mit der reference jedes Schülers für das Schulverwaltungssystem. Ein nur lesendes Teammitglied, das in X-Acting-User genannt wird, kann es nicht nutzen.school:read
PUT/school/pupilsBis zu 500 Schüler über reference hinzufügen oder aktualisieren; senden Sie active false für einen Schüler, der gegangen ist. Hier wird nichts gelöscht.school:write

Die Angaben der Besucher sind personenbezogene Daten: Bewahren Sie sie nur so lange auf, wie Sie sie brauchen.

Personen

Die Personenliste enthält die Bewohner, Mitarbeitenden oder Studierenden, die Ihr Empfang betreut. Parcels findet darin Empfänger, Visitors findet Gastgeber, und Equipment schlägt Personen vor, die ein Gerät bekommen. Halten Sie sie über die API im Gleichschritt mit Ihrem Personal-, Studierenden- oder Immobiliensystem.

AnfrageWas sie tutScope
GET/peopleDie Liste, nach Namen. Filter: search (Name, E-Mail-Adresse, Einheit oder Referenz), updated_since.people:read
GET/people/{id}Eine Person.people:read
POST/peopleJemanden hinzufügen: name (erforderlich), email, unit, reference und language für seine E-Mails.people:write
POST/people/upsertBis zu 500 Personen in einem Aufruf hinzufügen oder aktualisieren: people ist eine Liste mit denselben Feldern. Wer mit seiner E-Mail-Adresse schon auf der Liste steht, wird aktualisiert. Antwortet, wie viele hinzugefügt, aktualisiert und übersprungen wurden.people:write
PATCH/people/{id}Nur die Felder ändern, die Sie senden.people:write
DELETE/people/{id}Jemanden entfernen. Seine Pakete, Besuche und Ausgaben behalten den Namen, den er hatte.people:write
GET/people/exportDie vollständige Personenliste als formelsicheres CSV herunterladen.people:read
POST/people/{id}/send-my-vfoundEiner aktiven Person die signierte Seite für ihre verknüpften Pakete, Besucher und Geräte per E-Mail senden.people:write
GET/people/sync-sourceDas gespeicherte CSV-Verzeichnis und das letzte Ergebnis der Synchronisierung anzeigen.people:read
PUT/people/sync-sourceEine öffentliche HTTPS-CSV-url und mode (upsert oder mirror) speichern.people:write
DELETE/people/sync-sourceDie Verbindung entfernen und die bereits importierten Personen behalten.people:write
POST/people/sync-source/runDie gespeicherte Verbindung jetzt ausführen.people:write

Inhaber und Manager können unter Personen auch einen öffentlichen HTTPS-CSV-Link verbinden. vFound prüft ihn stündlich, folgt höchstens drei Weiterleitungen und prüft dabei jedes Ziel, akzeptiert höchstens 10 MB und stoppt im Modus mirror, bevor es Änderungen vornimmt, wenn die Zahl der gültigen Zeilen um mehr als 30 Prozent sinkt. Verbundene Felder werden an ihrer Quelle geändert.

Automatische Bereitstellung aus dem Verzeichnis

Für Microsoft Entra gibt es die oben beschriebene fertige, vom Kunden eingerichtete Verbindung. Identitätsverzeichnisse wie Okta, OneLogin und JumpCloud können stattdessen die Personenliste unter https://vfound.io/api/scim/v2/Users mit einem vFound API-Schlüssel bereitstellen, der people:write hat. Verwenden Sie den Bearer-Schlüssel als geheimen Token. Eine Deaktivierung entfernt die Person aus den Vorschlägen; DELETE anonymisiert Verknüpfungen nach denselben Regeln für Personen. Dieser Endpunkt erstellt nur Einträge der Personenliste und nie Anmeldungen für das Team.

Schulungslisten für Equipment können aus demselben Verzeichnis kommen: Verknüpfen Sie eine Schulung über ihren Namen mit einer Verzeichnisgruppe (Equipment, Richtlinien, Schulung) und weisen Sie diese Gruppe dann der vFound-Anwendung zu. https://vfound.io/api/scim/v2/Groups antwortet nur für Gruppen, die eine Schulung nennt, und lehnt jede andere Gruppe ab. Ihre Mitglieder sind die Personen (über ihre SCIM-Nutzer-ID), die die Schulung haben; eine Person, die die Gruppe verlässt, verliert die Schulung nur, wenn das Verzeichnis sie vergeben hat, sodass ein vom Team hinzugefügter Eintrag bleibt. Ein vom Verzeichnis vergebener Eintrag, der abgelaufen ist, wird ab dem Tag erneuert, an dem das Verzeichnis die Gruppe erneut sendet und die Person noch darin ist. Gruppen antworten nur für einen Standort mit Equipment. Weil die Gruppenmitgliedschaft eine Schulung vergibt und eine Schulung Personen ermöglicht, die Geräte zu erhalten, die sie verlangen, kann ein Schlüssel mit people:write auf diese Weise Schulungen vergeben: Behalten Sie diesen Schlüssel für Ihren Identitätsanbieter.

Webhooks

Fügen Sie unter Einstellungen, Für Entwickler oder über die API unten bis zu 25 HTTPS-Adressen hinzu und wählen Sie, welche der folgenden Ereignisse jede erhält. vFound sendet innerhalb von Sekunden einen JSON-POST, wiederholt fehlgeschlagene Zustellungen etwa drei Stunden lang und pausiert eine Adresse nach 15 fehlgeschlagenen Zustellungen in Folge.

EreignisWannDaten
item.createdEine Fundsache wird hinzugefügtFundsache
item.updatedIhr Status, Titel, Ort, ihre Kategorie, das Datum für die Aufbewahrung oder die Sichtbarkeit des Fotos ändert sichFundsache
item.transfer_sentEine Fundsache wird an einen anderen Standort der Gruppe gesendet (beide Standorte erhalten es)Übergabe einer Fundsache
item.transfer_cancelledDer sendende Standort nimmt sie zurück, bevor sie ankommtÜbergabe einer Fundsache
item.transfer_receivedDer empfangende Standort bestätigt die AnkunftÜbergabe einer Fundsache
claim.createdEin Gast reicht eine Rückgabeanfrage einRückgabeanfrage
item.disposition_recordedEine Fundsache wird gespendet oder entsorgtFundsache
item.match_updatedEine gespeicherte KI-Einschätzung zu einem Treffer ändert sich; report_id, item_id, label und reasonTrefferpaar
lost_report.match_updatedEine gespeicherte KI-Einschätzung zu einem Treffer ändert sich; report_id, item_id, label und reasonTrefferpaar
claim.ownership_reviewedEin Manager erfasst eine Prüfung der Eigentümerschaft; rufen Sie die Verwahrung für den Verlauf der Prüfungen abRückgabeanfrage
claim.decision_recordedEine Rückgabeanfrage wird angenommen oder abgelehntRückgabeanfrage
claim.release_approvedEin anderer Manager gibt die Herausgabe freiRückgabeanfrage
claim.handover_recordedDie physische Abholung schließt eine Rückgabeanfrage im Status ready_for_pickup abRückgabeanfrage
claim.status_changedEine Rückgabeanfrage wechselt in einen neuen StatusRückgabeanfrage
lost_report.updated, lost_report.closed, lost_report.contact_updated, lost_report.createdEin Gast meldet einen VerlustVerlustmeldung
parcel.loggedEin Paket wird am Empfang oder über die API erfasstPaket
parcel.updatedEine seiner Angaben ändert sich am Empfang, etwa Empfänger, Sendungsnummer oder RegalPaket
parcel.remindedDem Empfänger wird eine Erinnerung gesendet, vom Empfang oder automatischPaket
parcel.collectedEin Paket wird übergebenPaket
parcel.returnedEin Paket wird an den Absender zurückgesendetPaket
parcel.recipient_arrivedEin Empfänger meldet, dass er am Empfang istEintrag der Abholwarteschlange
parcel.reminders_snoozedEin Empfänger pausiert seine ErinnerungenPerson und Anzahl der Pakete
parcel.heldEin Empfänger legt ein Datum für das Zurückhalten festPerson, Datum und Anzahl der Pakete
parcel.proxy_createdEin Empfänger sendet einer bevollmächtigten Person per E-Mail einen AbholcodePerson, bevollmächtigte Person und Ablauf
parcel.pickup_servedDer Empfang markiert eine Ankunft als bedientEintrag der Abholwarteschlange
parcel.escalatedEin wartendes Paket erreicht das Eskalationsalter des StandortsPaket
parcel.outgoing_loggedEin ausgehendes Paket wird erfasstAusgehendes Paket
parcel.outgoing_handed_overEin ausgehendes Paket wird einem Kurier übergebenAusgehende Übergabe
parcel.round_createdEine Zustellrunde wird erstelltZusammenfassung der Runde
parcel.round_deliveredEin Stopp einer Zustellrunde wird abgeschlossenIDs von Runde, Stopp und Paket
checkroom.checked_inEtwas wird angenommen und erhält eine NummerTicket
checkroom.handed_backEs wird zurückgegebenTicket
checkroom.leftDer Abend wird abgeschlossen, während es noch in der Garderobe istTicket
checkroom.self_checkin_startedEin Gast startet ein Ticket an einem gekoppelten KioskTicket
checkroom.ready_requestedEin Gast bittet den Empfang, seine Sachen bereitzumachenTicket
checkroom.readyDer Empfang markiert die Sachen eines Gastes als bereitTicket
checkroom.station_createdEine Garderobenstation wird erstelltStation
checkroom.station_updatedEine Garderobenstation ändert sichStation
checkroom.event_createdEine Veranstaltung der Garderobe wird erstelltEreignis
checkroom.event_updatedEine Veranstaltung der Garderobe ändert sichEreignis
loan.checked_outEin Gerät wird ausgegebenAusgabe
loan.due_soonDie Rückgabezeit liegt weniger als zwei Stunden entfernt, einmal pro RückgabezeitAusgabe
loan.overdueDie Rückgabezeit verstreicht und es ist nicht zurück, einmal pro RückgabezeitAusgabe
loan.extendedDie Rückgabezeit ändert sichAusgabe
loan.returnedEs kommt zum Empfang zurückAusgabe
loan.lostEs wird als nicht zurückkommend erfasstAusgabe
loan.checkout_createdEine atomare Ausgabe mehrerer Geräte wird erstelltSammelausgabe, mit Bestand auf derselben Quittung in stock
loan.self_checkoutEine Person schließt die Ausgabe am Kiosk abSammelausgabe
loan.kit_createdEin gespeichertes Set von Geräten wird erstelltSet
loan.kit_updatedEin gespeichertes Set von Geräten ändert sichSet
loan.reservation_requestedEine Reservierung wartet auf GenehmigungReservierung
loan.reservation_createdEine Reservierung wird sofort bestätigtReservierung
loan.reservation_approvedEine ausstehende Reservierung wird genehmigtReservierung
loan.reservation_readyReservierte Geräte sind zur Abholung bereitReservierung
loan.reservation_cancelledEine Reservierung wird storniertReservierung
loan.reservation_collectedReservierte Geräte werden übergebenSammelausgabe
loan.extension_requestedEine Person bittet um mehr ZeitAusgabe
loan.problem_reportedEine Person meldet ein Problem mit einem GerätAusgabe
loan.rule_updatedEine Ausgaberegel für eine Kategorie ändert sichRegel
loan.maintenance_loggedEine Wartung wird erfasstWartung
loan.maintenance_dueEine geplante Wartung wird fälligWartung
loan.service_dueEin wiederkehrender Wartungsplan wird fällig (nach Datum, Stunden der Ausgabe oder Anzahl der Ausgaben), einmal pro RundeWartung
loan.work_order_openedEin Arbeitsauftrag wird eröffnet, vom Team oder durch eine Rückgabe, für die der Standort einen eröffnen lässtWartung
loan.work_order_closedEin Arbeitsauftrag wird erledigt oder storniertWartung
loan.item_disposedEin Gerät scheidet aus (verkauft, verschrottet, gespendet, recycelt, verloren oder gestohlen)Equipment
loan.stocktake_startedEine Inventur der Geräte beginntInventur
loan.stocktake_completedEine Inventur der Geräte endetInventur
loan.transfer_preparedEin berechtigter Standort bereitet Geräte für den Transport vorÜbergabe
loan.transfer_sentVorbereitete Geräte verlassen ihren AusgangsstandortÜbergabe
loan.transfer_receivedDer Zielstandort erhält die GeräteÜbergabe
loan.transfer_rejectedDer Zielstandort lehnt eine vorbereitete Übergabe abÜbergabe
loan.transfer_cancelledDer Ausgangsstandort bricht eine vorbereitete Übergabe abÜbergabe
loan.transfer_exceptionEine Übergabe unterwegs braucht AufmerksamkeitÜbergabe
loan.transfer_lostDer Ausgangsstandort schließt eine Übergabe ab, die nie angekommen istÜbergabe
loan.charge_recordedEin Entgelt für Verspätung, Schaden, Ersatz, Nutzung oder anderes wird erfasstGebühreneintrag
loan.charge_waivedEin Manager erlässt, was eine Gebühr noch braucht, mit BegründungGebühreneintrag
loan.payment_recordedDas Team erfasst Geld, das der Standort selbst entgegengenommen hat (vFound wickelt nie eine Zahlung ab)Gebühreneintrag
loan.payment_voidedEin Manager macht eine versehentlich erfasste Zahlung ungültigGebühreneintrag
loan.deposit_recordedDas Team erfasst eine Kaution, die der Standort entgegengenommen hatGebühreneintrag
loan.deposit_resolvedEine hinterlegte Kaution wird zurückgegeben oder einbehaltenGebühreneintrag
loan.invoice_issuedEine Rechnung wird für die Gebühren einer Person ausgestelltRechnung
loan.invoice_voidedEin Manager macht eine Rechnung ungültig, mit BegründungRechnung
loan.quote_acceptedDas Team nimmt ein Angebot an und seine Buchungen werden angelegtAngebot
loan.payment_request_createdDas Team erfasst eine Zahlungsaufforderung (an die Person wird nichts gesendet)Zahlungsaufforderung
loan.payment_request_paidZu einer Aufforderung erfasste Zahlungen decken sie vollständig abZahlungsaufforderung
loan.delivery_doneEine Lieferung oder eine Abholung wird als erledigt markiertLieferung
loan.items_importedEin CSV-Import von Geräten wird abgeschlossenAnzahlen
visit.expectedEin Besucher wird eingeladenBesuch
visit.signed_inEin Besucher meldet sich an, am Empfang oder über Ihr QR-SchildBesuch
visit.host_confirmedDer Empfang bestätigt, wen ein selbst angemeldeter Besucher besuchen wollteBesuch
visit.signed_outEr meldet sich ab, am Empfang, über seinen Pass oder automatisch nach Ende des TagesBesuch
visit.cancelledEine Einladung wird storniertBesuch
visit.approval_requestedEin Besuch wartet auf die Freigabe durch das TeamBesuch
visit.approvedEin ausstehender Besuch wird freigegebenBesuch
visit.deniedEin ausstehender Besuch wird abgelehntBesuch
visit.host_repliedEin Gastgeber antwortet über seinen privaten LinkBesuch
visit.roll_call_startedEine Live-Anwesenheitskontrolle (ein Notfall, eine Übung oder ein Hinweis) startetZusammenfassung der Anwesenheitskontrolle
visit.roll_call_completedEine Live-Anwesenheitskontrolle endetZusammenfassung der Anwesenheitskontrolle
visitor_type.createdEine Besucherart wird erstelltBesucherart
visitor_type.updatedEine Besucherart ändert sichBesucherart
visitor_type.deactivatedEine Besucherart wird deaktiviertBesucherart
visitor_agreement.signedEin Besucher hat ein Vereinbarungsdokument unterschrieben, mit einem Link zur unterschriebenen Kopie, der sieben Tage funktioniertUnterschrift unter einer Vereinbarung
kiosk.pairedEin Besucher-Kiosk wird gekoppeltKiosk
kiosk.revokedEin Besucher-Kiosk wird widerrufenKiosk
courier.signed_inEin Lieferant wird als Besucher in Parcels erfasstKurier
courier.signed_outEin Lieferant verlässt den StandortKurier
staff.signed_inEine Person aus der Liste der Mitarbeitenden meldet sich an, im Büro oder remoteAnwesenheit der Mitarbeitenden
staff.signed_outEine Person aus der Liste der Mitarbeitenden meldet sich ab oder wird automatisch abgemeldetAnwesenheit der Mitarbeitenden
person.createdEine Person wird hinzugefügtPerson
person.updatedEine Person wird geändertPerson
person.deactivatedDie Bereitstellung aus dem Verzeichnis deaktiviert eine PersonPerson
person.deletedEine Person wird entferntPerson
people.sync.completedEine verbundene CSV-Synchronisierung wird abgeschlossenAnzahlen
people.sync.failedEine verbundene CSV-Synchronisierung schlägt sicher fehlFehler
report.deliveredEin geplanter Bericht aus Berichte & Analysen, der mit dem Standort geteilt wird, läuft mit Zustellung an die gewählten Webhooks (ein privater Bericht wird nie an Webhooks gesendet); abonnieren Sie ihn unter Einstellungen, Für Entwickler (ein API-Schlüssel kann ihn nicht abonnieren)Jede Spalte, die der Bericht nennt, und bis zu 5,000 Zeilen, oder jede Gruppe
queue.ticket_joinedEine Person stellt sich an einer Warteschlange an, über ihr Handy, einen Kiosk, den Empfang oder die APIQueue-Ticket
queue.ticket_calledEine Person wird an einen Schalter aufgerufen oder erneut aufgerufenQueue-Ticket
queue.ticket_servedEine Person wird als bedient markiertQueue-Ticket
queue.ticket_no_showEine aufgerufene Person wird als nicht erschienen markiert, vom Team oder nach den Minuten der WarteschlangeQueue-Ticket
queue.ticket_leftEine Person verlässt die Warteschlange über ihr Ticket, oder das Team nimmt sie herausQueue-Ticket
queue.ticket_transferredEine Person wird in eine andere Warteschlange oder an einen anderen Schalter verschobenQueue-Ticket
queue.ticket_closedEin Ticket, das am Ende des Tages des Standorts noch offen ist oder in einer archivierten Warteschlange liegt, wird geschlossenQueue-Ticket
queue.booking_createdEine Person bucht eine Zeit auf der Seite für gebuchte Zeiten einer Warteschlange, oder die API bucht eineQueue-Buchung
queue.booking_cancelledEine gebuchte Zeit wird von der Person, vom Team oder von der API storniertQueue-Buchung
queue.ticket_arrivedEine Person, die sich vor ihrer Ankunft angestellt hat, sagt, dass sie da ist, oder das Team markiert sie als angekommenQueue-Ticket
queue.message_receivedEine Person in der Warteschlange schreibt dem Team von ihrer Ticketseite aus; das Ereignis enthält keine WorteQueue-Nachricht
queue.message_sentDas Team schreibt einer Person in der Warteschlange; das Ereignis enthält keine WorteQueue-Nachricht
queue.survey_answeredEine bediente Person beantwortet die Umfrage; das Ereignis enthält die Bewertung und nie den KommentarAntwort auf die Queue-Umfrage
{"id":"evt_…","type":"claim.created","created":"2026-09-23T14:30:00+00:00",
 "venue":{"code":"harbourhotel","name":"Harbour Hotel"},"data":{ …the claim… }}

Die Signatur prüfen

Jede Zustellung enthält Vfound-Signature: t=<unix time>,v1=<hex>, wobei der Hex-Wert ein HMAC SHA256 von t + "." + raw body mit dem Geheimnis Ihres Endpunkts ist. Weisen Sie Zustellungen zurück, die älter als fünf Minuten sind. Nachdem Sie ein neues Signaturgeheimnis erstellt haben, enthalten Zustellungen 24 Stunden lang zwei v1-Werte, einen für jedes Geheimnis; akzeptieren Sie die Zustellung daher, wenn einer davon passt.

// Node.js
const crypto = require("crypto");
function verified(rawBody, header, secret) {
  const parts = header.split(",").map((p) => p.split("="));
  const t = (parts.find(([k]) => k === "t") || [])[1];
  const expected = crypto.createHmac("sha256", secret).update(t + "." + rawBody).digest("hex");
  const fresh = Math.abs(Date.now() / 1000 - Number(t)) < 300;
  return fresh && parts.some(([k, v]) => k === "v1" && v.length === expected.length
    && crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(v)));
}
// PHP
$t = null; $signatures = [];
foreach (explode(',', $header) as $part) {
    [$k, $v] = array_pad(explode('=', $part, 2), 2, '');
    if ($k === 't') { $t = $v; } elseif ($k === 'v1') { $signatures[] = $v; }
}
$expected = hash_hmac('sha256', $t.'.'.$rawBody, $secret);
$ok = abs(time() - (int) $t) < 300
    && count(array_filter($signatures, fn ($s) => hash_equals($expected, $s))) > 0;

Die Header enthalten außerdem Vfound-Event und eine eindeutige Vfound-Delivery-ID, mit der Sie Wiederholungen ignorieren können. Webhooks werden nur an öffentliche HTTPS-Adressen auf Port 443 gesendet.

Über die API abonnieren

Werkzeuge wie Zapier können mit einem Schlüssel, der webhooks:manage hat, ihre eigenen Adressen hinzufügen und entfernen. Das Signaturgeheimnis wird einmal angezeigt, in der Antwort auf den POST. Die Antwort enthält außerdem einen Location-Header mit der Adresse, die Sie mit DELETE aufrufen, wenn das Abonnement entfernt wird.

Ein Schlüssel kann nur Ereignisse abonnieren, deren Daten er lesen könnte: Jedes Ereignis braucht den Lese-Scope seines Produkts (items:read für Ereignisse zu Fundsachen, claims:read für Ereignisse zu Rückgabeanfragen, lost_reports:read, parcels:read, checkroom:read, loans:read für Ereignisse zu Geräten, visitors:read für Ereignisse zu Besuchen, Besucherarten, Kiosken und Kurieren und people:read für Ereignisse zu Personen und zur Personenliste). Ein Schlüssel listet und entfernt nur die Adressen, die er selbst erstellt hat; unter Einstellungen oder von einem anderen Schlüssel hinzugefügte Adressen sind für ihn nicht sichtbar.

AnfrageWas sie tutScope
GET/webhooksDie Adressen, die dieser Schlüssel erstellt hat, und ihre Ereignisse.webhooks:manage
POST/webhooksEine Adresse hinzufügen: url (öffentliches HTTPS auf Port 443) und events, eine Liste der obigen Ereignisse, die der Schlüssel lesen kann.webhooks:manage
DELETE/webhooks/{id}Eine Adresse entfernen, die dieser Schlüssel erstellt hat, und ihren Zustellverlauf.webhooks:manage

Zustellverlauf

Unter Einstellungen, Für Entwickler, sind alle Zustellungen an jede Adresse der letzten 30 Tage aufgeführt, mit ihrem Ergebnis, und jede davon kann mit derselben Vfound-Delivery-ID erneut gesendet werden. Dort können Sie auch eine Adresse bearbeiten, eine pausierte wieder einschalten und ein neues Signaturgeheimnis erstellen. Eine Adresse, bei der 15 Zustellungen in Folge fehlschlagen, wird pausiert, und der Inhaber des Standorts erhält eine E-Mail.

Datenfeed für Berichte (Power BI)

Ein Inhaber oder Manager erstellt unter Berichte & Analysen, bei Power-BI-Datenfeed, einen Feed-Link für die Produkte, die er auswählt. Der Link wird nur einmal angezeigt. Wählen Sie in Power BI „Daten abrufen“, dann „Web“, und fügen Sie ihn ein. Jeder Link liest nur einen Standort und hört sofort auf zu funktionieren, wenn er widerrufen wird, wenn die Person, die ihn erstellt hat, nicht mehr Inhaber oder Manager des Standorts ist oder wenn der Standort pausiert oder geschlossen wird.

GET /api/feeds/reports/{token}/{dataset} liefert die Zeilen eines Datensatzes: equipment_loans, equipment_activity, visits oder checkroom_tickets. Wählen Sie den Zeitraum mit days (1 bis 366, 90, wenn weggelassen) oder from und to (YYYY-MM-DD, nach der Uhr des Standorts). GET /api/feeds/reports/{token}/saved/{id} liefert einen gespeicherten Bericht, der mit dem ganzen Standort geteilt wird, für den eigenen Zeitraum dieses Berichts; days, from und to ändern ihn nicht. Sie können den Token auch als Authorization: Bearer <token> an /api/feeds/reports/{dataset} oder /api/feeds/reports/saved/{id} senden. Eine Antwort enthält bis zu 100,000 Zeilen in value, sodass „Daten abrufen“, „Web“ das ganze Ergebnis liest; wandeln Sie dann die Liste value in eine Tabelle um. Die Antwort endet mit total und truncated: Wenn mehr Zeilen passen, als eine Antwort fasst, ist truncated true und @odata.nextLink nennt den Rest ($top und $skip blättern durch sie, für Werkzeuge, die ihm folgen); „Daten abrufen“, „Web“ folgt ihm nicht, wählen Sie daher einen kürzeren Zeitraum. Wenn die Zeilen eines Berichts mehr als 400,000 gelesene Zeilen oder mehr als 20 Sekunden bräuchten, endet die Antwort mit error, total null und truncated true; ein gruppierter gespeicherter Bericht antwortet stattdessen mit 422 und dem Grund. Die Zeilen kommen in der Reihenfolge, in der sie erfasst wurden. Zeiten in Zeilen sind UTC (ISO 8601); ein nach einem Datum gruppierter gespeicherter Bericht bezeichnet jede Gruppe nach Tag, Woche, Monat, Wochentag oder Stunde nach der Uhr des Standorts. E-Mail-Adressen sowie Name und Zimmer eines Garderobengastes bleiben weg, es sei denn, der Link wurde mit Kontaktdaten erstellt.

KI-Assistenten (MCP)

vFound ist ein Model-Context-Protocol-Server unter https://vfound.io/api/mcp, damit KI-Assistenten Dinge nachschlagen und am Empfang helfen können. Verbinden Sie einen auf eine von zwei Arten: Mit vFound anmelden, für Assistenten, deren Konnektoren sich mit OAuth anmelden, oder mit einem API-Schlüssel, für Clients, die einen Header senden, etwa Claude Code, Cursor und Visual Studio Code. In beiden Fällen sieht er nur die Werkzeuge, die seine Scopes erlauben, für die Produkte, die Ihr Standort geöffnet hat. Ein mit einem API-Schlüssel verbundener Client darf auch X-Acting-User senden; jedes Werkzeug läuft dann als dieses Teammitglied, im Rahmen seiner Rolle.

# Claude Code
claude mcp add --transport http vfound https://vfound.io/api/mcp \
  --header "Authorization: Bearer $VFOUND_KEY"

// Cursor (.cursor/mcp.json)
{"mcpServers":{"vfound":{"url":"https://vfound.io/api/mcp","headers":{"Authorization":"Bearer vf_live_…"}}}}

// Visual Studio Code (.vscode/mcp.json)
{"servers":{"vfound":{"type":"http","url":"https://vfound.io/api/mcp","headers":{"Authorization":"Bearer vf_live_…"}}}}
WerkzeugWas sie tutScope
search_found_itemsFundsachen mit Wörtern wie „schwarzes iPhone“ suchenitems:read
list_expected_visitorsEingeladene Besucher, die noch nicht da sindvisitors:read
list_visitors_on_siteJetzt angemeldete Besuchervisitors:read
list_visitor_typesBesucherarten und ihre Regelnvisitors:read
visitor_analyticsSummen, Muster und durchschnittliche Aufenthaltsdauer der Besuchervisitors:read
visitor_registration_linkDer Link des Standorts zur Selbstregistrierungvisitors:read
list_couriers_on_siteÜber Visitors angemeldete Kuriereparcels:read
list_waiting_parcelsPakete, die auf Abholung wartenparcels:read
detect_parcel_trackingEine Sendungsnummer normalisieren und ihren Versanddienst erkennenparcels:read
parcel_pickup_queuePersonen, die an der Paketausgabe wartenparcels:read
parcel_shelvesKapazität und Belegung der Paketregaleparcels:read
parcel_analyticsPaketmenge, Versanddienste und Leistung bei der Abholungparcels:read
list_outgoing_parcelsAusgehende Pakete und ihr Stand der Übergabeparcels:read
list_parcel_roundsZustellrunden und Stopps für Paketeparcels:read
list_checkroom_exit_queueTickets, deren Gäste am Ausgang wartencheckroom:read
mark_checkroom_readyEin wartendes Ticket als bereit markieren und den Gast benachrichtigencheckroom:write
list_checkroom_stationsGarderobenstationen und Nummernbereichecheckroom:read
list_checkroom_eventsVergangene und kommende Veranstaltungen der Garderobecheckroom:read
checkroom_reportMenge in der Garderobe, Rückgabezeit und Summen der Gebührencheckroom:read
list_queue_linesWarteschlangen, wartende Personen und die geschätzte Wartezeit jetztqueue:read
list_queue_waitingHeute wartende Personen, in der Reihenfolge des Aufrufsqueue:read
queue_reportSummen der Queue und mittlere Warte- und Servicezeit in Minutenqueue:read
call_next_in_queueDie nächste Person an einen Schalter aufrufenqueue:write
mark_queue_ticket_servedDie Person am Schalter als bedient markierenqueue:write
list_overdue_equipmentGeräte, deren Rückgabezeit überschritten ist, und wer sie hatloans:read
list_equipment_kitsGespeicherte Gruppen von Gerätenloans:read
create_equipment_kitEin wiederverwendbares Set von Geräten speichern, ohne es auszugebenloans:write
list_equipment_reservationsReservierungen nach Zeit und Statusloans:read
reserve_equipmentEin Gerät oder eine Kategorie reservieren, ohne es auszugebenloans:write
book_repeating_reservationEin Gerät, eine Kategorie oder einen Platz jeden Tag oder jede Woche buchenloans:write
move_reservationEine Reservierung auf neue Zeiten oder ein anderes Gerät ihrer Kategorie verschiebenloans:write
list_waitlistDie Personen, die auf eine vergebene Zeit wartenloans:read
join_waitlistJemanden auf die Warteliste setzenloans:write
list_space_bookingsJeder Raum, Arbeitsplatz oder Parkplatz und seine Buchungen zwischen zwei Zeitenloans:read
book_spaceEinen Raum oder Platz für eine Person und Zeit buchen; er wird nie ausgegebenloans:write
list_equipment_rulesAusgaberegeln des Standorts und der Kategorienloans:read
save_equipment_ruleEine Kategorieregel erstellen oder ersetzenloans:write
list_equipment_maintenanceWartungsverlauf der Geräte und anstehende Arbeitloans:read
list_equipment_service_plansWiederkehrende Pläne für Wartung, Kalibrierung, Sicherheitsprüfung, Inspektion und Reinigung und welche fällig sindloans:read
update_equipment_work_orderEinen Arbeitsauftrag für ein Gerät ändern oder abschließenloans:write
get_equipment_maintenance_costsKosten für Wartung, Reparatur und Reinigung je Gerätloans:read
get_equipment_valuationDer Wert der Geräte an einem Datum nach Abschreibung (Inhaber und Manager)loans:read
list_equipment_substancesDas Gefahrstoffverzeichnis: Stoff, Ort, Gefahrenklassen und Prüftermine (ein Verzeichnis, keine Sicherheitsberatung)loans:read
get_equipment_fundingWas jeder Fonds, jeder Zuschuss oder jede Kostenstelle gekauft hat und welche Arbeit ihnen belastet wurde (Inhaber und Manager)loans:read
get_equipment_plannerGeplante Arbeit und offene Arbeitsaufträge nach dem eigenen Tag des Standortsloans:read
list_equipment_licencesLizenzen für die Geräte mit Plätzen und Enddaten (Inhaber und Manager)loans:read
get_equipment_expiriesVersicherungen und Lizenzen, die bald enden oder bereits beendet sind (Inhaber und Manager)loans:read
log_equipment_maintenanceWartung, Kalibrierung, eine Sicherheitsprüfung, eine Inspektion, Reinigung, eine Reparatur oder eine Notiz erfassenloans:write
list_equipment_stocktakesAktuelle Inventuren und ihre Zählungenloans:read
start_equipment_stocktakeEine Inventur startenloans:write
scan_equipment_stocktakeEin Gerät in einer offenen Inventur erfassenloans:write
scan_many_equipment_stocktakeViele Codes in einer offenen Inventur auf einmal zählenloans:write
finish_equipment_stocktakeEine Inventur abschließen und zurückgeben, was fehltloans:write
list_equipment_transfersEingehende und ausgehende Übergaben ohne Angaben zur Personloans:read
preview_equipment_importEine CSV-Datei mit Geräten prüfen, ohne sie zu speichernloans:write
find_personJemanden in der Personenliste nachschlagenpeople:read
export_peopleDie Personenliste als formelsicheres CSV exportierenpeople:read
directory_sync_statusDie gespeicherte CSV-Verbindung und ihren letzten Lauf prüfenpeople:read
run_directory_syncDie gespeicherte CSV-Verbindung jetzt ausführenpeople:write
email_my_vfoundEiner Person ihre signierte private Seite per E-Mail sendenpeople:write
invite_visitorEinen Besucher einladen, der per E-Mail einen Pass erhältvisitors:write
approve_visitEine ausstehende Besuchsanfrage freigebenvisitors:write
list_free_workplace_spacesFreie Arbeitsplätze, Besprechungsräume oder Parkplätze für eine Zeit findenvisitors:read
book_workplace_spaceEinen Arbeitsplatz, Besprechungsraum oder Parkplatz für eine Person buchenvisitors:write
request_visit_cateringCatering zu einem Besuch anfragen, aus den Optionen, die der Standort auflistetvisitors:write
list_appointment_pagesDie Terminseiten des Standorts auflisten und ob jede für Besucher offen istvisitors:read
list_staff_on_sitePersonen aus der Liste der Mitarbeitenden auflisten, die jetzt angemeldet sind, im Büro oder remotevisitors:read
sign_staff_in_or_outEine Person aus der Liste der Mitarbeitenden an- oder abmeldenvisitors:write
list_visitor_assets_not_returnedDinge auflisten, die Besuchern übergeben und noch nicht als zurück markiert wurdenvisitors:read
issue_visitor_assetEin Ding erfassen, das einem erwarteten oder angemeldeten Besuch übergeben wurdevisitors:write
return_visitor_assetEin einem Besuch übergebenes Ding als zurückgegeben markierenvisitors:write
start_roll_callDie aktive Anwesenheitskontrolle starten oder zurückgebenvisitors:write
mark_visitor_safeEinen Besucher als in Sicherheit markierenvisitors:write
create_kiosk_pairingEinen Kopplungscode für einen Kiosk erstellen, der zehn Minuten giltvisitors:write
log_parcelEin Paket erfassen und dem Empfänger eine E-Mail sendenparcels:write
remind_parcelEinen Empfänger daran erinnern, ein Paket abzuholenparcels:write
remind_parcelsBis zu 200 ausgewählte Paketempfänger erinnernparcels:write
log_outgoing_parcelEin ausgehendes Paket zum Kurierbuch hinzufügenparcels:write
create_parcel_roundEine Zustellrunde aus wartenden Paketen erstellenparcels:write
extend_loanEiner Person mehr Zeit gebenloans:write

Jedes Werkzeug führt die obige API-Anfrage mit denselben Prüfungen aus, sodass ein Assistent nie mehr tun kann als sein Schlüssel oder seine Verbindung. Es gibt keine Werkzeuge, die etwas übergeben, jemanden an- oder abmelden, über eine Rückgabeanfrage entscheiden oder etwas löschen. Jede Antwort zählt auf die 120 Anfragen pro Minute des Schlüssels oder der Verbindung.

Mit vFound anmelden

Fügen Sie https://vfound.io/api/mcp in Ihrem eigenen Assistenten als Konnektor hinzu. Der Assistent findet selbst heraus, wie er sich anmeldet, und öffnet eine vFound-Seite, auf der sich ein Inhaber oder Manager wie gewohnt in seinem Arbeitsbereich anmeldet, den Standort wählt, in einfachen Worten sieht, was der Assistent darf, und alles abwählen kann. Mitarbeitende und Mitglieder nur mit Leserechten können keinen Assistenten verbinden. Der Assistent gehört Ihrem Standort: Ihr Abonnement beim Anbieter bezahlt seine KI, und vFound erhält nur die Werkzeuganfragen, die er sendet.

Eine Verbindung handelt als die Person, die sie erlaubt hat, mit denselben Prüfungen wie ein API-Schlüssel: Sie funktioniert nicht mehr, wenn diese Person den Standort nicht mehr verwaltet oder der Standort nicht aktiv ist, sie ändert nichts, solange das Abonnement pausiert ist, und sie sieht Werkzeuge nur für geöffnete Produkte. Ihr Zugriffstoken gilt eine Stunde und der Assistent erneuert es selbst; eine Verbindung, die 30 Tage nicht genutzt wird, meldet sich erneut an. Sehen Sie unter Einstellungen, Für Entwickler jede einzelne, wer sie verbunden hat und wann sie zuletzt genutzt wurde; dort beendet Trennen sie sofort. Der Token funktioniert nur am MCP-Endpunkt, nicht in der REST-API; eine App, die die REST-API braucht, verbindet sich, wie der nächste Abschnitt es beschreibt.

Für Entwickler von Clients: OAuth 2.1, wie es die MCP-Autorisierungsspezifikation beschreibt, nur mit dem Authorization-Code-Ablauf und PKCE (S256). Discovery: /.well-known/oauth-protected-resource (RFC 9728, resource https://vfound.io/api/mcp) und /.well-known/oauth-authorization-server (RFC 8414); eine Anfrage ohne Token erhält einen WWW-Authenticate-Header, der den ersten nennt. Clients registrieren sich selbst unter /oauth/register (RFC 7591) als öffentliche Clients ohne Geheimnis; Weiterleitungsadressen müssen https verwenden, oder http nur für localhost oder 127.0.0.1, und müssen dann genau übereinstimmen. Dann /oauth/authorize, /oauth/token (Codes gelten 60 Sekunden und funktionieren einmal; Refresh-Tokens werden bei jeder Verwendung ersetzt, und die Wiederverwendung eines alten trennt den Assistenten) und /oauth/revoke (RFC 7009). Scopes verwenden die oben genannten Namen der API-Schlüssel; senden Sie resource=https://vfound.io/api/mcp (RFC 8707).

Mit vFound für andere Apps anmelden

Eine App, die kein KI-Assistent ist, etwa ein Bestands-, Buchungs- oder Personalsystem, kann sich auf dieselbe Weise statt mit einem API-Schlüssel mit der REST-API verbinden: Senden Sie resource=https://vfound.io/api/v1 an /oauth/authorize und /oauth/token, mit Scopes in den Namen der API-Schlüssel, außer webhooks:manage, das einer App nicht gegeben werden kann. Ein Inhaber oder Manager meldet sich an, sieht den Namen der App und in einfachen Worten, was sie darf, kann alles abwählen und erlaubt sie. Die Verbindung handelt als diese Person mit denselben Prüfungen wie ein API-Schlüssel: Sie funktioniert nicht mehr, wenn die Person den Standort nicht mehr verwaltet oder der Standort nicht aktiv ist, sie ändert nichts, solange das Abonnement pausiert ist, und sie darf wie ein Schlüssel 120 Anfragen pro Minute stellen. X-Acting-User funktioniert nur mit einem API-Schlüssel. Ihr Zugriffstoken funktioniert nur in der REST-API, nie am MCP-Endpunkt, und eine für das eine gezeigte Einwilligung genehmigt nie das andere. Sie wird unter Einstellungen, Für Entwickler als App aufgeführt, die die vFound API nutzt; dort beendet Trennen sie sofort. Discovery: /.well-known/oauth-protected-resource/api/v1; der Rest ist der obige Ablauf.

Fehler

Fehler sind JSON mit einer message; Validierungsfehler fügen errors nach Feld hinzu. 401 bedeutet, dass kein gültiger Schlüssel vorliegt, 403 einen fehlenden Scope, einen Schlüssel, dessen Ersteller den Standort nicht mehr verwaltet, ein Teammitglied in X-Acting-User, das kein aktives Mitglied ist oder dessen Rolle den Scope nicht erlaubt, einen Standort, der nicht aktiv ist, oder eine Änderung, die gesendet wurde, während das Abonnement pausiert ist, 404 nicht gefunden an Ihrem Standort, 422 ungültige Eingabe und 429 zu viele Anfragen.

Wenn eine Änderung wegen des aktuellen Zustands des Datensatzes nicht möglich ist, lautet die Antwort 422, ebenfalls mit einem stabilen code. Die Codes ändern nie ihren Namen:

CodeWas er bedeutet
parcel_not_waitingDas Paket wartet nicht mehr: Es wurde bereits abgeholt, zurückgesendet oder zugestellt.
tracking_duplicateEin Paket mit dieser Sendungsnummer wartet hier bereits.
no_emailDie Person oder der Besucher hat keine E-Mail-Adresse, daher kann nichts gesendet werden.
capacity_fullJede Nummer der Garderobe ist in Gebrauch.
already_checked_inDas Garderobenticket ist bereits angenommen.
already_handed_backDas Garderobenticket wurde bereits zurückgegeben.
nothing_to_hand_backBeim Garderobenticket gibt es nichts zurückzugeben.
number_in_useDiese Nummer der Garderobe ist bereits in Gebrauch.
ticket_closedNur ein offenes Garderobenticket kann per E-Mail gesendet werden.
item_outDas Gerät ist bei jemandem. Nehmen Sie es zuerst zurück.
item_in_repairDas Gerät ist für eine Reparatur beiseitegelegt.
item_retiredDas Gerät ist ausgemustert und kann daher weder ausgegeben noch reserviert werden.
reservation_conflictJemand hat das Gerät oder das letzte freie seiner Kategorie in dieser Zeit reserviert, oder es wird erwartet, dass es noch ausgegeben ist.
already_backDas Gerät wurde bereits zurückgenommen.
not_outDas Gerät ist nicht ausgegeben und kann daher weder mehr Zeit noch eine Erinnerung erhalten noch als nicht zurückkommend markiert werden.
borrower_overdueDie Person hat überfällige Geräte, und der Standort oder die Kategorie erlaubt nichts weiter, bis sie zurück sind.
borrower_item_limitDamit hätte die Person mehr Geräte, als der Standort oder die Kategorie gleichzeitig erlaubt.
reservation_not_readyDie Reservierung ist noch nicht genehmigt, oder sie wurde bereits abgeholt oder storniert.
reservation_item_mismatchDie Ausgabe enthält nicht das Gerät, für das die Reservierung gilt.
reservation_category_mismatchDie Ausgabe enthält ein Gerät außerhalb der reservierten Kategorie.
reservation_borrower_mismatchDie Reservierung gehört einer anderen Person.
reservation_too_longDie Reservierung ist länger, als die Kategorie ausgegeben werden kann. Nur Reservierungen aus My vFound sind auf diese Weise begrenzt.
reservation_daily_limitDie Person hat in den letzten 24 Stunden bereits 5 Reservierungen aus My vFound vorgenommen.
booking_noticeDie Reservierung beginnt früher, als es der Mindestvorlauf der Kategorie erlaubt.
booking_too_far_aheadDie Buchung, die Ausgabe oder die neue Rückgabezeit endet später, als die Kategorie im Voraus gebucht werden kann.
desk_closedDie Reservierung würde an einem Tag beginnen, an dem der Geräteempfang geschlossen ist.
kit_unavailableEin Teil eines Sets oder Warenkorbs ist für diese Zeit nicht verfügbar, daher wurde nichts reserviert. Das Feld unavailable listet jedes Teil und den Grund.
borrower_not_in_groupDer Standort lässt nur Personen mit einer Nutzerart Geräte nutzen oder buchen, und diese Person hat keine (oder wurde eingetippt, statt aus der Personenliste gewählt zu werden).
category_not_allowedKeine der Nutzerarten der Person erlaubt diese Kategorie.
borrower_on_holdDie Ausgabe an diese Person ist pausiert: Das Team hat eine Sperre verhängt, der Standort pausiert die Ausgabe nach wiederholten verspäteten Rückgaben, oder sie schuldet mindestens den Betrag, ab dem der Standort sperrt (Art charges). Das Feld hold nennt die Art und bis wann.
space_too_smallMehr Personen, als der Raum oder Platz fasst (seine Kapazität).
kit_lockedDas Gerät gehört zu einem gesperrten Set, das nur als Ganzes hinausgeht: Nehmen Sie jedes benannte Gerät des Sets auf.
approval_not_yoursDer Standort hat Genehmigende in einer Reihenfolge festgelegt, und diese Person ist nicht die nächste (oder der Standort lässt niemanden einen Schritt für sie überspringen).
project_not_approvedDie Buchung gehört zu einem Projekt, das noch nicht genehmigt ist, daher kann nichts abgeholt werden.
not_enough_creditsDer Standort nutzt Buchungsguthaben, und diese Person hat keines mehr. Geben Sie ihr zuerst welches. Eine Buchung, die storniert oder nie abgeholt wird, gibt ihr Guthaben zurück.
risk_assessment_pendingDie Buchung hat eine Risikobewertung, die nicht genehmigt wurde, daher kann nichts abgeholt werden.
series_unavailableEine wiederkehrende Buchung konnte nicht erstellt werden, weil mindestens einer ihrer Termine vergeben ist oder gegen eine Buchungsregel verstößt, daher wurde nichts reserviert. Das Feld skipped listet jeden Termin und den Grund.
time_availableDie Zeit, auf die jemand warten wollte, ist frei; buchen Sie sie daher, statt sich auf die Warteliste zu setzen.
space_not_handed_outEin Raum oder Platz wird für seine Zeit gebucht und nie ausgegeben, daher kann er weder ausgegeben noch abgeholt werden.
stock_shortVon diesem Bestandsartikel ist am genannten Ort (und in der genannten Charge) nicht genug da, daher hat sich nichts geändert. Das Feld available nennt die Menge dort.
stock_issue_closedAlles aus dieser Ausgabe von Bestand ist bereits zurück oder abgeschrieben.
order_closedEine Bestellung ist abgeschlossen oder storniert und kann sich nicht ändern.
order_over_receivedEs wurde mehr eingegeben, als eine Bestellzeile noch erwartet.
order_not_placedBestand kann nicht gegen eine Bestellung gebucht werden, die noch ein Entwurf ist.
fees_offGebühren sind für diesen Standort aus. Schalten Sie sie zuerst in den Richtlinien für Empfang und Ausgabe ein.
entry_closedDieser Gebühreneintrag oder diese Rechnung kann sich auf diese Weise nicht mehr ändern: Die Gebühr ist beglichen oder erlassen, die Zahlung ist ungültig gemacht, die Kaution wurde zurückgegeben oder einbehalten, oder die Rechnung ist ungültig.
on_invoiceDie Gebühr steht auf einer ausgestellten Rechnung. Machen Sie zuerst die Rechnung ungültig und erlassen Sie dann die Gebühr.
not_lateDie Ausgabe kam nach den Regeln des Standorts für Verspätungsentgelte nicht verspätet zurück, oder sie ist noch draußen.
nothing_to_invoiceDie Person hat in dieser Währung keine offene Gebühr, die nicht schon auf einer ausgestellten Rechnung steht.
charge_unavailableEine der gewählten Gebühren ist nicht offen, steht auf einer anderen Rechnung oder gehört einer anderen Person.
desk_keptDer Arbeitsplatz ist an einem der gewünschten Tage für eine andere Person reserviert.
desk_has_bookingsDen Arbeitsplatz für diese Person zu reservieren würde an diesen Tagen mit offenen Buchungen anderer kollidieren. Stornieren Sie diese zuerst.
booking_closedDie Buchung des Arbeitsplatzes, Raums oder Parkplatzes wurde storniert oder freigegeben und kann daher nicht angemeldet werden.
check_in_closedDie Anmeldung öffnet 15 Minuten vor Beginn einer Buchung und schließt, wenn sie endet.
item_service_dueDer Standort lässt Geräte, die Arbeit brauchen, nicht hinausgehen, und der Wartungstermin dieses Geräts ist erreicht oder einer seiner Pläne ist fällig. Erfassen Sie zuerst die Arbeit.
item_failed_inspectionDer Standort lässt Geräte, die Arbeit brauchen, nicht hinausgehen, und die letzte Prüfung dieses Geräts ist fehlgeschlagen. Erfassen Sie zuerst eine bestandene.
work_order_closedDieser Arbeitsauftrag ist bereits abgeschlossen und kann nicht geändert werden.
already_disposedDieses Gerät ist bereits ausgeschieden.
not_disposedDieses Gerät ist nicht ausgeschieden, daher gibt es nichts rückgängig zu machen.
item_disposedDieses Gerät ist ausgeschieden. Machen Sie den Abgang rückgängig, bevor Sie es wieder verwenden.
training_requiredEine Kategorieregel oder das Gerät verlangt eine Schulung, die die Person nicht hat oder nur nach ihrem Ablaufdatum hat. Das Feld training nennt, was fehlt.
stocktake_openEine Inventur ist bereits offen. Schließen Sie sie zuerst ab.
item_unavailableDas Gerät ist nicht verfügbar oder für eine Reparatur beiseitegelegt und kann daher keine Übergabe starten.
transfer_openDas Gerät hat bereits eine offene Übergabe.
transfer_not_readyNur eine vorbereitete Übergabe kann gesendet werden.
transfer_not_in_transitNur Geräte unterwegs können entgegengenommen oder mit einem Problem markiert werden.
transfer_already_sentEine gesendete Übergabe kann nicht mehr abgebrochen oder abgelehnt werden.
already_signed_inDer Besucher ist bereits angemeldet.
visit_closedDer Besuch ist abgeschlossen. Melden Sie den Besucher als neuen Besuch an.
not_signed_inDer Besucher ist nicht angemeldet.
not_expectedNur ein erwarteter Besuch kann storniert werden oder einen Pass erhalten.
approval_requiredDer Besuch braucht eine Freigabe, bevor sich der Besucher anmelden kann.
visit_not_valid_todayDer Pass kann heute nicht noch einmal verwendet werden, oder heute liegt außerhalb seiner Daten.
plus_one_not_allowedDer Pass erlaubt keine Begleitung, oder er ist nicht mehr freigegeben, erwartet oder gültig.
plus_one_limitDer Besucher hat jede Begleitung hinzugefügt, die der Pass erlaubt.
nobody_to_sign_inNiemand aus der Gruppe des Besuchs wird heute erwartet.
visitor_capacity_fullDie Anmeldung des Besuchers würde das Limit des Standorts oder der Besucherart für gleichzeitig angemeldete Besucher überschreiten.

Die Anmeldung eines Besuchers am Empfang antwortet mit 409 und einem code, wenn der Besucher zuerst eine Prüfung durch ein Teammitglied braucht. Die Antwort nennt nur die Art des Treffers (blocklist, building, restricted_party oder answers); der Eintrag, sein Name und sein Grund sind für das Team des Standorts bestimmt und stehen nie in einer API-Antwort. Senden Sie die Anfrage erneut mit screening_reviewed auf true erst, wenn ein Teammitglied den Treffer geprüft hat. Das erfordert einen Schlüssel mit dem Scope visitors:screening (standardmäßig aus, ebenso wie der Zugriff jedes anderen Schlüssels darauf), und ein Schlüssel, der ein Teammitglied in X-Acting-User nennt, braucht eines, dessen Rolle über Besuche entscheidet. Die Bestätigung wird als die des Schlüssels mit seinem Namen erfasst, nie als die des Teammitglieds, das den Schlüssel erstellt hat. Ohne den Scope lautet die Antwort 403 mit screening_scope. Dasselbe gilt für die Freigabe eines Besuchs, den ein Treffer zurückhält:

CodeWas er bedeutet
screening_matchDer Besucher stimmt mit einer der Sperrlisten des Standorts, einer Prüfung durch das Team oder der Prüfliste überein. Ein Teammitglied muss bestätigen, dass es den Treffer geprüft hat, bevor der Besucher angemeldet wird.
screening_scopeDie Anfrage bestätigt oder genehmigt einen Treffer der Prüfung, und der Schlüssel hat den Scope visitors:screening nicht (oder das in X-Acting-User genannte Teammitglied entscheidet nicht über Besuche).

Checklisten für Abläufe

Ein Standort mit vFound Enterprise kann die Schritte festlegen, die seine Mitarbeitenden in einem entscheidenden Moment bestätigen: eine Fundsache erfassen, übergeben, spenden oder entsorgen; ein Paket übergeben oder zurücksenden; in der Garderobe annehmen oder zurückgeben; Geräte ausgeben oder zurücknehmen; und einen Besucher an- oder abmelden. Solange eine gilt, nehmen diese Anfragen ein Feld checklist an: [{"key": "id_checked", "done": true}, {"key": "reason", "note": "Refused"}] oder ein Objekt aus key mit true oder Notiztext. POST /items, PATCH /items/{id}, POST /items/{id}/disposition, POST /claims/{id}/handover, POST /claims/{id}/decision, POST /parcels/{id}/collect, POST /parcels/{id}/return, POST /parcels/bulk-return, POST /parcels/rounds/{round}/stops/{stop}/deliver, POST /checkroom/tickets, POST /checkroom/tickets/{id}/hand-back, POST /loans, POST /loans/{id}/return, POST /loans/returns, POST /loans/checkouts, POST /loans/reservations/{id}/pickup, POST /visitors, POST /visitors/{id}/sign-in und POST /visitors/{id}/sign-out akzeptieren es. Ohne die erforderlichen Schritte lautet die Antwort 422 mit dem Code checklist_incomplete und einem Objekt checklist, das die noch zu bestätigenden Schritte nennt, und nichts ändert sich. Gilt keine Checkliste, wird das Feld ignoriert. Die abgeschlossenen Checklisten, mit der Angabe, wer sie wann bestätigt hat, stehen in checklists bei den Antworten zu einzelnen Fundsachen, Rückgabeanfragen, Paketen, Tickets, Ausgaben und Besuchen.

CodeWas er bedeutet
checklist_incomplete422: Für diesen Schritt gilt eine Checkliste für Abläufe, und ihre erforderlichen Schritte sind nicht bestätigt.

Wiederholungen mit einem Idempotency-Key-Header können ebenfalls mit einem code antworten:

CodeWas er bedeutet
idempotency_key_invalid400: Der Header ist nicht 1 bis 191 sichtbare ASCII-Zeichen lang.
idempotency_key_reused422: Dieser Schlüssel wurde bereits für eine andere Anfrage verwendet.
idempotency_in_progress409: Die erste Anfrage mit diesem Schlüssel läuft noch. Versuchen Sie es in Kürze erneut.
offline_in_progressDie erste Kopie dieser Offline-Aktion wird noch gespeichert. Das Gerät sendet sie in Kürze erneut.

Eine Anfrage, die ein Teammitglied in X-Acting-User nennt, kann ebenfalls mit einem code antworten:

CodeWas er bedeutet
acting_user_refused403: Der Header nennt nicht genau ein aktives Teammitglied dieses Standorts, oder der Schlüssel ist eine durch Anmeldung erstellte Verbindung.
acting_user_role403: Das genannte Teammitglied kann den Scope dieser Operation mit seiner Rolle am Standort nicht nutzen.
Fragen oder ein Anwendungsfall, den wir unterstützen sollten? Schreiben Sie uns. Wir lesen jede Nachricht.