Relay-Service erneut inkubieren

Aktualisierte
Cover image for: Relay-Service erneut inkubieren

Sitzungen

Ein Pairing-Prozess wird verwendet, um eine Verbindung zwischen einem Benutzer der API und einer App-Instanz von Reincubate Relay herzustellen. Standardmäßig zeigt das Reincubate Relay seinen Pairing-Code an, wenn es nicht gepaart ist. Der Benutzer muss dies Ihrer Anwendung mitteilen, damit diese über den folgenden Aufruf eine gültige Sitzung erstellt.

curl https://ricloud-api.reincubate.com/sessions \
  -X POST \
  -H 'Authorization: Token <your key_token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "source": {
    "user": "1",
    "type": "rirelay.instance"
  },
  "payload": {
    "code": "<Reincubate Relay pairing code>"
  }
}'

Sobald die Sitzung erstellt wird, werden Sie in der Lage sein , Informationen über die App - Instanz über die Sitzung des Objekts anzuzeigen source Attribut. Das sollte ungefähr so aussehen:

{
  "id": "<session ID>",
  "resource": "session",
  ...
  "source": {
    "id": "<source ID>",
    "resource": "source",
    "user": "<user ID>",
    "type": "rirelay.instance",
    "identifier": "ee360f13-1b54-4d8c-8876-e5f573f0ba1c",
    "info": null,
    "parent": null,
    "children": {
      "data": [
        {
          "id": "<child source ID>",
          "resource": "source",
          "user": "<user ID>",
          "type": "rirelay.source",
          "identifier": "70a4982e-5893-4a5f-8af6-19db834d378d",
          "info": {
            "is_encrypted": true,
            "apple_model_id": "iPhone10,4",
            "apple_serial": "FFABCZGTJC12",
            "name": "iPhone 8",
            "ios_version": "13.2"
          },
          "children": {
            "data": [],
            "has_more": false,
            "total_count": 0,
            "url": "/sources/<child source ID>/children"
          },
          "state": "active",
          "date_created": "2019-10-08T09:02:15.770532Z"
        }
      ],
      "has_more": false,
      "total_count": 0,
      "url": "/sources/<source ID>/children"
    },
    "state": "active",
    "date_created": "2019-10-08T08:58:33.861941Z"
  },
  ...
}

Abonnements

Im Gegensatz zu anderen Diensten ist ein Abonnement erforderlich, bevor die API mit dem Abrufen von Daten von einer Reincubate Relay-Quelle beginnen kann. Dies soll dem Benutzer der App helfen, genau zu verstehen, auf welche Daten zugegriffen wird.

Abonnements können nur für Quellen des Typs rirelay.source werden, bei denen es sich um untergeordnete Elemente der Reincubate Relay-Instanz handelt. Die Sitzung, die beim Abfragen der Quelle verwendet werden soll, muss ebenfalls angegeben werden.

curl https://ricloud-api.reincubate.com/subscriptions \
  -X POST \
  -H 'Authorization: Token <your key_token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "session": "<session ID>",
  "source": "<child source ID>",
  "poll_payload": {
    "data_types": ["ios_messages.messages"]
  }
}'

Das Abonnement bleibt in einem ausstehenden Zustand, bis der Benutzer Zugriff auf das bestimmte Gerät in der Benutzeroberfläche der Reincubate Relay-App gewährt hat. Sobald dies erlaubt ist, wechselt der Status zu active .

Bei der Aktivierung des Abonnements wird sofort eine erste Umfrage erstellt. Nachfolgende Umfragen werden erstellt, wenn die Reincubate Relay-App die API über neue Daten benachrichtigt.

Umfragen

Umfragen können auch manuell für Quellen mit aktiven Abonnements erstellt werden. Dies ist hilfreich bei der Fehlerbehebung bei abgerufenen Daten oder beim Testen neuer Datentypen.

curl https://ricloud-api.reincubate.com/polls \
  -X POST \
  -H 'Authorization: Token <your key_token>' \
  -H 'Content-Type: application/json' \
  -d '{
  "subscription": "<subscription ID>",
  "payload": {
    "data_types": ["ios_phone.calls", "whatsapp.messages"]
  }
}'

Veranstaltungen

Um über asynchrone Änderungen auf dem Laufenden zu bleiben, z. B. wenn ein Abonnement eine neue Umfrage erstellt oder eine Sitzung abläuft, muss Ihre Implementierung Ereignisbenachrichtigungen von der API über einen Webhook-Endpunkt empfangen.

Ausführliche Informationen zum Einrichten und Konfigurieren Ihres Webhook-Endpunkts finden Sie unter Konfigurieren von Webhooks .

Infotypen

Der Relay-Dienst unterstützt derzeit nur das Abrufen von Informationen aus rirelay.instance Quellen, einschließlich verschachtelter Informationen zu allen zugehörigen rirelay.source Quellen.

