API Corpo search

Introducción

Corporama pone a su disposición un servicio web en forma de API
REST permite recuperar el contenido de las fichas de sociedades para integrarlas en sus páginas Para obtener más información sobre la API, su modo de uso o para obtener una llave API, no dude en contacter.

Llave API

Una vez que tenga la llave, basta con añadir el parámetro key= en todas las llamadas HTTP Puede facturar cada una de esas llamadas hechas con esa llave No haga visible esa llave en sus aplicaciones.

Usuarios

Su llave API se puede utilizar con varios usuarios. Por ejemplo, si es un editor de CRM y utiliza la API Corporama para que sus clientes puedan rellenar sus fichas automáticamente. En ese caso, puede darnos el argumento suplementario user= que nos permitirá hacer un descuento de las búsquedas por usuario.

Limitaciones

Para evitar un abuso en los servicios, las búsquedas tendrán que estar espaciadas por un lapso de tiempo concreto. En función de los contenidos devueltos, este lapso de tiempo puede variar.

Operaciones disponibles

Información legal

http://es.corporama.com/api/legal
Esta operación le permite encontrar información legal de una sociedad a partir de su CIF.

Parámetros

  • CIF : identificador de la empresa
  • v : número de versión de la API. Usar "1.0"

Ejemplo

http://es.corporama.com/api/legal?v=1.0&nif=B48491468&key=XXXXXXXXXX

Respuesta

Una estructura JSON legal que contenga los diferentes campos de la entidad legal.

{
    "response": {
        "version": "1.0",
        "operation": "legal",
        "query": {
            "nif": "B48491468"
        },
        "legal": {
            "NAF": "7320",
            "active": 1,
            "creation_date": "1992",
            "description": "Estudios de mercado y realización de encuestas de opinión pública",
            "establishments": [
                {
                    "NIC": "5539100",
                    "active": 1,
                    "city": "BARCELONA",
                    "main": 0,
                    "name": "DOUBLETRADE SPAIN S.L.",
                    "phone": "932289965",
                    "street": "17 TRAVESIA DE GRACIA ",
                    "zip": "08021"
                },
                {
                    "NIC": "6252281",
                    "active": 1,
                    "city": "MADRID",
                    "main": 0,
                    "name": "DOUBLETRADE SPAIN S.L.",
                    "street": "34 CALLE ALBARRACIN 1",
                    "zip": "28037"
                },
                {
                    "NIC": "main",
                    "active": 1,
                    "city": "BILBAO",
                    "main": 1,
                    "name": "DOUBLETRADE SPAIN SOCIEDAD LIMITADA",
                    "phone": "944285700",
                    "street": "9 CALLE ZANKOETA PLANTA 6ª",
                    "zip": "48013"
                }
            ],
            "head_count_group": 204,
            "head_count_slice": 12,
            "name": "DOUBLETRADE SPAIN SOCIEDAD LIMITADA",
            "revenue_K": 2993477,
            "revenue_group": 203,
            "revenue_slice": 3,
            "revenue_year": "2015",
            "status": "B",
            "website": "www.construdatos.es"
        }
    }
}
          
  • Los campos vacíos no aparecen
  • creation_date puede ser una fecha con un formato específico (DD/MM/AAAA) o un año
  • main especifica si el establecimiento es una sede social (1) o no (0)
  • revenue y head_count son representantes completos de franjas, de ahí las correspondencias:

    Número de empleados por franjas de efectivo:

    Campo head_count_group :

    EnteroFranja
    200N/D
    2011 de 5
    2026 de 9
    20310 de 19
    20420 de 49
    20550 de 99
    206100 de 249
    207250 de 999
    2081000 de 4999
    209+ de 5000

    Campo head_count_slice:

    EnteroFranja
    0N/D
    11 o 2
    36 de 9
    1110 de 19
    1220 de 49
    2150 de 99
    22100 de 199
    31200 de 249
    32250 de 499
    41500 de 999
    421000 de 1 999
    512000 de 4 999
    525000 de 9 999
    53+ de 10 000

    Franjas de CA

    Campo revenue_group :

    EnteroFranja
    200N/D
    201De menos de 1 millón de euros
    2021 a 2 millones de euros
    2032 a 5 millones de euros
    2045 a 10 millones de euros
    20510 a 50 millones de euros
    20650 a 100 millones de euros
    207100 a 200 millones de euros
    208200 a 500 millones de euros
    209+ de 500 millones de euros

    Campo revenue_slice :

    EnteroFranja
    -1N/D
    0De menos de 0,5 millón de euros
    1De 0,5 a menos de 1 millón de euros
    2De 1 millón a menos de 2 millón de euros
    3De 2 millones a menos de 5 millón de euros
    4De 5 millones a menos de 10 millón de euros
    5De 10 millones a menos de 20 millón de euros
    6De 20 millones a menos de 50 millón de euros
    7De 50 millones a menos de 100 millón de euros
    8De 100 millones a menos de 200 millón de euros
    9200 millones de euros o más

Búsqueda textual

http://es.corporama.com/api/search
Esta operación permite encontrar información como si fuese una búsqueda en Corporama La respuesta está estructurada en varios módulos que se corresponden con firmas visibles en la página de resultados. La presencia del parámetro company es obligatoria..

