¿Cómo Empiezo?

Portal de Desarrolladores

Ponte en contacto con Plataforma Tierra para que te demos acceso al portal de desarrolladores y a nuestra API: https://devs.plataformatierra.es/.

En cuanto tengas acceso podrás explorar y ver los productos asignados a tu usuario.

Verás una API con datos de producción y otra de desarrollo en la que te daremos datos no productivos de modelos autogenerados y podremos tener puntos de API con los que estemos desarrollando nuevas funcionalidades.

Identificación de Usuario y Seguridad

Para poder identificar los datos de usuario que quieres solicitar y poder validar tu acceso, tendremos dos datos que siempre deberás enviarnos al utilizar los puntos de API.

• Ocp-Apim-Subscription-Key: Lo encontrarás dentro de tus datos de perfil como Primary key y Secondary key. Desde aquí podrás consultar [Show] y regenerar [Regenerate] estas claves por si fuese necesario, además de ofrecerte una clave secundaria para cuando sea necesario modificar este valor y no tener "downtime" de nuestros servicios por cada una de nuestras APIs.
• Ocp-Apim-Subscription-Sid: Este campo es el ID único de la suscripción y te lo facilitaremos cuando te demos acceso al portal. Tendrás dos SID, uno por cada producto.

Estos datos deben ir siempre en las llamadas a la API como headers. Si las claves que recibimos no son válidas o no se reciben, te devolveremos un error indicándote el problema:

{
  "statusCode": 401,
  "message": "Access denied due to invalid subscription key. Make sure to provide a valid key for an active subscription."
}

ATENCIÓN

Nunca compartas el identificador único ni tus claves. Nosotros nunca te las solicitaremos y de ser necesario te facilitaremos claves nuevas revocando las anteriores. Si crees que tus credenciales han sido comprometidas ponte en contacto con nosotros.