rirelay.instance.info Attribute

Name Typ Bezeichnung
id Quell-ID ID des Quellobjekts, das dieser Relaisinstanz entspricht.
version str Version der Reincubate Relay-App.
os str Kennung des Betriebssystems, auf dem die Reincubate Relay-App ausgeführt wird.
sources Liste von rirelay.source.info Liste der Quellen, die der Instanz zugeordnet sind.
date_created Terminzeit Datum/Uhrzeit, als diese Instanz zum ersten Mal gesehen wurde.
date_last_seen Terminzeit Datum/Uhrzeit, wann diese Instanz zuletzt gesehen wurde.

Attribute von rirelay.source.info

Name Typ Bezeichnung
id Quell-ID ID des Quellobjekts, das dieser Relaisquelle entspricht.
uid str Die eindeutige iOS-Geräte-ID der Relaisquelle.
info verschachtelte rirelay.source.info.info Metadaten für diese Relaisquelle.
date_created Terminzeit Datum, an dem diese Quelle zum ersten Mal gesehen wurde.
date_last_seen Terminzeit Datum/Uhrzeit, wann diese Quelle zuletzt gesehen wurde.

Attribute von rirelay.source.info.info

Beachten Sie, dass name , ios_version , apple_model_id , apple_serial und is_encrypted , sind auch in den enthaltenen verschachtelten info Daten auf Source und sind daher zugänglich direkt über API - Endpunkte.

Für andere Attribute wie phone_number ist eine vollständige Abfrage von rirelay.instance.info erforderlich – da es sich um personenbezogene Daten handelt, die nicht von der API gespeichert werden.

Name Typ Bezeichnung
name str Name der Relaisquelle. Verfügbar in Source.info .
ios_version str Version von iOS, die auf der Relaisquelle ausgeführt wird, dh 13.4 . Verfügbar in Source.info .
apple_model_id str Modell-ID der iPhone7,2 . Verfügbar in Source.info .
apple_serial str Seriennummer der F4KPWDR7G5DN . Verfügbar in Source.info .
phone_number optional, str Telefonnummer der Relaisquelle. Wird leer sein, wenn die Mobilfunkfunktion auf dem Gerät nicht aktiviert ist (dh keine SIM oder nur Wi-Fi).
is_encrypted bool Ob die Relaisquelle so eingestellt ist, dass verschlüsselte Backups erstellt werden. Verfügbar in Source.info .

Datentypen

Relay-App-Datentypen neu inkubieren

Kennung Bezeichnung
ios_messages.messages Ruft iOS-Nachrichtendaten einschließlich iMessage und SMS ab.
ios_contacts.contacts Ruft iOS-Kontaktdaten ab.
ios_phone.calls Ruft iOS-Telefondaten ab.
ios_calendar.events Ruft iOS-Kalenderdaten ab.
ios_notes.notes Ruft iOS Notes-Daten ab.
ios_health.data Ruft iOS-Gesundheitsdaten ab.
ios_safari.history Ruft die Verlaufsdaten des Safari-Browsers ab.
ios_safari.cookies Ruft Safari-Cookie-Daten ab.
whatsapp.messages Ruft WhatsApp-Nachrichten ab.
whatsapp.calls Ruft den WhatsApp-Anrufverlauf ab.
viber.messages Ruft Viber-Nachrichten ab.
viber.calls Ruft den Viber-Anrufverlauf ab.
viber.conversations Ruft Viber-Gespräche ab.
viber.contacts Ruft Viber-Kontakte ab.
kik.messages Ruft Kik-Nachrichten ab.
kik.contacts Ruft Kik-Kontakte ab.
hike.messages Ruft Hike-Nachrichten ab.
hike.posts Ruft Wanderposts ab.
wechat.messages Ruft WeChat-Nachrichten ab.
tinder.messages Ruft Tinder-Nachrichten ab.
line.messages Ruft Line-Nachrichten ab.
facebook.messages Ruft Facebook-Nachrichten ab.
snapchat.messages Ruft Snapchat-Nachrichten ab.
snapchat.stories Ruft Snapchat-Geschichten ab.
skype.messages Ruft Skype-Nachrichten ab.

Aggregierte Relay-Datentypen neu inkubieren

Kennung Bezeichnung
.photos Durchsucht das Backup nach Bilddateien.
.videos Durchsucht das Backup nach Videodateien.
.recordings Durchsucht das Backup nach Aufnahmedateien.
.voicemails Durchsucht das Backup nach Voicemail-Dateien.
.app_usage Durchsucht das Backup nach Informationen zur App-Nutzung.
.installed_apps Durchsucht das Backup nach installierten App-Informationen.
.locations Durchsucht das Backup nach Speicherorten.
.linked_watches Durchsucht das Backup nach verknüpften Apple Watch-Informationen.

