Saltar a contenido

Método getLeads

getLeads

El método permite obtener la lista de negocios, incluidos los que se crearon a través del servicio R7K12. El método devuelve como máximo 10000 registros por llamada; en la respuesta a cada solicitud se añade el parámetro «totalResult», con el número total de resultados. Método: GET Enlace: https://api.r7k12.com/{{TOKEN}}/getLeads Parámetros: Tabla 1 Tabla 1

Parámetro Tipo Obligatorio Descripción
id string No Identificador único del negocio en el CRM. Al utilizar este parámetro, la respuesta contendrá el negocio con el identificador indicado (si existe).
lastModified string No Fecha de la última modificación del negocio. Formato: - AAAA-MM-DD HH:MM:SS - AAAA-MM-DD. Si se indica este parámetro, en la respuesta solo se mostrarán los negocios modificados/creados después de la fecha indicada.
fields array [string] No Lista de campos que se deben mostrar en la respuesta. Si no se especifica el parámetro, solo se muestran los identificadores. Campos disponibles: - id - identificador del negocio - r7k12id - identificador de la «visita» - name - nombre del negocio - status - estado del negocio - type - tipo de consulta - dateCreate - fecha de creación (UNIX) - lastModified - fecha de modificación - price - importe del negocio - cost - precio de coste del negocio - clientId - identificador del cliente del CRM - manager - identificador del responsable a cargo del negocio - products - array de productos - fields - campos adicionales del negocio
limit integer No Número de registros que se muestran en el resultado (por defecto, «10000»)
page integer No Número de la página que se muestra (por defecto, «1»)

Ejemplo de solicitud:

define('TOKEN','XXXXXXXXX');
$data = @file_get_contents(
   'https://api.r7k12.com/'.TOKEN.'/getLeads?'.
   http_build_query(
       [
           'lastModified' => '2017-11-11',
           'fields' => [
               'id',
               'status',
               'price',
               'cost',
               'fields'
           ],
    'limit'=> 1
       ]
   )
);

Respuesta:

{
 "page" : 1,
 "totalResult": 156,
 "data": [
   {
     "id" : "1",
     "status" : "587",
     "price" : 0,
     "cost" : 0,
     "fields" : {
       "source1" : "yandex",
       "source2" : "organic",
       "source3" : "(not set)"
     }
   }
 ]
}