Der RIP Tag begleitet die verstorbene Person. Sobald er mit einem Trauerfall verbunden ist, sehen du und – je nach Einstellung – die Angehörigen, wo er sich befindet. Über die API verbindest du den RIP Tag per Startcode. NFC und Bluetooth bleiben der App vorbehalten.
Methode | Pfad | Zweck |
|
| RIP Tag per Startcode verbinden oder Standort nachreichen |
|
| Link für Angehörige und Tag-Daten lesen |
|
| Funktionen des Links einstellen |
RIP Tag verbinden
POST /cases/{uuid}/tag
Verbindet einen RIP Tag mit dem Trauerfall. Den Startcode findest du auf dem RIP Tag, Format XXXX-XXXX aus Ziffern und Großbuchstaben.
Body-Parameter
Parameter | Typ | Pflicht | Beschreibung |
| String | ja | Startcode, zum Beispiel |
| Number | nein | Breitengrad des Orts, an dem der RIP Tag angebracht wurde (−90 bis 90) |
| Number | nein | Längengrad (−180 bis 180) |
Mit latitude und longitude hat der Fall sofort einen Punkt auf der Karte, auch bevor ein RIP Tracker den Tag sieht. Ungültige Koordinaten und 0,0 werden ohne Fehlermeldung ignoriert.
curl -X POST https://de.rip-app.business/api/public/v1/cases/3f8c2a91-6d4e-4b7a-9c15-8e2f0b6d1a47/tag \
-H "Authorization: Bearer $RIP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"startcode": "K7M2-9QXA",
"latitude": 52.516276,
"longitude": 13.277041
}'
Antwort 200 OK
{
"success": true,
"message": "RIP Tag erfolgreich aktiviert",
"data": {
"tag_uuid": "e4a1c9d2-7b3f-4e8a-9d6c-2f5b8a1e0c74",
"tag_startcode": "K7M2-9QXA",
"location_stored": true
}
}
Feld | Typ | Beschreibung |
| String | Kennung des RIP Tags, danach auch im Trauerfall unter |
| String | Startcode in Großbuchstaben |
| Boolean |
|
Was danach passiert:
Der RIP Tag ist aktiviert und gehört zu diesem Fall. Im Trauerfall stehen
tag_uuidundtag_startcode.Hat die Bestattungsart einen Schritt mit dem Trigger RIP Tag, wird er sofort erreicht. Daran hängende Webhooks werden gesendet.
Ab jetzt meldet der Fall die letzte Position in
tag_last_latitude,tag_last_longitudeundtag_last_seen_at.
Fehler
Code |
| Ursache |
|
|
|
|
| Format stimmt nicht |
|
| Diesen Startcode gibt es nicht |
|
| UUID des Falls unbekannt |
|
| Der Fall hat schon einen RIP Tag |
|
| Der RIP Tag hängt an einem anderen Fall |
|
| RIP Tags sind nur einmal verwendbar |
|
| Fall ist abgeschlossen |
|
| Fall ist archiviert |
|
| Zu viele Versuche von deiner IP-Adresse |
Limit: Pro IP-Adresse sind 10 Versuche in 15 Minuten möglich. Das Limit teilt sich die API mit der Startcode-Eingabe in Web und App. Eine erfolgreiche Verbindung setzt den Zähler zurück. Bei 429 steht die Wartezeit in Sekunden nur im Feld retry_after im Body, nicht im Header.
Standort nachreichen
Hast du den RIP Tag ohne Koordinaten verbunden, kannst du den Standort der Anbringung nachträglich speichern. Schicke dazu denselben Endpunkt mit action:
Parameter | Typ | Pflicht | Beschreibung |
| String | ja |
|
| String | ja | Startcode des verbundenen RIP Tags |
| Number | ja | Breitengrad (−90 bis 90) |
| Number | ja | Längengrad (−180 bis 180) |
curl -X POST https://de.rip-app.business/api/public/v1/cases/3f8c2a91-6d4e-4b7a-9c15-8e2f0b6d1a47/tag \
-H "Authorization: Bearer $RIP_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"action": "store_activation_location",
"startcode": "K7M2-9QXA",
"latitude": 52.516276,
"longitude": 13.277041
}'
Antwort 200 OK mit message Standort übernommen und denselben Feldern wie oben. Konnte der Standort nicht gespeichert werden, lautet die Meldung Standort nicht übernommen und location_stored ist false.
Code |
| Ursache |
|
| Koordinaten fehlen oder sind ungültig |
|
| Es ist noch kein RIP Tag verbunden |
Einen RIP Tag trennst du über die API nicht direkt. Beim Abschließen wird er automatisch getrennt.
Link für Angehörige
Jeder Trauerfall hat einen Link, den Angehörige ohne Anmeldung öffnen:
https://de.rip-app.business/t/3f8c2a91-6d4e-4b7a-9c15-8e2f0b6d1a47
Du findest ihn in jeder Antwort mit einem Trauerfall im Feld customer_link_url – schon direkt nach dem Anlegen. Baue den Link nicht selbst zusammen, sondern übernimm customer_link_url. Ältere Links im Format /trauerfall/{uuid} leiten weiterhin auf die neue Adresse weiter.
Der Link funktioniert, solange der Fall nicht archiviert ist. Was Angehörige dort sehen, steuerst du mit diesen Feldern am Trauerfall:
Feld | Werte | Wirkung |
|
| Karte mit dem Standort des RIP Tags anzeigen |
|
| Genau: Position wie vom RIP Tracker. Ungefähr: nur ein Kreis von ca. 1,5 km – der genaue Punkt verlässt den Server nicht. |
|
| Chat mit deinem Team |
|
| Zugewiesene Mitarbeiter als Ansprechpartner anzeigen |
|
| Shop für Angehörige. Nur mit Modul Endkundenshop, sonst |
Unabhängig davon zeigt der Link Name und Adresse des Standorts (branch_id), öffentliche Termine (is_public: 1) und öffentliche Prozessschritte. Nach dem Abschluss zeigt die Karte die Ruhestätte und die burial_note.
Beispiel: Standort nur ungefähr zeigen und Chat einschalten
curl -X PATCH https://de.rip-app.business/api/public/v1/cases/3f8c2a91-6d4e-4b7a-9c15-8e2f0b6d1a47 \
-H "Authorization: Bearer $RIP_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "map_mode": "approximate", "feature_chat_enabled": 1 }'
Die Standardwerte für neue Fälle legst du unter Einstellungen → Kundenlink fest.
Ob Angehörige den Link schon geöffnet haben, zeigen link_visit_count und link_last_visit_at im Trauerfall.
Komplettes Beispiel
Fall anlegen, RIP Tag verbinden und den Link weitergeben – in Node.js 18+:
const BASE_URL = "https://de.rip-app.business/api/public/v1";
const headers = {
Authorization: `Bearer ${process.env.RIP_API_KEY}`,
"Content-Type": "application/json",
};
async function call(method, path, body) {
const res = await fetch(`${BASE_URL}${path}`, {
method,
headers,
body: body ? JSON.stringify(body) : undefined,
});
const json = await res.json();
if (!json.success) throw new Error(`${res.status} ${path}: ${json.error}`);
return json.data;
}
// 1. Trauerfall anlegen
const created = await call("POST", "/cases", {
first_name: "Gisela",
last_name: "Neumann",
date_of_death: "2026-11-10",
burial_type_id: 6,
map_mode: "approximate",
});
// 2. RIP Tag verbinden
await call("POST", `/cases/${created.uuid}/tag`, { startcode: "K7M2-9QXA" });
// 3. Aktuellen Stand holen und Link weitergeben
const current = await call("GET", `/cases/${created.uuid}`);
console.log(current.tag_startcode); // "K7M2-9QXA"
console.log(current.current_step_index); // 0, falls der erste Schritt den Trigger „RIP Tag“ hat
console.log(current.customer_link_url); // https://de.rip-app.business/t/…