iOS-Nachrichten

Mitteilungen

Datentyp-ID ios_messages.messages

Datenattribute

Erweitert den message .

Beispieldaten

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

iOS-Kontakte

Kontakte

Datentyp-ID ios_contacts.contacts

Datenattribute

Erweitert den contact .

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 00:00:00.000000Z"
}

iOS-Telefon

Anrufe

Datentyp-ID ios_phone.calls

Datenattribute

Erweitert den call

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"
}

iOS-Kalender

Veranstaltungen

Datentyp-ID ios_calendar.events

Datenattribute

Erweitert den event .

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
}

iOS-Hinweise

Anmerkungen

Datentyp-ID ios_notes.notes

Datenattribute

Erweitert den note .

iOS Gesundheit

Daten, die mit der iOS Health-App und dem HealthKit-Framework verknüpft sind.

Daten

Datentyp-ID ios_health.data

ios_health.profile Attribute

Name Typ Bezeichnung
info_type Zeichenfolge, immer ios_health.profile Artikeldatentyp-ID.
gender optionale Zeichenfolge Einer von: Female , Male , Other .
date_of_birth optionales Datum Das Geburtsdatum des Profilinhabers.
weight optionaler Schwimmer Die Gewichtsmessung des Profilinhabers in Kilogramm.
height optionaler Schwimmer Die Körpergröße des Profilinhabers in Metern.
blood_type optionale Zeichenfolge Die Blutgruppe des Profilinhabers.
fitzpatrick_skin_type optionale Zeichenfolge Der Fitzpatrick-Hauttyp des Profilinhabers. Einer von: Type I , Type II , Type II , Type IV , Type V

ios_health.profile Beispiel

{
  "info_type": "ios_health.profile",
  "gender": "Female",
  "date_of_birth": "1988-08-22",
  "weight": 75.2543977,
  "height": 1.9812,
  "blood_type": "O+",
  "fitzpatrick_skin_type": "Type V"
}

ios_health.sample Attribute

Name Typ Bezeichnung
id Schnur Artikel-ID.
data_type Schnur Artikeldatentyp-ID. Einer der iOS-Gesundheitsdatentypen.
type Schnur Beispielstyp. Einer von: quantity , binary , category .
value einer von string, float, integer Beispielwert. Die Art dieses Feldes ist abhängig vom type - Attribute.
unit optionale Zeichenfolge Legen Sie fest, ob es sich um eine nicht standardmäßige Probeneinheit handelt.
was_user_entered boolesch Ob der Benutzer diese Messung manuell eingegeben hat.
start_date Terminzeit Als die Probenahmeperiode begann.
end_date Terminzeit Wenn der Probenahmezeitraum endete.

iOS Health-Datentypen:

  • ios_health.body_mass_index
  • ios_health.body_fat_percentage
  • ios_health.height
  • ios_health.weight
  • ios_health.lean_body_mass
  • ios_health.heart_rate
  • ios_health.steps
  • ios_health.walking_running_distance
  • ios_health.resting_energy
  • ios_health.active_energy
  • ios_health.flights_climbed
  • ios_health.oxygen_saturation
  • ios_health.blood_glucose
  • ios_health.systolic_blood_pressure
  • ios_health.diastolic_blood_pressure
  • ios_health.blood_alcohol_content
  • ios_health.peripheral_perfusion_index
  • ios_health.total_fat
  • ios_health.polyunsaturated_fat
  • ios_health.monounsaturated_fat
  • ios_health.saturated_fat
  • ios_health.dietary_cholesterol
  • ios_health.sodium
  • ios_health.carbohydrates
  • ios_health.fibre
  • ios_health.dietary_sugar
  • ios_health.dietary_energy
  • ios_health.protein
  • ios_health.vitamin_a
  • ios_health.vitamin_b6
  • ios_health.vitamin_b12
  • ios_health.vitamin_c
  • ios_health.vitamin_d
  • ios_health.vitamin_e
  • ios_health.vitamin_k
  • ios_health.calcium
  • ios_health.iron
  • ios_health.thiamine
  • ios_health.riboflavin
  • ios_health.niacin
  • ios_health.folate
  • ios_health.biotin
  • ios_health.pantothenic_acid
  • ios_health.phosphorous
  • ios_health.iodine
  • ios_health.magnesium
  • ios_health.zinc
  • ios_health.selenium
  • ios_health.copper
  • ios_health.manganese
  • ios_health.chromium
  • ios_health.molybdenum
  • ios_health.chloride
  • ios_health.potassium
  • ios_health.number_of_times_fallen
  • ios_health.electrodermal_activity
  • ios_health.inhaler_usage
  • ios_health.respiratory_rate
  • ios_health.body_temperature
  • ios_health.sleep_analysis
  • ios_health.forced_vital_capacity
  • ios_health.forced_expiration_volume_1
  • ios_health.peak_expiratory_flow_rate
  • ios_health.caffeine
  • ios_health.workout
  • ios_health.blood_pressure_correlation
  • ios_health.cycling_distance
  • ios_health.water
  • ios_health.uv_index
  • ios_health.basal_body_temperature
  • ios_health.cervical_mucus_quality
  • ios_health.ovulation_test_results
  • ios_health.menstruation
  • ios_health.spotting
  • ios_health.sexual_activity

