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.

rirelay.instance.info Attribute

Name Art Beschreibung
id Quell-ID ID des Quellobjekts, das dieser Relay-Instanz 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 mit der Instanz verknüpften Quellen.
date_created Terminzeit Datum, an dem diese Instanz zum ersten Mal gesehen wurde.
date_last_seen Terminzeit Datum, an dem diese Instanz zuletzt gesehen wurde.

Attribute von rirelay.source.info

Name Art Beschreibung
id Quell-ID ID des Quellobjekts, das dieser Relaisquelle entspricht.
uid str Die eindeutige iOS-Geräte-ID der Relay-Quelle.
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, an dem diese Quelle zuletzt gesehen wurde.

Attribute von rirelay.source.info.info

Name Art Beschreibung
name str Name der Relaisquelle.
ios_version str Version von iOS, die auf der Relay-Quelle ausgeführt wird, dh 13.4 .
apple_model_id str Modell-ID der iPhone7,2 , dh iPhone7,2 .
apple_serial str Seriennummer der F4KPWDR7G5DN , dh F4KPWDR7G5DN .
phone_number optional, str Telefonnummer der Relaisquelle.
is_encrypted Bool Gibt an, ob die Relay-Quelle für die Erstellung verschlüsselter Sicherungen eingestellt ist.

Datentypen

Relay-App-Datentypen neu inkubieren

Kennung Beschreibung
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 Health-Daten 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-Konversationen 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 Wanderungsbeiträge ab.
wechat.messages Ruft WeChat-Nachrichten ab.
tinder.messages Ruft Zunder-Nachrichten ab.
line.messages Ruft Leitungsnachrichten 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 Beschreibung
.photos Überprüft das Backup auf Imagedateien.
.videos Überprüft das Backup auf Videodateien.
.recordings Überprüft das Backup auf Aufnahmedateien.
.voicemails Überprüft das Backup auf Voicemail-Dateien.
.app_usage Durchsucht das Backup nach Informationen zur App-Nutzung.
.installed_apps Überprüft das Backup auf installierte App-Informationen.
.locations Durchsucht die Sicherung nach Speicherorten.
.linked_watches Überprüft das Backup auf verknüpfte 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 Art Beschreibung
info_type Zeichenfolge, immer ios_health.profile ID des Artikeldatentyps.
gender optionale Zeichenfolge Einer von: Female , Male , Other .
date_of_birth optionales Datum Das Geburtsdatum des Profilbesitzers.
weight optionaler Schwimmer Die Gewichtsmessung des Profilbesitzers in Kilogramm.
height optionaler Schwimmer Die Höhenmessung des Profilbesitzers in Metern.
blood_type optionale Zeichenfolge Die Blutgruppe des Profilbesitzers.
fitzpatrick_skin_type optionale Zeichenfolge Der Fitzpatrick-Hauttyp des Profilbesitzers. Eine 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 Art Beschreibung
id Zeichenfolge Artikel Identifikationsnummer.
data_type Zeichenfolge ID des Artikeldatentyps. Einer der iOS Health-Datentypen.
type Zeichenfolge Beispielstyp. Eine von: quantity , binary , category .
value eine von string, float, integer Beispielwert. Der Typ dieses Felds hängt type Attribut des Probentyps ab.
unit optionale Zeichenfolge Legen Sie fest, ob es sich um eine nicht standardmäßige Stichprobeneinheit handelt.
was_user_entered Boolescher Wert Gibt an, ob der Benutzer diese Messung manuell eingegeben hat.
start_date Terminzeit Als die Abtastperiode begann.
end_date Terminzeit Als die Abtastperiode 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

-Mitteilungen) Ruft Viber-Nachrichten ab.
viber.conversations Ruft Viber-Konversationen ab.
[ viber.contacts ] (# viber-contact
### Viber

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 .

Wanderbotschaften) Ruft Hike-Nachrichten ab.
### Wanderung

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 5:04 vorm. GMT.

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

Zum Support-Bereich gehen › Wenden Sie sich an das Unternehmensteam ›
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 - 2020 Reincubate Ltd. Alle Rechte vorbehalten. Registriert in England und Wales #5189175, VAT GB151788978. Reincubate und Camo sind Marken. Datenschutz-Bestimmungen & Begriffe. Wir empfehlen die Multi-Faktor-Authentifizierung. Mit Liebe in London gebaut.