Tipos de dados

Atualizada

Os resultados retornados para pesquisas de tipo de data na API retornarão informações em um dos formatos descritos abaixo.

Carga útil do resultado

Atributos

A estrutura raiz da carga útil JSON de dados possui os seguintes atributos.

nome tipo descrição
data lista de objetos de dados Os dados recuperados da fonte.
metadata objeto de metadados Metadados relacionados aos data .

Metadados

Atributos

nome tipo descrição
count int O número de objetos nos data .

File

O tipo de dados do file é visto em toda a API, pois é uma referência a um arquivo que pode ser baixado da API por meio de uma pesquisa de tipo de files .

Atributos

nome tipo descrição
id corda Identificador usado para solicitar o arquivo da API. O valor só é garantido como único no escopo da fonte atual.
data_type string, sempre file Especificador de tipo de dados.
name corda O nome do arquivo, excluindo a extensão.
extension string, opcional A extensão do arquivo, se disponível.
mime_type string, opcional O tipo MIME do arquivo, se disponível.
size int, opcional O tamanho do arquivo, se disponível.
checksum string, opcional A soma de verificação md5, se disponível.

Exemplo

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

Image

Extends file.

nome tipo descrição
filename string The original file name of the file. The extension in this filename need to match the extension of the file.
filepath string The path of the file relative to other files within its service. For example, the path within a backup.
width int, opcional A largura do arquivo, se disponível.
height int, opcional A altura do arquivo, se disponível.

Exemplo

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

Extends file.

nome tipo descrição
filename string The original file name of the file. The extension in this filename need to match the extension of the file.
filepath string The path of the file relative to other files within its service. For example, the path within a backup.
width int, opcional A largura do arquivo, se disponível.
height int, opcional A altura do arquivo, se disponível.
duration int, opcional A duração do vídeo, se disponível.

Exemplo

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

Message

Atributos

nome tipo descrição
id corda Um identificador exclusivo para a mensagem. Use isso para desduplicar os dados retornados, se necessário.
data_type string, sempre message Especificador de tipo de dados.
conversation_id corda Identificador agrupando mensagens por conversa.
handle corda A segunda parte da conversa.
type string, opcional Usado quando um serviço de mensagens lida com vários tipos de mensagens. Por exemplo, SMS e iMessage no caso de mensagens do iOS.
text corda O corpo da mensagem.
from_me bool Se a mensagem foi enviada ou recebida.
attachments lista de arquivos, opcional Uma matriz de valores de file_id que podem ser usados com o método download_file . Se a mensagem não incluir nenhum anexo, será retornada uma matriz vazia.
group_handles lista de strings, opcional Esse valor é null para mensagens de pessoa para pessoa e, em conversas de grupo, é uma matriz de cadeias que representa números de telefone ou endereços de e-mail do iMessage.
group string, opcional O nome do grupo no momento em que a mensagem foi enviada .
group_id string, opcional O identificador exclusivo do grupo no contexto desse aplicativo. Isso pode não ser um número inteiro e, se presente, fornece apenas informações além de conversation_id .
group_contacts string, opcional Uma matriz de objetos que fazem referência aos contatos do iOS no grupo.
user string, opcional O usuário do aplicativo de mensagens no caso de vários usuários / contas poderem estar usando um aplicativo de mensagens do dispositivo.
deleted bool, opcional Um valor booleano para indicar se a mensagem foi excluída.
date data hora Quando a mensagem foi enviada ou recebida.
contact contato aninhado, opcional Um objeto que faz referência a um contato do iOS da segunda parte da conversa.

Exemplo

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

Conversation

A conversation thread.

nome tipo descrição
id string Item ID.
data_type string, always conversation Item data type ID.
group optional string Name of group.
members list of contact items Participants in the conversation.

Contact

contact attributes

nome tipo descrição
id string Item ID.
data_type string, always contact Item data type ID.
name optional string The contact's full name.
first_name optional string The contact's first name.
middle_name optional string The contact's middle name.
last_name optional string The contact's last name.
prefix optional string The contact's name prefix.
suffix optional string The contact's name suffix.
nickname optional string The contact's nickname.
records list of contact.record items Contact records associated with the contact.
organisation optional string The contact's organisation name.
department optional string The contact's department within the organisation.
jobtitle optional string The contact's job title within the organisation.
birthday optional date The contact's birthday.

contact.record attribute

