Datentypen

Aktualisierte Januar 23^rd, 2023

Ergebnisse, die für data der API zurückgegeben werden, geben Informationen in einem der unten beschriebenen Formate zurück.

Ergebnis Nutzlast

Attribute

Die Stammstruktur der Daten-JSON-Nutzdaten weist die folgenden Attribute auf.

Name	Art	Bezeichnung
`data`	Liste von Datenobjekten	Die von der Quelle abgerufenen Daten.
`metadata`	Metadaten-Objekt	Metadaten im Zusammenhang mit `data` .

Metadaten

Attribute

Name	Art	Bezeichnung
`count`	int	Die Anzahl der Objekte in `data` .

Datei

Der file - Datentyp wird in der gesamten API gesehen, da es ein Verweis auf eine Datei ist , die von der API durch eine heruntergeladen werden kann files Typ Umfrage.

Attribute

Name	Typ	Bezeichnung
`id`	Schnur	Bezeichner, der verwendet wird, um die Datei von der API anzufordern. Die Eindeutigkeit des Wertes ist nur im Rahmen der aktuellen Quelle gewährleistet.
`data_type`	Zeichenfolge, immer `file`	Datentypbezeichner.
`name`	Schnur	Der Name der Datei ohne die Erweiterung.
`extension`	Zeichenfolge, optional	Die Erweiterung der Datei, falls verfügbar.
`mime_type`	Zeichenfolge, optional	Der MIME-Typ der Datei, falls verfügbar.
`size`	int, optional	Die Größe der Datei, falls verfügbar.
`checksum`	Zeichenfolge, optional	Die MD5-Prüfsumme, falls verfügbar.

Beispiel

{
  "id": "abc123",
  "data_type": "file",
  "name": "IMG_0003",
  "extension": "jpg",
  "mime_type": "image/jpeg",
  "size": 2505426,
}

Bild

Erweitert die Datei .

Name	Typ	Bezeichnung
`filename`	Schnur	Der ursprüngliche Dateiname der Datei. Die Erweiterung in diesem Dateinamen muss mit der Erweiterung der Datei übereinstimmen.
`filepath`	Schnur	Der Pfad der Datei relativ zu anderen Dateien innerhalb ihres Dienstes. Beispielsweise der Pfad innerhalb eines Backups.
`width`	int, optional	Die Breite der Datei, falls verfügbar.
`height`	int, optional	Die Höhe der Datei, falls verfügbar.

Beispiel

{
  "id": "abc123",
  "data_type": "image",
  "filename": "IMG_0003.JPG",
  "filepath": "Media/DCIM/100APPLE/IMG_0003.JPG",
  "name": "IMG_0003",
  "extension": "jpg",
  "mime_type": "image/jpeg",
  "width": 3000,
  "height": 2002,
  "size": 2505426,
}

Video

Erweitert die Datei .

Name	Typ	Bezeichnung
`filename`	Schnur	Der ursprüngliche Dateiname der Datei. Die Erweiterung in diesem Dateinamen muss mit der Erweiterung der Datei übereinstimmen.
`filepath`	Schnur	Der Pfad der Datei relativ zu anderen Dateien innerhalb ihres Dienstes. Beispielsweise der Pfad innerhalb eines Backups.
`width`	int, optional	Die Breite der Datei, falls verfügbar.
`height`	int, optional	Die Höhe der Datei, falls verfügbar.
`duration`	int, optional	Die Länge des Videos, falls verfügbar.

Beispiel

{
  "id": "abc123",
  "data_type": "video",
  "filename": "IMG_0009.MOV",
  "filepath": "Media/DCIM/100APPLE/IMG_0009.MOV",
  "name": "IMG_0009",
  "extension": "mov",
  "mime_type": "video/quicktime",
  "width": 1920,
  "height": 1080,
  "size": 5421796,
  "duration": 9.135623
}

Botschaft

Attribute

