FamGEN – API-Schnittstelle von FamilySearch (Stand 4.20)

Aktualisierung Weltstammbaum und CET-Projekte

Die API-Schnittstelle verbindet Ihre FamGEN-Eingaben direkt mit dem Weltstammbaum (Family Tree) sowie optional mit CET-Projekten von FamilySearch.

Neben der klassischen Pflege von Personen ermöglicht FamGEN inzwischen auch erweiterte Analysen, DNA-Integration, Dokumentenverwaltung (Memories), Kartenfunktionen und komfortable Arbeitsabläufe – vollständig im Browser, ohne Systemwechsel.

Typische Einsätze (aktualisiert)

• Neue Person anlegen (inkl. erweiterter Fakten wie Geburt, Heirat, Tod, Migration)
• Vorhandene Person per PID aktualisieren
• Beziehungen setzen (Eltern, Ehepartner, Kinder)
• DNA-Probanden dokumentieren (ohne Zuordnungsbehauptungen)
• Dokumente (Memories) direkt zu FamilySearch hochladen
• Auswertungen nach Orten, Ereignissen und Zeiträumen durchführen
• Vorfahren/Nachfahren abrufen und visualisieren (Topola, KML)

Funktionsumfang

1. Stammdaten & API-Operationen

• Neue Person anlegen (inkl. erweiterten Fakten: Geburt, Tod, Heirat, Migration, Beruf, Wohnort)
• Vorhandene Person per PID aktualisieren
• Automatische Normalisierung (z. B. Datum: 20.08.1910 → 20 Aug 1910)
• Laden einer Person (inkl. automatisches Vorbefüllen der Eingabemaske)
• Direkte Navigation zu:
  • Details
  • Quellen
  • Stammbaum
  • Zeitstrahl
  • Erinnerungen (Memories)

2. Verknüpfungen (Relationship-Management)

• Kind ↔ Eltern verknüpfen
• Ehepartner verknüpfen
• Mehrfach-Verknüpfung über Protokoll (Batch-Verarbeitung)
• Komfortsteuerung über Bereich 8 (Zuweisungslogik)
• Sicherheitsmechanismen zur Vermeidung falscher Verknüpfungen

3. Abruf & Analysefunktionen

• Abruf:
  • Vorfahren (n Generationen)
  • Nachfahren (n Generationen)
  • Kombination (Vor- und Nachfahren)
• Direkte Übergabe an:
  • Topola (Stammbaum-Visualisierung)
• Filter- und Auswahlfunktionen im Ergebnisbereich

4. Erweiterte Auswertungen

• Geburten ↔ Ort
• Sterbefälle ↔ Ort
• Trauungen ↔ Ort
• Auswanderungen
• Häufigkeiten von Geburten pro Ort

Funktionen:

• Sortierung nach Datum / Ort / Vorname
• Teilstring-Suche (z. B. Landkreis-Ebene)
• Ergebnisanzeige mit Auswahl- und Filtermöglichkeiten

5. Memories (Dokumentenverwaltung)

• Upload von Dateien (.jpg, .pdf) direkt zu FamilySearch
• Automatische Vorbelegung durch Dateinamen (z. B. Archion-Logik)
• Strukturierte Metadaten:
  • Zeitraum
  • Ort
  • Titel
  • Beschreibung (Caption)
• Unterstützung standardisierter Quellenangaben

6. DNA-Matches Integration

• Verwaltung von DNA-Probanden als Nachfahren
• Unterstützung mehrerer DNA-Portale:
  • GEDmatch
  • MyHeritage
  • Ancestry
  • FTDNA
• Automatische Generierung datenschutzkonformer Notizen
• Tabellenverwaltung von DNA-Matches inkl. Lösch- und Zuordnungsfunktionen

7. Ortsregister & Karten

• Automatisches Ortsregister aus FS-Daten
• Speicherung von:
  • Koordinaten
  • Landkreis / Bundesland
• Kartenfunktionen:
  • Google Earth
  • KML-Export
  • geojson.io