Beispieldaten

{
  "id": "a1b2c3d41",
  "data_type": "ios_health.walking_running_distance",
  "type": "quantity",
  "value": 6.08,
  "was_user_entered": false,
  "start_date": "2016-07-04T18:11:54.000000Z",
  "end_date": "2016-07-04T18:12:09.000000Z"
}, {
  "id": "a1b2c3d42",
  "data_type": "ios_health.steps",
  "type": "quantity",
  "value": 8.0,
  "was_user_entered": false,
  "start_date": "2016-07-04T18:11:54.000000Z",
  "end_date": "2016-07-04T18:12:09.000000Z"
}, {
  "id": "a1b2c3d43",
  "data_type": "ios_health.caffeine",
  "type": "quantity",
  "value": 800.0,
  "unit": "mg",
  "was_user_entered": true,
  "start_date": "2016-07-04T18:11:54.000000Z",
  "end_date": "2016-07-04T18:12:09.000000Z"
}

iOS Safari

Geschichte

Datentyp-ID ios_safari.history

Datenattribute

Erweitert den visit Datentyp.

Beispieldaten

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

Kekse

Datentyp-ID ios_safari.cookies

Datenattribute

Erweitert den cookie Datentyp.

Beispieldaten

{
  "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"
}

WhatsApp

Mitteilungen

Datentyp-ID whatsapp.messages

Attribute

Erweitert den message .

Anrufe

Datentyp-ID whatsapp.calls

Attribute

Erweitert den call

Viber

Anrufe

viber.messages Ruft Viber-Nachrichten ab.
viber.calls Ruft den Viber-Anrufverlauf ab.
viber.conversations Ruft Viber-Gespräche ab.
viber.contacts Ruft Viber-Kontakte ab.

Mitteilungen

Datentyp-ID viber.messages

Attribute

Erweitert den message .

Anrufe

Datentyp-ID viber.calls

Attribute

Erweitert den call

Gespräche

Datentyp-ID viber.conversations

Attribute

Erweitert den conversation .

Kontakte

Datentyp-ID viber.contacts

Attribute

Erweitert den contact .

Kik

Mitteilungen

Datentyp-ID kik.messages

Attribute

Erweitert den message .

Kontakte

Datentyp-ID kik.contacts

Attribute

Erweitert den contact .

Wanderung

hike.messages Ruft Hike-Nachrichten ab.
hike.posts Ruft Wanderposts ab.

Mitteilungen

Datentyp-ID hike.messages

Attribute

Erweitert den message .

Beiträge

Datentyp-ID hike.posts

Attribute

Erweitert den message .

WeChat

Mitteilungen

Datentyp-ID wechat.messages

Attribute

Erweitert den message .

Tinder

Mitteilungen

Datentyp-ID tinder.messages

Attribute

Erweitert den message .

Linie

Mitteilungen

Datentyp-ID line.messages

Attribute

Erweitert den message .

Facebook Messenger

Mitteilungen

Datentyp-ID facebook.messenger

Attribute

Erweitert den message .

Snapchat

Mitteilungen

Datentyp-ID snapchat.messages

Attribute

Erweitert den message .

Geschichten

Datentyp-ID snapchat.stories

Attribute

Erweitert den message .

Skype

Mitteilungen

Datentyp-ID skype.messages

Attribute

Erweitert den message .

Wie können wir helfen?

Unser Support-Team hilft Ihnen gerne weiter!

Unsere Bürozeiten sind Montag bis Freitag von 9 bis 17 Uhr GMT. Die Zeit ist aktuell 6:29 vorm. GMT.

Wir bemühen uns, auf alle Mitteilungen innerhalb eines Arbeitstages zu antworten.

Unser großartiges Supportteam

Können wir diesen Artikel verbessern?

Wir hören gerne von Nutzern: Warum schicken Sie uns nicht eine E-Mail, schreiben Sie einen Kommentar oder tweeten Sie @reincubate?

© 2008 - 2022 Reincubate Ltd. Alle Rechte vorbehalten. Registriert in England und Wales #5189175, VAT GB151788978. Reincubate® und Camo® sind eingetragene Marken. Datenschutz-Bestimmungen & Begriffe. Mit Liebe in London gebaut.