Name	Typ	Bezeichnung
`id`	Schnur	Ein eindeutiger Bezeichner für die Nachricht. Verwenden Sie dies, um zurückgegebene Daten bei Bedarf zu deduplizieren.
`data_type`	Zeichenfolge, immer `message`	Datentypbezeichner.
`type`	Zeichenfolge, optional	Wird verwendet, wenn ein Nachrichtendienst eine Vielzahl von Nachrichtentypen verarbeitet. Zum Beispiel `SMS` und `iMessage` im Fall von iOS-Nachrichten.
`handle`	Schnur	Der 2. Gesprächspartner.
`contact`	verschachtelter Kontakt, optional	Ein Objekt, das auf einen iOS-Kontakt des zweiten Gesprächspartners verweist.
`conversation_id`	Schnur	Identifizierer, der Nachrichten nach Konversation gruppiert.
`from_me`	bool	Ob die Nachricht gesendet oder empfangen wurde.
`user`	Zeichenfolge, optional	Der Benutzer der Messaging-App in dem Fall, in dem mehrere Benutzer/Konten möglicherweise eine Messaging-App von dem Gerät verwenden.
`text`	Schnur	Der Nachrichtentext.
`attachments`	Liste der Dateien, optional	Ein Array von `file_id` Werten, die mit der `download_file` -Methode verwendet werden können. Wenn die Nachricht keinen Anhang enthält, wird ein leeres Array zurückgegeben.
`group`	Zeichenfolge, optional	Der Name der Gruppe zum Zeitpunkt des Sendens der Nachricht .
`group_id`	Zeichenfolge, optional	Die eindeutige Kennung für die Gruppe im Kontext dieser App. Dies darf keine Ganzzahl sein und stellt, falls vorhanden, nur Informationen zusätzlich zu `conversation_id` bereit.
`group_handles`	Liste von Zeichenfolgen, optional	Dieser Wert ist `null` für Nachrichten von Person zu Person und in Gruppenunterhaltungen ein Array von Zeichenfolgen, die Telefonnummern oder iMessage-E-Mail-Adressen darstellen.
`group_contacts`	Zeichenfolge, optional	Ein Array von Objekten, die auf iOS-Kontakte in der Gruppe verweisen.
`deleted`	bool, optional	Ein boolescher Wert, der angibt, ob die Nachricht gelöscht wurde.
`date`	Terminzeit	Wann die Nachricht gesendet oder empfangen wurde.
`date_edited`	datetime, optional	Wann eine Nachricht zuletzt bearbeitet wurde, falls zutreffend.
`date_deleted`	datetime, optional	Wenn eine Nachricht gelöscht wurde, falls zutreffend.

Nachrichtenhandles und Konversationen

Die Datenextraktoren der API unterstützen eine historisch breite Palette von Quelldaten und werden viel Arbeit leisten, um Daten neu auszurichten, die im Laufe der Zeit durch App- und iOS-Updates fragmentiert wurden. Wenn Messaging-Apps neue Funktionen hinzufügen, achten sie nicht immer darauf, dass die zugrunde liegenden Daten perfekt in die neue Struktur migriert werden. Daher muss die API bestimmte Informationen ableiten, um konsistente Daten beizubehalten.

Ein solcher Fall ist für Handles und Konversationsinformationen, die von Messaging-Apps zurückgegeben werden, und insbesondere für das ios_messages.messages . Die API füllt „ conversation_id “ entweder mit einem numerischen Bezeichner, wenn solche Informationen vorhanden sind oder abgeleitet werden können, oder greift auf die Verwendung des Handles der zweiten Partei zurück, um „ conversation_id “ festzulegen. Daher ist es empfehlenswert, dieses Feld zu verwenden, um Nachrichten aus demselben Chat zusammenzufassen.

Bearbeitete und gelöschte Nachrichten

Hinweis: Dieser Abschnitt bezieht sich nicht auf das Wiederherstellen von Nachrichten, wodurch gelöschte oder dereferenzierte Datenbankeinträge wiederhergestellt werden, sondern eher auf Fälle, in denen die betreffende App Funktionen zum Bearbeiten und Löschen von Nachrichten implementiert, z. B. Nachrichten ab iOS 16.

Die API gibt Informationen zu bearbeiteten und gelöschten Nachrichten für das Modul ios_messages.messages für Sicherungen zurück, die unter iOS 16 und höher erstellt wurden. Bei bearbeiteten Nachrichten beschränkt sich dies derzeit auf die Rückgabe des endgültigen Nachrichtentextes und des Zeitpunkts, zu dem dies geschah. Für gelöschte Nachrichten sind Informationen nur verfügbar, solange die Nachricht noch wiederherstellbar ist, was Apple zufolge 30 bis 40 Tage nach dem Löschen dauert .

