Tipos de datos

Actualizado

Los resultados devueltos para encuestas de tipo de data contra la API devolverán información en uno de los formatos que se describen a continuación.

Resultado de la carga útil

Atributos

La estructura raíz de la carga útil de datos JSON tiene los siguientes atributos.

nombre tipo descripción
data lista de objetos de datos Los datos recuperados de la fuente.
metadata objeto de metadatos Metadatos relacionados con los data .

Metadatos

Atributos

nombre tipo descripción
count En t El número de objetos en los data .

File

El tipo de datos del file se ve a lo largo de la API, ya que es una referencia a un archivo que se puede descargar desde la API a través de una encuesta de tipo de files .

Atributos

nombre tipo descripción
id cuerda Identificador utilizado para solicitar el archivo desde la API. Solo se garantiza que el valor sea único en el alcance de la fuente actual.
data_type cadena, siempre file Especificador de tipo de datos.
name cuerda El nombre del archivo, excluyendo la extensión.
extension cadena, opcional La extensión del archivo si está disponible.
mime_type cadena, opcional El tipo MIME del archivo si está disponible.
size int, opcional El tamaño del archivo si está disponible.
checksum cadena, opcional La suma de comprobación md5 si está disponible.

Ejemplo 

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

Image

Extends file.

nombre tipo descripción
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 El ancho del archivo si está disponible.
height int, opcional La altura del archivo si está disponible.

Ejemplo 

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

nombre tipo descripción
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 El ancho del archivo si está disponible.
height int, opcional La altura del archivo si está disponible.
duration int, opcional La duración del video si está disponible.

Ejemplo 

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

nombre tipo descripción
id cuerda Un identificador único para el mensaje. Use esto para deduplicar los datos devueltos si es necesario.
data_type cadena, siempre message Especificador de tipo de datos.
conversation_id cuerda Identificador de agrupación de mensajes por conversación.
handle cuerda La 2ª fiesta de la conversación.
type cadena, opcional Se utiliza cuando un servicio de mensajería maneja una variedad de tipos de mensajes. Por ejemplo, SMS e iMessage en el caso de los mensajes de iOS.
text cuerda El cuerpo del mensaje.
from_me bool Si el mensaje fue enviado o recibido.
attachments lista de archivos, opcional Una matriz de valores de file_id que se puede usar con el método download_file . Si el mensaje no incluye datos adjuntos, se devuelve una matriz vacía.
group_handles lista de cuerdas, opcional Este valor es null para los mensajes persona a persona, y en las conversaciones grupales hay una serie de cadenas que representan números de teléfono o direcciones de correo electrónico de iMessage.
group cadena, opcional El nombre del grupo en el momento en que se envió el mensaje .
group_id cadena, opcional El identificador único para el grupo dentro del contexto de esa aplicación. Puede que no sea un número entero y, si está presente, solo proporciona información además de conversation_id .
group_contacts cadena, opcional Una matriz de objetos que hacen referencia a los contactos de iOS en el grupo.
user cadena, opcional El usuario de la aplicación de mensajería en el caso de que múltiples usuarios / cuentas puedan usar una aplicación de mensajería desde el dispositivo.
deleted bool, opcional Un valor booleano para indicar si el mensaje se ha eliminado.
date fecha y hora Cuando el mensaje fue enviado o recibido.
contact contacto anidado, opcional Un objeto que hace referencia a un contacto de iOS de la segunda parte de la conversación.

Ejemplo 

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

nombre tipo descripción
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

nombre tipo descripción
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:

nombre tipo descripción
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

nombre tipo descripción
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

nombre tipo descripción
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

nombre tipo descripción
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

nombre tipo descripción
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

nombre tipo descripción
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"
}

¿Cómo podemos ayudar?

¡Nuestro equipo de soporte está aquí para ayudar!

Nuestro horario de atención es de lunes a viernes de 9 a.m. a 5 p.m. GMT. El tiempo es actualmente 6:34 PM GMT.

Intentamos responder todos los mensajes en un plazo de un día laboral.

Ir a la sección de soporte › Póngase en contacto con el equipo de la empresa. ›
Nuestro increíble equipo de soporte.

© 2008 - 2020 Reincubate Ltd. Todos los derechos reservados. Registrado en Inglaterra y Gales #5189175, VAT GB151788978. Reincubate® es una marca registrada. Política de privacidad & condiciones. Recomendamos la autenticación de múltiples factores. Construido con en Londres.

Utilizamos cookies para rastrear el uso y mejorar su experiencia.

entiendo Política de privacidad