• Integration historischer Karten

8. Favoriten & Protokoll

• Speicherung von bis zu 10 Favoriten
• Protokoll aller Aktionen
• Wiederverwendung von Datensätzen
• Direktzugriff auf FamilySearch-Seiten

9. Stammväter-Verwaltung

• Eigene Tabelle zur Verwaltung genealogischer Linien
• Speicherung:
  • Name
  • PID
  • Geburtsjahr
• Direkte Verknüpfung mit Stammbaumansicht

10. GEDCOM & ADaTP-Integration

• Übergabe an Personen- und Ortssuche, GEDCOM-Generator und Chatbots
• ADaTP als zentrale Datenschnittstelle
• Live-Daten aus FamilySearch (kein Caching)

Vorteile auf einen Blick

• Komplettlösung: Pflege + Analyse + Dokumentation + DNA
• 100 % Browser-basiert (kein Server notwendig)
• Direkte Integration mit FamilySearch
• Erweiterbar für CET-Projekte
• Strukturierte Workflows für sichere Dateneingabe

Typische Einsatzszenarien

• Aufbau genealogischer Linien (inkl. Stammväter)
• Dokumentation mit Quellen (Memories)
• DNA-gestützte Forschung
• Regionale Auswertungen (z. B. Ortsanalysen)
• Visualisierung (Topola, KML)
• Datenexport (GEDCOM)

So nutzen Sie die API (Workflow)

1. Login durchführen
   → OAuth2-Dialog, Statusanzeige aktiv
2. Daten erfassen oder laden
   → manuell oder über GEDCOM / URL
3. Vorprüfung durchführen
   → Dublettenprüfung oder Detailansicht
4. Operation wählen
   • Neuanlage
   • Update
   • Verknüpfung
   • Abruf
   • Auswertung
   • DNA / Memory
5. Änderungsgrund setzen (empfohlen)
   → wird als X-Reason übertragen
6. Operation ausführen
   → Ergebnisanzeige + Statusbanner

Hotkeys & Bedienkomfort

• Umfangreiche Tastatursteuerung (ALT+…)
  • ALT+A → Aktion starten
  • ALT+D → DNA-Matches
  • ALT+M → Memories
  • ALT+T → Topola
  • u. v. m.
• Schneller Zugriff auf alle Bereiche
• Fokussteuerung innerhalb der Maske

Technische Voraussetzungen

• Kostenloses FamilySearch-Konto
• Client-ID (App-ID) einer registrierten FamilySearch-Anwendung
• In der App konfigurierte Redirect-URI (muss exakt der aufgerufenen api.html entsprechen)
• Aktueller Browser (Chrome, Edge, Firefox)

Login & Authentifizierung

• Login erfolgt über OAuth2 mit PKCE direkt im Browser
• Nach Klick auf „Login“ öffnet sich der FamilySearch-Dialog
• Erfolgreicher Login wird durch Statusanzeige bestätigt
• Automatischer Token-Refresh vor Ablauf
• Logout löscht Token vollständig

Datenschutz & Kosten

• Access-Token werden ausschließlich lokal im Browser (localStorage) gespeichert
• Keine Weitergabe an externe Server
• Nutzung der API ist kostenfrei
• Es gelten die offiziellen FamilySearch API-Limits

DNA-Funktion

• Nur pseudonymisierte DNA-IDs
• Keine Abstammungsbehauptungen
• DSGVO-konforme Nutzung durch Datensparsamkeit

Technische Hinweise

Authentifizierung

• OAuth2 PKCE
• Token in localStorage
• Auto-Refresh + Statusanzeige

API

Base: https://api.familysearch.org/platform

Header:

• Authorization: Bearer Token
• Accept / Content-Type: application/x-fs-v1+json
• Optional: X-Reason

Unterstützte Kernoperationen

• createPerson
• updatePerson
• Relationships (Child/Parents, Couple)
• fetchAncestors / fetchDescendants
• fetchPerson