Funktionen

Meldungen von Agents

Agents und Apps können eine Wartezeit melden, die ihr Nutzer gerade hatte. Meldungen füllen Orte ohne live veröffentlichte Wartezeit, sind immer als gemeldet gekennzeichnet und werden für Notaufnahmen und Urgent Care nie angenommen.

Was es ist

POST /v1/places/{id}/reports und das Tool report_wait speichern eine Wartezeit, die jemand wirklich erlebt hat. Meldungen bleiben von veröffentlichten Wartezeiten getrennt: Sie haben ihre eigene Stufe, agent, und werden nie mit einer offiziellen oder vom Ort veröffentlichten Zahl vermischt.

So meldest du

Schick die Minuten, die der Nutzer gewartet hat, direkt nach dem Besuch. Eine Meldung braucht einen API-Key und zählt als ein Aufruf.

• wait_min: Minuten, 0 bis 600. Pflicht.
• observed_at: wann der Nutzer gewartet hat, ISO 8601 mit Offset, innerhalb der letzten 2 Stunden. Standard: jetzt.
• kind: in_line, solange er noch ansteht (die bisherige Wartezeit), oder done für die ganze, gerade beendete Wartezeit.

curl -X POST "https://api.waity.ai/v1/places/pl_nvk0wkb3ps/reports" \
  -H "X-Api-Key: $WAITY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"wait_min":25,"kind":"done"}'

Eine gespeicherte Meldung antwortet mit 201, ihrer report.id und shown. Wird sie nicht angezeigt, sagt reason warum: needs_more_reports, official_wait, closed, too_old oder out_of_range.

Das MCP-Tool

report_wait nimmt dieselben Felder und die id des Orts. Es ist das einzige MCP-Tool, das schreibt; seine Annotationen sagen daher, dass es nicht nur liest.

Wann Meldungen erscheinen

• Nur wenn der Ort keine nutzbare offizielle oder vom Ort veröffentlichte Wartezeit hat und nicht geschlossen ist. Eine live veröffentlichte Wartezeit geht immer vor; die Meldung bleibt im Verlauf.
• Nur wenn mindestens 2 verschiedene Personen in den letzten 45 Minuten gemeldet oder bestätigt haben, oder eine vertrauenswürdige Person (andere haben ihre früheren Meldungen bestätigt).
• Angezeigt wird der Median der jeweils neuesten Meldung jeder Person. Sie verschwindet, sobald weniger als 2 Personen im Zeitfenster bleiben.

Wie sie gekennzeichnet sind

Eine gemeldete Wartezeit hat now.tier: "agent", now.basis: "reported" und now.source.name: "people", mit einem eigenen now.source.short. Ihre Zusammenfassung sagt, dass Personen sie gemeldet haben („reported by 2 people“) und der Ort sie nicht veröffentlicht hat.

Gemeldete Minuten werden nie mit veröffentlichten verglichen: Eine Liste mit beiden sagt das, und instead bietet nie die eine als kürzer als die andere an.

Nie für Notaufnahmen oder Urgent Care

Eine Meldung dort wird mit 422 reports_not_accepted abgelehnt, und nichts wird gespeichert.

Limits und Datenschutz

• Aufrufe ohne Key bekommen 401 key_required; sie zählen nicht.
• Eine Meldung pro Melder und Ort alle 30 Minuten (429 report_too_soon, mit Retry-After).
• 200 Meldungen pro Melder am Tag (429 report_limit, bis Mitternacht UTC).
• Mit einer Meldung wird nur die ID des Keys gespeichert. Schick keine Namen, Telefonnummern oder anderen persönlichen Daten.

Melde-Partner, etwa ein SMS-Dienst, der über einen Key für viele Menschen meldet, können reporter schicken: einen stabilen Einweg-Hash jeder Person, nie eine rohe Telefonnummer oder E-Mail. Partner-Keys richtet Waity ein; bei jedem anderen Key wird reporter ignoriert.

Im Verlauf

Meldungen stehen im Verlauf mit tier=agent: jede Meldung als Rohwert und stündliche oder tägliche Werte, gebildet wie bei veröffentlichten Wartezeiten.

Verwandt

Eine Antwort lesen erklärt jedes Feld von now, und jedes Feld der Melde-Route steht in der API-Referenz.