Beispiel

{
  "id": "a1b2c3d4",
  "data_type": "message",
  "type": "SMS",
  "handle": "vodafone",
  "conversation_id": "w6x7y8z9",
  "from_me": false,
  "text": "Hi from Vodafone!",
  "attachments": [],
  "group_handles": [
    "+441234567890",
    "renate@reincubate.com"
  ],
  "deleted": false,
  "date": "2020-01-01T00:00:00.000000Z"
}

Konversation

Ein Konversationsthread.

Name	Typ	Bezeichnung
`id`	Schnur	Artikel-ID.
`data_type`	Schnur, immer `conversation`	Elementdatentyp-ID.
`group`	optionale Zeichenfolge	Name der Gruppe.
`members`	Liste der `contact`	Teilnehmer am Gespräch.

Kontakt

contact

Name	Typ	Bezeichnung
`id`	Schnur	Artikel-ID.
`data_type`	Schnur, immer `contact`	Elementdatentyp-ID.
`name`	optionale Zeichenfolge	Der vollständige Name des Kontakts.
`first_name`	optionale Zeichenfolge	Der Vorname des Kontakts.
`middle_name`	optionale Zeichenfolge	Der zweite Vorname des Kontakts.
`last_name`	optionale Zeichenfolge	Der Nachname des Kontakts.
`prefix`	optionale Zeichenfolge	Das Namenspräfix des Kontakts.
`suffix`	optionale Zeichenfolge	Das Namenssuffix des Kontakts.
`nickname`	optionale Zeichenfolge	Der Spitzname des Kontakts.
`records`	Liste von `contact.record`	Dem Kontakt zugeordnete Kontaktdatensätze.
`organisation`	optionale Zeichenfolge	Der Organisationsname des Kontakts.
`department`	optionale Zeichenfolge	Die Abteilung des Kontakts innerhalb der Organisation.
`jobtitle`	optionale Zeichenfolge	Die Berufsbezeichnung des Kontakts innerhalb der Organisation.
`birthday`	optionales Datum	Geburtstag des Kontakts.

Attribut contact.record

Es gibt 5 Arten von Kontaktdatensätzen: Phone , Email , URL , Social und Address . Sie entsprechen einer Telefonnummer, einer E-Mail-Adresse, einer Website-URL, einem Handle für ein Social-Media-Konto und einer Straße.

Die ersten 4 haben die gleichen Attribute:

Name	Typ	Bezeichnung
`type`	Schnur	Einer von: `Phone` , E- `Email` , `URL` , `Social` .
`name`	optionale Zeichenfolge	Die dem Datensatz zugeordnete Bezeichnung.
`value`	Schnur	Der Wert des Datensatzes.

Die Address Kontakt Satzart hat zusätzliche Adressfelder:

Name	Typ	Bezeichnung
`type`	Zeichenfolge, immer `Address`	Ein Telefonnummern-Datensatz.
`name`	optionale Zeichenfolge	Die der Nummer zugeordnete Bezeichnung.
`CountryCode`	optionale Zeichenfolge	Ein Ländercode.
`Country`	optionale Zeichenfolge	Ein Ländername.
`ZIP`	optionale Zeichenfolge	Eine Postleitzahl.
`State`	optionale Zeichenfolge	Ein Staatsname oder eine Abkürzung.
`City`	optionale Zeichenfolge	Ein Städtename.
`Municipality`	optionale Zeichenfolge	Ein Gemeindename.
`SubLocality`	optionale Zeichenfolge	Ein Nachbarschafts- oder Bereichsname.
`Street`	optionale Zeichenfolge	Ein Straßenadressenname.

Beispieldaten

