Zum Hauptinhalt springen

Public API – RIP Tag und Link für Angehörige

Einen RIP Tag per Startcode mit einem Trauerfall verbinden und den Link für Angehörige abrufen und einstellen.

Verfasst von Support Team

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

POST

/cases/{uuid}/tag

RIP Tag per Startcode verbinden oder Standort nachreichen

GET

/cases/{uuid}

Link für Angehörige und Tag-Daten lesen

PATCH

/cases/{uuid}

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

startcode

String

ja

Startcode, zum Beispiel K7M2-9QXA. Leerzeichen außen und Kleinschreibung sind egal.

latitude

Number

nein

Breitengrad des Orts, an dem der RIP Tag angebracht wurde (−90 bis 90)

longitude

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

tag_uuid

String

Kennung des RIP Tags, danach auch im Trauerfall unter tag_uuid

tag_startcode

String

Startcode in Großbuchstaben

location_stored

Boolean

true, wenn der mitgeschickte Standort gespeichert wurde

Was danach passiert:

  • Der RIP Tag ist aktiviert und gehört zu diesem Fall. Im Trauerfall stehen tag_uuid und tag_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_longitude und tag_last_seen_at.

Fehler

Code

error

Ursache

400

startcode ist erforderlich

startcode fehlt

400

Ungültiges Startcode-Format. Erwartet: XXXX-XXXX

Format stimmt nicht

400

Startcode ungültig

Diesen Startcode gibt es nicht

404

Sterbefall nicht gefunden

UUID des Falls unbekannt

409

Diesem Sterbefall ist bereits ein RIP Tag zugewiesen

Der Fall hat schon einen RIP Tag

409

Dieser Startcode wurde bereits aktiviert

Der RIP Tag hängt an einem anderen Fall

409

Dieser RIP Tag wurde bereits in einem abgeschlossenen Trauerfall verwendet und kann nicht erneut aktiviert werden

RIP Tags sind nur einmal verwendbar

409

Dieser Trauerfall ist bereits abgeschlossen. Es kann kein RIP Tag mehr verbunden werden.

Fall ist abgeschlossen

409

Dieser Trauerfall ist archiviert. Es kann kein RIP Tag mehr verbunden werden.

Fall ist archiviert

429

Zu viele Versuche. Bitte warten Sie 12 Minuten.

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

action

String

ja

store_activation_location

startcode

String

ja

Startcode des verbundenen RIP Tags

latitude

Number

ja

Breitengrad (−90 bis 90)

longitude

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

error

Ursache

400

latitude und longitude sind erforderlich

Koordinaten fehlen oder sind ungültig

404

Diesem Sterbefall ist kein RIP Tag zugewiesen

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

feature_map_enabled

0 oder 1

Karte mit dem Standort des RIP Tags anzeigen

map_mode

exact oder approximate

Genau: Position wie vom RIP Tracker. Ungefähr: nur ein Kreis von ca. 1,5 km – der genaue Punkt verlässt den Server nicht.

feature_chat_enabled

0 oder 1

Chat mit deinem Team

feature_contact_enabled

0 oder 1

Zugewiesene Mitarbeiter als Ansprechpartner anzeigen

feature_shop_enabled

0 oder 1

Shop für Angehörige. Nur mit Modul Endkundenshop, sonst 403.

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/…
Hat dies deine Frage beantwortet?