There are 5 types of contact record items: Phone, Email, URL, Social, and Address. They correspond to a phone number, email address, website URL, social media account handle, and street address, respectively.

The first 4 have the same attributes:

name type description
type string One of: Phone, Email, URL, Social.
name optional string The label associated with the record.
value string The value of the record.

The Address contact record type has additional address fields:

nome tipo descrição
type string, always Address A phone number record.
name optional string The label associated with the number.
CountryCode optional string A country code.
Country optional string A country name.
ZIP optional string A zip or postal code.
State optional string A state name or abbreviation.
City optional string A city name.
Municipality optional string A municipality name.
SubLocality optional string A neighbourhood or area name.
Street optional string A street address name.

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

Call

Atributos

nome tipo descrição
id string Item ID.
data_type string, always call Item data type ID.
call_type string One of: Phone, FaceTime Video, FaceTime Audio.
address string The target of the call. Could be a phone number, Apple ID, or other identifier.
duration float The duration of the call.
answered bool Whether the call was answered.
from_me bool Whether the call was outgoing or incoming.
date datetime When the call was made.

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

Event

event attributes

nome tipo descrição
id string Item ID.
data_type string, always event Item data type ID.
unique_identifier optional string Item UID for deduplicating across multiple event data sources.
calendar optional string Calendar name.
calendar_uid optional string Calendar UID.
calendar_store optional string Calendar store type, i.e. iCloud, Default.
summary optional string The event summary or title.
description optional string The event description.
start_date optional datetime When the event begins.
end_date optional datetime When the event finishes.
start_time_zone optional string The timezone of start_date.
end_time_zone optional string The timeone of end_date.
all_day boolean Whether the event lasts an entire day.
travel_time optional duration The event's travel time duration.
recurrence optional nested event.recurrence The event's recurrence settings.
location optional string Where the event is taking place.
start_location optional string Where the event is starting from.
attendees optional list of strings Names of event attendees.
attached_url optional string A URL associated with the event.
creation_date optional datetime When the event was created. Not set if default calendar entry, such as public holidays.

event.recurrence attributes

nome tipo descrição
interval integer The count of repeat to recurr at, i.e. 1 Yearly (once every 1 year).
repeat string One of: OneTime, Daily, Weekly, Monthly, Yearly.
repeat_end_date optional datetime When to stop recurring.

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
}

Note

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

Visit

A record of a website page visit.

Atributos

name type description
data_type string, always visit Item data type ID.
url string The URL of the page visited.
title string The visited page's title.
date_created datetime When the visit occurred.
{
  "data_type": "visit",
  "url": "https://reincubate.com/",
  "title": "Reincubate: the app data company",
  "date_created": "2020-01-01T00:00:00.000000Z"
}

'name': self.name, 'creation_date': creation_date, 'expiry_date': expiry_date, 'domain': self.domain, 'flags': self.flags, 'path': self.path, 'value': self.value,

Cookie

A HTTP cookie.

Atributos

nome tipo descrição
data_type string, always cookie Item data type ID.
name string The cookie's name.
value string The cookie's value.
domain string The cookie's domain specifier.
path string The cookie's path specifier.
flags string Any flags set on the cookie.
creation_date datetime When the cookie was created.
expiry_date datetime When the cookie expires.
{
  "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"
}

Location

Data attributes

nome tipo descrição
data_type string, always location A data type identifier.
latitude float The location's latitude coordinate.
longitude float The location's longitude coordinate.
altitude float The location's altitude coordinate.
horizontal_accuracy float The horizontal accuracy for the measurement.
vertical_accuracy float The vertical accuracy for the measurement.
position_type string Identifier for the measurement method used.
date_created datetime When the measurement was made.

Sample data

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

Como podemos ajudar?

Nossa equipe de suporte está aqui para ajudar!

Nosso horário de atendimento é de segunda a sexta, das 9h às 17h GMT. A hora é atualmente 5:08 AM GMT.

Nosso objetivo é responder a todas as mensagens dentro de um dia útil.

Vá para a seção de apoio › Entre em contato com a equipe da empresa ›
Nossa equipe de suporte incrível

© 2008 - 2020 Reincubate Ltd. Todos os direitos reservados. Registrado na Inglaterra e no País de Gales #5189175, VAT GB151788978. Reincubate® é uma marca registrada. Política de Privacidade & termos. Recomendamos 2FA. Construído com em Londres.