{
  "id": "2cf6a837304d6614",
  "data_type": "contact",
  "first_name": "John",
  "middle_name": "'Gala'",
  "last_name": "Appleseed",
  "prefix": "Mr.",
  "suffix": "Jr.",
  "nickname": "John'o",
  "records": [
    {
      "type": "Phone",
      "name": "MAIN",
      "value": "1-800-MY-APPLE"
    },
    {
      "type": "Phone",
      "name": "UK",
      "value": "0800 039 1010"
    },
    {
      "type": "URL",
      "name": "HOMEPAGE",
      "value": "http://www.apple.com"
    },
    {
      "type": "URL",
      "name": "HOMEPAGE",
      "value": "http://www.apple.com/uk/"
    },
    {
      "City": "Cupertino",
      "State": "CA",
      "ZIP": "95014",
      "name": "WORK",
      "CountryCode": "US",
      "Country": "United States",
      "Street": "1 Infinite Loop",
      "type": "Address",
      "SubLocality": null,
      "Municipality": null
    }
  ],
  "organisation": "Apple Inc.",
  "department": "Marketing",
  "jobtitle": "VP Juicing",
  "birthday": "1976-04-01"
}

Anruf

Attribute

Name	Typ	Bezeichnung
`id`	Schnur	Artikel-ID.
`data_type`	Zeichenfolge, immer `call`	Elementdatentyp-ID.
`call_type`	Schnur	Einer von: `Phone` , `FaceTime Video` , `FaceTime Audio` .
`address`	Schnur	Das Ziel des Anrufs. Könnte eine Telefonnummer, eine Apple-ID oder eine andere Kennung sein.
`duration`	schweben	Die Dauer des Anrufs.
`answered`	bool	Ob der Anruf beantwortet wurde.
`from_me`	bool	Ob der Anruf abgehend oder ankommend war.
`date`	Terminzeit	Wann der Anruf getätigt wurde.

Beispieldaten

{
  "id": "24116c5b16b85217",
  "data_type": "call",
  "call_type": "Phone",
  "address": "07123456789",
  "duration": 5.131359,
  "answered": false,
  "from_me": true,
  "date": "2015-07-20 10:23:27.538011"
}

Veranstaltung

event

Name	Typ	Bezeichnung
`id`	Schnur	Artikel-ID.
`data_type`	Zeichenfolge, immer `event`	Elementdatentyp-ID.
`unique_identifier`	optionale Zeichenfolge	Element-UID zum Deduplizieren über mehrere Ereignisdatenquellen hinweg.
`calendar`	optionale Zeichenfolge	Kalendername.
`calendar_uid`	optionale Zeichenfolge	Kalender-UID.
`calendar_store`	optionale Zeichenfolge	Typ des Kalenderspeichers, dh `iCloud` , `Default` .
`summary`	optionale Zeichenfolge	Die Zusammenfassung oder der Titel des Ereignisses.
`description`	optionale Zeichenfolge	Die Ereignisbeschreibung.
`start_date`	optionale Datumszeit	Wenn die Veranstaltung beginnt.
`end_date`	optionale Datumszeit	Wenn die Veranstaltung endet.
`start_time_zone`	optionale Zeichenfolge	Die Zeitzone von `start_date` .
`end_time_zone`	optionale Zeichenfolge	Die timeone von `end_date` .
`all_day`	boolesch	Ob die Veranstaltung einen ganzen Tag dauert.
`travel_time`	optionale Dauer	Die Reisezeitdauer des Ereignisses.
`recurrence`	optionales verschachteltes `event.recurrence`	Die Wiederholungseinstellungen des Ereignisses.
`location`	optionale Zeichenfolge	Wo die Veranstaltung stattfindet.
`start_location`	optionale Zeichenfolge	Wo die Veranstaltung beginnt.
`attendees`	optionale Liste von Zeichenfolgen	Namen der Veranstaltungsteilnehmer.
`attached_url`	optionale Zeichenfolge	Eine dem Ereignis zugeordnete URL.
`creation_date`	optionale Datumszeit	Wann das Ereignis erstellt wurde. Nicht gesetzt, wenn Standard-Kalendereintrag, z. B. Feiertage.

event.recurrence Attribute

Name	Typ	Bezeichnung
`interval`	ganze Zahl	Die Anzahl der `repeat` , die wiederholt werden sollen, dh 1 Jahr (einmal alle 1 Jahr).
`repeat`	Schnur	Einer von: `OneTime` , `Daily` , `Weekly` , `Monthly` , `Yearly` .
`repeat_end_date`	optionale Datumszeit	Wann aufhören, sich zu wiederholen.

Beispieldaten

