Reïncubeer relayservice

bijgewerkt

Sessions

Een koppelingsproces wordt gebruikt om een koppeling tot stand te brengen tussen een gebruiker van de API en een exemplaar van de Reincubate Relay-app. Standaard, indien niet gekoppeld, geeft het Reincubate-relais de koppelingscode weer. De gebruiker moet dit aan uw toepassing geven om een geldige sessie te kunnen maken, via het volgende gesprek.

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

Zodra de sessie is gemaakt, kunt u voor meer informatie over de app bijvoorbeeld via de sessie object source attribuut. Dit zou er ongeveer zo uit moeten zien:

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

abonnementen

In tegenstelling tot andere services is een abonnement vereist voordat de API kan beginnen met het ophalen van gegevens uit een Reincubate Relay-bron. Dit helpt de gebruiker van de app precies te begrijpen tot welke gegevens toegang wordt verkregen.

Abonnementen kunnen alleen worden gemaakt voor rirelay.source type rirelay.source , de onderliggende elementen van de Reincubate Relay-instantie. De sessie die moet worden gebruikt bij het pollen van de bron moet ook worden opgegeven.

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

Het abonnement blijft in behandeling totdat de gebruiker toegang heeft verleend tot het specifieke apparaat in de Reincubate Relay-app-interface. Zodra het is toegestaan, wordt de status omgezet naar active .

Een eerste peiling wordt onmiddellijk gemaakt bij het activeren van een abonnement, en vervolgens worden peilingen gemaakt wanneer de Reincubate Relay-app de API op de hoogte brengt van nieuwe gegevens.

Polls

Peilingen kunnen ook handmatig worden gemaakt tegen bronnen met actieve abonnementen. Dit is handig bij het oplossen van problemen met opgehaalde gegevens of bij het testen van nieuwe gegevenstypen.

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

Evenementen

Om op de hoogte te blijven van asynchrone wijzigingen, zoals een abonnement voor het maken van een nieuwe peiling of een sessie die verloopt, moet uw implementatie gebeurtenismeldingen van de API ontvangen via een webhook-eindpunt.

Voor meer informatie over hoe te installeren en uw webhook eindpunt configureren, zie configureren webhooks .

Info soorten

De Relay-service ondersteunt momenteel alleen het ophalen van informatie uit rirelay.instance bronnen.

rirelay.instance.info attributen

naam type Omschrijving
id bron-ID ID van het bronobject dat overeenkomt met deze Relay-instantie.
version str Versie van de Reincubate Relay-app.
os str Identificatie van het besturingssysteem waarop de Reincubate Relay-app draait.
sources lijst van rirelay.source.info Lijst met bronnen die aan de instantie zijn gekoppeld.
date_created datum Tijd Datetime toen deze instantie voor het eerst werd gezien.
date_last_seen datum Tijd Datetime wanneer deze instantie voor het laatst werd gezien.

rirelay.source.info attributen

naam type Omschrijving
id bron-ID ID van het bronobject dat overeenkomt met deze relaisbron.
uid str De unieke iOS-apparaat-ID van de Relay-bron.
info genest rirelay.source.info.info Metadata voor deze Relay-bron.
date_created datum Tijd Datetime toen deze bron voor het eerst werd gezien.
date_last_seen datum Tijd Datetime wanneer deze bron voor het laatst werd gezien.

rirelay.source.info.info attributen

naam type Omschrijving
name str Naam van de relaisbron.
ios_version str IOS-versie die op de Relay-bron draait, namelijk 13.4 .
apple_model_id str Model ID of the Relay source, i.e. iPhone7,2.
apple_serial str Serial number of the Relay source, i.e. F4KPWDR7G5DN.
phone_number optioneel, str Telefoonnummer van de Relay-bron.
is_encrypted bool Of de Relay-bron is ingesteld om gecodeerde back-ups te maken.

Datatypen

Reïncubeer de gegevenstypen van de Relay-app

identifier Omschrijving
ios_messages.messages Retrieves iOS Messages data including iMessage and SMS.
ios_contacts.contacts Retrieves iOS Contacts data.
ios_phone.calls Retrieves iOS Phone data.
ios_calendar.events Retrieves iOS Calendar data.
ios_notes.notes Retrieves iOS Notes data.
ios_health.data Retrieves iOS Health data.
ios_safari.history Retrieves Safari browser history data.
ios_safari.cookies Retrieves Safari cookie data.
whatsapp.messages Retrieves WhatsApp messages.
whatsapp.calls Retrieves WhatsApp call history.
viber.messages Retrieves Viber messages.
viber.calls Retrieves Viber call history.
viber.conversations Retrieves Viber conversations.
viber.contacts Retrieves Viber contacts.
kik.messages Retrieves Kik messages.
kik.contacts Retrieves Kik contacts.
hike.messages Retrieves Hike messages.
hike.posts Retrieves Hike posts.
wechat.messages Retrieves WeChat messages.
tinder.messages Retrieves Tinder messages.
line.messages Retrieves Line messages.
facebook.messages Retrieves Facebook messages.
snapchat.messages Retrieves Snapchat messages.
snapchat.stories Retrieves Snapchat stories.
skype.messages Retrieves Skype messages.

