HEAD Joblauf über seine Heartbeat-URL messen
/hb/{token}/start
GET, HEAD oder POST ohne Body. /start beginnt einen Lauf; die Basis-URL beendet ihn erfolgreich; /fail meldet Fehler; /abort Abbruch. Nur Erfolg bestätigt ein geplantes Lebenszeichen. Die optionale UUID run_id ordnet parallele Läufe zu und macht identische Phasen wiederholbar; widersprüchliche Abschlüsse liefern 409. Ohne Kennung darf nur eine Messung offen sein. Ein Basis-Heartbeat ohne offene Messung behält sein bisheriges Verhalten. Die Dauer verwendet Server-Empfangszeiten; ohne Start bleibt sie unbekannt. Jede neue Phase verbraucht ein normales Ereignis; Wiederholungen werden nicht doppelt gebucht. Geheimnisse niemals protokollieren und unklare Aufrufe ohne Laufkennung nicht automatisch wiederholen.
Auf dieser Seite
Zugriff und Rechte
GET, HEAD oder POST ohne Body. /start beginnt einen Lauf; die Basis-URL beendet ihn erfolgreich; /fail meldet Fehler; /abort Abbruch. Nur Erfolg bestätigt ein geplantes Lebenszeichen. Die optionale UUID run_id ordnet parallele Läufe zu und macht identische Phasen wiederholbar; widersprüchliche Abschlüsse liefern 409. Ohne Kennung darf nur eine Messung offen sein. Ein Basis-Heartbeat ohne offene Messung behält sein bisheriges Verhalten. Die Dauer verwendet Server-Empfangszeiten; ohne Start bleibt sie unbekannt. Jede neue Phase verbraucht ein normales Ereignis; Wiederholungen werden nicht doppelt gebucht. Geheimnisse niemals protokollieren und unklare Aufrufe ohne Laufkennung nicht automatisch wiederholen.
Eine Kontoanmeldung ist nicht erforderlich. Die angegebenen Prüfungen der Browserherkunft und Nutzungslimits gelten weiterhin.
Parameter und Header
| Feld | Position | Typ und Grenzen | Erforderlich | Bedeutung |
|---|---|---|---|---|
| token | Pfad | string; {"pattern":"^mbh_[A-Za-z0-9_-]{43}$"} | Ja | Geheimes Token aus diesem Heartbeat-Monitor. |
| run_id | URL-Parameter | string; {"format":"uuid"} | Nein | Optionale stabile UUID, die Start und Abschluss gemeinsam verwenden. |
Anfragekörper
Kein Anfragekörper.
Antworten
| Stabile Fehlercodes |
|---|
| unauthorized |
| Stabile Fehlercodes |
|---|
| browser_required |
| csrf |
| invalid_origin |
| workspace_scope |
| access_denied |
| forbidden |
| Stabile Fehlercodes |
|---|
| not_found |
| Stabile Fehlercodes |
|---|
| run_conflict |
| Stabile Fehlercodes |
|---|
| body_not_allowed |
| Stabile Fehlercodes |
|---|
| invalid_request |
| invalid_run |
| Stabile Fehlercodes |
|---|
| quota_exceeded |
| Stabile Fehlercodes |
|---|
| unavailable |
| feature_unavailable |
Wiederholungen und asynchrone Aufträge
Für diese Änderung gibt es keine allgemeine Wiederholungsgarantie. Prüfen Sie bei unklarer Antwort den betroffenen Eintrag, bevor Sie es erneut versuchen. Beachten Sie Wartezeiten aus Retry-After und fordern Sie abgelaufene Anmelde- oder Aktionscodes neu an.
Anfragebeispiele
Ersetzen Sie Demokennungen, Zeitstempel und Platzhalter durch eigene Werte. Behalten Sie bei Wiederholungen Kennungen, Zeit und Inhalt bei. Diese Beispiele führen auf der Seite keine Anfragen aus.
Halten Sie Anmeldelinks, Codes, Cookies und Schlüssel privat. Schreiben Sie sie nicht in Logs und teilen Sie sie nicht in Hilfeanfragen.
curl --fail --silent --show-error --request HEAD "https://metribeacon.com/hb/YOUR_HEARTBEAT_TOKEN/start"
import urllib.request
request = urllib.request.Request('https://metribeacon.com/hb/YOUR_HEARTBEAT_TOKEN/start', method='HEAD', headers={})
with urllib.request.urlopen(request) as response:
print(response.status)
const response = await fetch("https://metribeacon.com/hb/YOUR_HEARTBEAT_TOKEN/start", {method:"HEAD", credentials:"same-origin", headers:{}});
console.log(response.status);
package main
import("fmt";"net/http")
func main(){ request,_:=http.NewRequest("HEAD","https://metribeacon.com/hb/YOUR_HEARTBEAT_TOKEN/start",nil);
response,err:=http.DefaultClient.Do(request);if err!=nil{panic(err)};defer response.Body.Close();fmt.Println(response.StatusCode) }
Verwandte Anleitungen
- HTTP-API, OAuth und MCP
Finden Sie die Nutzer-API-Endpunkte mit Rechten, Feldern, Beispielen und Antwortformaten.
- GET Joblauf über seine Heartbeat-URL messen
GET, HEAD oder POST ohne Body. /start beginnt einen Lauf; die Basis-URL beendet ihn erfolgreich; /fail meldet Fehler; /abort Abbruch. Nur Erfolg bestätigt ein geplantes Lebenszeichen. Die optionale UUID run_id ordnet parallele Läufe zu und macht identische Phasen wiederholbar; widersprüchliche Abschlüsse liefern 409. Ohne Kennung darf nur eine Messung offen sein. Ein Basis-Heartbeat ohne offene Messung behält sein bisheriges Verhalten. Die Dauer verwendet Server-Empfangszeiten; ohne Start bleibt sie unbekannt. Jede neue Phase verbraucht ein normales Ereignis; Wiederholungen werden nicht doppelt gebucht. Geheimnisse niemals protokollieren und unklare Aufrufe ohne Laufkennung nicht automatisch wiederholen.
- POST Joblauf über seine Heartbeat-URL messen
GET, HEAD oder POST ohne Body. /start beginnt einen Lauf; die Basis-URL beendet ihn erfolgreich; /fail meldet Fehler; /abort Abbruch. Nur Erfolg bestätigt ein geplantes Lebenszeichen. Die optionale UUID run_id ordnet parallele Läufe zu und macht identische Phasen wiederholbar; widersprüchliche Abschlüsse liefern 409. Ohne Kennung darf nur eine Messung offen sein. Ein Basis-Heartbeat ohne offene Messung behält sein bisheriges Verhalten. Die Dauer verwendet Server-Empfangszeiten; ohne Start bleibt sie unbekannt. Jede neue Phase verbraucht ein normales Ereignis; Wiederholungen werden nicht doppelt gebucht. Geheimnisse niemals protokollieren und unklare Aufrufe ohne Laufkennung nicht automatisch wiederholen.
- GET Joblauf über seine Heartbeat-URL messen
GET, HEAD oder POST ohne Body. /start beginnt einen Lauf; die Basis-URL beendet ihn erfolgreich; /fail meldet Fehler; /abort Abbruch. Nur Erfolg bestätigt ein geplantes Lebenszeichen. Die optionale UUID run_id ordnet parallele Läufe zu und macht identische Phasen wiederholbar; widersprüchliche Abschlüsse liefern 409. Ohne Kennung darf nur eine Messung offen sein. Ein Basis-Heartbeat ohne offene Messung behält sein bisheriges Verhalten. Die Dauer verwendet Server-Empfangszeiten; ohne Start bleibt sie unbekannt. Jede neue Phase verbraucht ein normales Ereignis; Wiederholungen werden nicht doppelt gebucht. Geheimnisse niemals protokollieren und unklare Aufrufe ohne Laufkennung nicht automatisch wiederholen.