{
  "id": "3",
  "unique_identifier": "f5fcf872-34f6-3f60-ba03-74d5a7a3bbbb",
  "calendar": "Home",
  "calendar_id": "477a2001537fe178d6b77cdceb8bac2e",
  "calendar_store": "Default",
  "summary": "Christmas Day",
  "description": "Bank holiday in the UK",
  "start_date": "2017-12-25T00:00:00.000000",
  "end_date": "2017-12-25T23:59:59.000000",
  "start_time_zone": None,
  "end_time_zone": None,
  "all_day": True,
  "travel_time": None,
  "recurrence": {
    "interval": 1,
    "repeat": "Yearly",
    "repeat_end_date": None,
    "specifier": ""
  },
  "location": None,
  "start_location": None,
  "attendees": ["John Appleseed"],
  "attached_url": None,
  "creation_date": None
}

Hinweis

{
  "title": "Monday meeting:",
  "note": "Monday meeting:\n Discuss X,\n discuss Y.",
  "summary": null,
  "folder": "icloud",
  "sub_folder": "work",
  "attachments": [
    {
      "type": "image",
      "file_id": "8e22cf6e524357b4eb3da775d193072ebba9543f",
      "file_path": "Media/80DDDEAD-B33F-37B2-7219432C0359/Image.jpeg"
    }
  ],
  "creation_date": "2016-06-06 13:23:20.000000",
  "last_modified": "2016-06-07 15:21:25.000000"
}

Besuch

Eine Aufzeichnung eines Website-Seitenbesuchs.

Attribute

Name	Typ	Bezeichnung
`data_type`	Schnur, immer `visit`	Elementdatentyp-ID.
`url`	Schnur	Die URL der besuchten Seite.
`title`	Schnur	Der Titel der besuchten Seite.
`date_created`	Terminzeit	Wann der Besuch stattfand.

{
  "data_type": "visit",
  "url": "https://reincubate.com/",
  "title": "Reincubate: the app data company",
  "date_created": "2020-01-01T00:00:00.000000Z"
}

Plätzchen

Ein HTTP-Cookie.

Attribute

Name	Typ	Bezeichnung
`data_type`	Zeichenfolge, immer `cookie`	Elementdatentyp-ID.
`name`	Schnur	Der Name des Cookies.
`value`	Schnur	Der Wert des Cookies.
`domain`	Schnur	Der Domänenbezeichner des Cookies.
`path`	Schnur	Der Pfadbezeichner des Cookies.
`flags`	Schnur	Alle auf dem Cookie gesetzten Flags.
`creation_date`	Terminzeit	Wann das Cookie erstellt wurde.
`expiry_date`	Terminzeit	Wenn das Cookie abläuft.

{
  "data_type": "cookie",
  "name": "sample_cookies",
  "value": "sample_value",
  "domain": "reincubate.com",
  "path": "/",
  "flags": "",
  "creation_date": "2020-01-01T00:00:00.000000Z",
  "expiry_date": "2020-01-01T00:00:00.000000Z"
}

Standort

Datenattribute

Name	Typ	Bezeichnung
`data_type`	Zeichenfolge, immer `location`	Eine Datentypkennung.
`latitude`	schweben	Die Breitenkoordinate des Standorts.
`longitude`	schweben	Die Längenkoordinate des Standorts.
`altitude`	schweben	Die Höhenkoordinate des Standorts.
`horizontal_accuracy`	schweben	Die horizontale Genauigkeit für die Messung.
`vertical_accuracy`	schweben	Die vertikale Genauigkeit für die Messung.
`position_type`	Schnur	Kennung für das verwendete Messverfahren.
`date_created`	Terminzeit	Wann die Messung durchgeführt wurde.

Beispieldaten

{
  "data_type": "location",
  "latitude": 51.507452392689146,
  "longitude": -0.07398372304584414,
  "altitude": 0.0,
  "horizontal_accuracy": 65.0,
  "vertical_accuracy": 0.0,
  "positioning_type": "Wifi",
  "date_created": "2020-01-01T00:00:00.000000Z"
}

Ergebnis Nutzlast

Metadaten

Datei

Bild

Video

Botschaft

Nachrichtenhandles und Konversationen

Bearbeitete und gelöschte Nachrichten

Konversation

Kontakt

Anruf

Veranstaltung

Hinweis

Besuch

Plätzchen

Standort

Wie können wir helfen?