Reincubate Relay geaggregeerde gegevenstypen

identifier Omschrijving
.photos Scant de back-up op afbeeldingsbestanden.
.videos Scant de back-up voor videobestanden.
.recordings Scant de back-up voor het opnemen van bestanden.
.voicemails Scant de back-up op voicemailbestanden.
.app_usage Scant de back-up voor informatie over app-gebruik.
.installed_apps Scant de back-up voor geïnstalleerde app-informatie.
.locations Scant de back-up voor locaties.
.linked_watches Scant de back-up voor gekoppelde Apple Watch-informatie.

iOS Messages

Messages

Data type ID ios_messages.messages

Data attributes

Extends the message data type.

Sample data

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

Contacts

Data type ID ios_contacts.contacts

Data attributes

Extends the contact data type.

Sample data

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

Calls

Data type ID ios_phone.calls

Data attributes

Extends the call data type.

Sample data

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

Events

Data type ID ios_calendar.events

Data attributes

Extends the event data type.

Sample data

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

Notes

Data type ID ios_notes.notes

Data attributes

Extends the note data type.

iOS Health

Data associated with the iOS Health app and the HealthKit framework.

Data

Data type ID ios_health.data

ios_health.profile attributes

naam type Omschrijving
info_type string, always ios_health.profile Item data type ID.
gender optional string One of: Female, Male, Other.
date_of_birth optional date The profile owner's date of birth.
weight optional float The profile owner's weight measurement, in kilograms.
height optional float The profile owner's height measurement, in meters.
blood_type optional string The profile owner's blood type.
fitzpatrick_skin_type optional string The profile owner's Fitzpatrick Skin Type. One of: Type I, Type II, Type II, Type IV, Type V.

ios_health.profile sample

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

naam type Omschrijving
id string Item ID.
data_type string Item data type ID. One of the iOS Health data types.
type string Sample type. One of: quantity, binary, category.
value one of string, float, integer Sample value. The type of this field depends on the sample type attribute.
unit optional string Set if a non-default sample unit.
was_user_entered boolean Whether the user entered this measurement manually.
start_date datetime When the sampling period begun.
end_date datetime When the sampling period ended.

iOS Health data types:

  • 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

Sample data

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

History

Data type ID ios_safari.history

Data attributes

Extends the visit data type.

Sample data

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

Cookies

Data type ID ios_safari.cookies

Data attributes

Extends the cookie data type.

Sample data

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

Messages

Data type ID whatsapp.messages

attributen

Extends the message data type.

Calls

Data type ID whatsapp.calls

attributen

Extends the call data type.

-messages) Retrieves Viber messages.
viber.conversations Retrieves Viber conversations.
[viber.contacts](#viber-contact
### Viber

Messages

Data type ID viber.messages

attributen

Extends the message data type.

Calls

Data type ID viber.calls

attributen

Extends the call data type.

Conversations

Data type ID viber.conversations

attributen

Extends the conversation data type.

Contacts

Data type ID viber.contacts

attributen

Extends the contact data type.

Kik

Messages

Data type ID kik.messages

attributen

Extends the message data type.

Contacts

Data type ID kik.contacts

attributen

Extends the contact data type.

hike-messages) Retrieves Hike messages.
### Hike

Messages

Data type ID hike.messages

attributen

Extends the message data type.

Posts

Data type ID hike.posts

attributen

Extends the message data type.

WeChat

Messages

Data type ID wechat.messages

attributen

Extends the message data type.

Tinder

Messages

Data type ID tinder.messages

attributen

Extends the message data type.

Line

Messages

Data type ID line.messages

attributen

Extends the message data type.

Facebook Messenger

Messages

Data type ID facebook.messenger

attributen

Extends the message data type.

Snapchat

Messages

Data type ID snapchat.messages

attributen

Extends the message data type.

Stories

Data type ID snapchat.stories

attributen

Extends the message data type.

Skype

Messages

Data type ID skype.messages

attributen

Extends the message data type.

Hoe kunnen we helpen?

Ons ondersteuningsteam is er om u te helpen!

Onze kantooruren zijn van maandag tot vrijdag van 09.00 tot 17.00 uur GMT. De tijd is momenteel 12:06 AM GMT.

We streven ernaar om alle berichten binnen één werkdag te beantwoorden.

Ga naar het ondersteuningsgedeelte › Neem contact op met het Enterprise-team ›
Ons geweldige ondersteuningsteam

Kunnen we dit artikel verbeteren?

We horen graag van gebruikers: Stuur ons een e-mail, laat een reactie achter of stuur een tweet @reincubate?

© 2008 - 2020 Reincubate Ltd. Alle rechten voorbehouden. Geregistreerd in Engeland en Wales #5189175, VAT GB151788978. Reincubate® is een geregistreerd handelsmerk. Privacybeleid & termen. Wij bevelen 2FA aan. Gebouwd met in Londen.