Parámetros

No se olvide de
codificar correctamente su búsqueda antes de enviar.

Ejemplo 1 (por sociedad)

http://es.corporama.com/api/search?v=2&company=doubletrade&key=XXXXXXXXXX

Respuesta

Una estructura JSON que comprende los resultados por módulo.

{
    "response": {
        "version": "2",
        "operation": "search",
        "query": {
            "company": "doubletrade"
        },
        "results": {
            "legal": [
                {
                    "SIREN": "B48491468",
                    "NAF": "7320",
                    "NAF_label": "Estudios de mercado y realización de encuestas de opinión pública",
                    "name": "DOUBLETRADE SPAIN SOCIEDAD LIMITADA",
                    "status_group_label": "Sociedades de responsabilidad limitada",
                    "zip": "48013"
                }
            ]
        }
    }
}
          

Errores devueltos

Errores HTTP

Si un error interviene en el propio tratamiento de datos, aparece un error HTTP:
  • Código 500 - Internal error : un error interno... normalmente recibimos una alerta cuando se produce, pero no dude en comunicarnos el problema
  • Código 502 - Server temporarily overloaded : nuestros servicios soportan un auge de tráfico que perturba el acceso a los datos. Por favor, inténtelo más tarde
  • Código 400 - Missing version : no ha especificado el parámetro v
  • Código 400 - Missing company : no ha especificado el parámetro Empresa
  • Código 401 - Missing API key : no ha especificado el parámetro key
  • Código 401 - Bad API key : No se reconoce su clave API. Puede que no sea la misma que nos ha comunicado o que todavía no esté activada en nuestros servidores
  • Código 403 - Quota limit exceeded : Ha realizado demasiadas búsquedas seguidas
  • Código 403 - Period limit exceeded : Ha excedido el numero de búsquedas autorizadas para el periodo (día/mes...)

Errores relacionados con el tratamiento de datos

Si un módulo no da ningún resultado para su búsqueda, dará una cadena de caracteres que explica en JSON en lugar de la estructura esperada. Por ejemplo:
{"legal":"missing NIF"}
          

Enlace con la cuenta Corporama

Por defecto, las búsquedas API realizadas se contabilizan para poder facturarse en un período dado o limitadas a un número..

Del mismo modo, puede hacer que el consumo de búsquedas API de los usuarios, sea descontada del número de créditos de exportación si son de cuentas Corporama. Dos formas de proceder :

  1. Pasando el correo electrónico de la cuenta de Corporama en el parámetro user user si se ha asociado a su llave API o previo (el usuario, por lo tanto, tiene que ponerse en contacto con nosotros).)
  2. Pasando un token de conexión del mismo parámetro user De usted depende, por lo tanto, ponerse en contacto con nosotros para que activemos este modo de sincronización de la llave..

Obtención de un token

Para obtener este parámetro de conexión, su aplicación tiene que enviar al usuario a la URL siguiente, para que se identifique en Corporama y autorice a su aplicación a hacer el enlace con su cuenta. :
http://es.corporama.com/login/request_token?hashed_key=<hash de votre clef API>&callback_url=<URL de retour>
          

Detalle de los parámetros

Después de identificarse

Si la autenticación es correcta, redirigiremos al usuario a callback_url pasada en parámetro a la etapa anterior. Añadimos el parámetro token que es el valor asociado al parámetro user en las llamadas API.

Si hay algún problema cuando acceda a la página de registro, aparecerá un mensaje de error en lugar del formulario.

Enlaces auto conectados

Con el token que le hemos proporcionado en la etapa anterior, puede igualmente crear los enlaces a su CRM o a su internet desde las páginas de Corporama conectándose automáticamente con su cuenta Corporama. Lo más normal es crear un enlace desde una ficha de sociedad de su CRM hacia la ficha de Corporama correspondiente pasando el nombre de la sociedad o de su CIF.

La sintaxis de URL que va a integrar es de tipo
http://es.corporama.com/login?h=<le hash ou token de l'utilisateur>&uri=<l'URL cible encodée>

Cómo codificar una URL fuente :

  1. Si C aparece en la ruta a Corporama.com (desde /) que quiere codificar
  2. C64 es la versión base64 de C
  3. En C64, remplazar el carácter "=" por "_" y "+" por "-". Se obtiene C64_b

Ejemplo

  • Camino para codificar C :
    /search?company=EDF
  • Token o Hash de usuario :
    b5c7631fa
  • C64 =
    L3NlYXJjaD9jb21wYW55PUVERg==
  • C64_b =
    L3NlYXJjaD9jb21wYW55PUVERg__
El enlace final auto conectado está, por lo tanto :
http://es.corporama.com/login?h=b5c7631fa&uri=L3NlYXJjaD9jb21wYW55PUVERg__

Incluya Corporama en su CRM

Gane tiempo y sea más eficiente conectando Corporama a su CRM, ya sea una herramienta del mercado o un CRM de origen..

Ver nuestros socios CRM

¡Síganos!

Esté al día de todas nuestras novedades.