Puede crear temas para personalizar la página de seguimiento white-label con los colores, iconos y logotipo de su marca.

• Crear un nuevo tema
• Actualizar tema
• Consultar tema
• Eliminar tema
• Ejemplo – Personalizar el tema de la página de seguimiento

Crear un nuevo tema

Para crear un tema, debe enviar una solicitud con el método POST al siguiente endpoint:

• https://api.maplink.global/tracking/v1/themes/ – POST

A continuación se muestra un ejemplo de solicitud:

{
   "id": "Maplink",
   "logo": "https://example.com",
   "color": "#FF0000",
   "favicon": "https://example.com",
   "language": "pt_BR"
}

Dónde:

• id – ID para identificar el tema.
• logo – URL de la imagen del logotipo. Se recomiendan unas dimensiones de 40px de alto y 120px de ancho.
• color – Valor hexadecimal del color principal del sitio. Ej: #FF0000
• favicon – URL de la imagen favicon del sitio. Se recomiendan las dimensiones de 48px de alto y 48px de ancho.
• languague – Idioma del sitio. Valores posibles: ["en", "pt", "pt_BR", "pt_PT", "es", "es_AR", "es_CL", "es_CO", "es_MX"]

Actualizar tema

Para actualizar un tema existente, basta con enviar una solicitud con el método PUT al siguiente punto final:

• https://api.maplink.global/tracking/v1/themes/{{trackingTheme}} – PUT

Donde el término {{trackingTheme}} debe ser sustituido por el ID del tema que desea actualizar.

A continuación se muestra un ejemplo de solicitud:

{
   "id": "Maplink",
   "logo": "https://example.com",
   "color": "#0000CD",
   "favicon": "https://example.com",
   "language": "pt_BR"
}

Consultar tema

Para consultar un tema, basta con enviar una solicitud con el método GET al siguiente endpoint:

• https://api.maplink.global/tracking/v1/themes/{{trackingTheme}} – GET

Donde el término {{trackingTheme}} debe ser sustituido por el ID del tema que desea consultar.

Eliminar tema

Para eliminar un tema, basta con enviar una solicitud con el método DELETE al siguiente endpoint:

• https://api.maplink.global/tracking/v1/themes/{{trackingTheme}} – DELETE

Donde el término {{trackingTheme}} debe ser sustituido por el ID del tema que desea eliminar.

Ejemplo – Personalizar el tema de la página de seguimiento

En el siguiente ejemplo, vamos a crear un tema para la página de seguimiento de la empresa «Home Delivery».

A continuación puede ver la solicitud con el icono, el logotipo y el color del tema personalizado:

{
    "id": "HomeDelivery",
    "logo": "https://i.ibb.co/4MTKPLy/logo.png",
    "color": "#e8af46",
    "favicon": "https://i.ibb.co/Fh1qVqV/ico.png",
    "language": "pt_BR"
}

A continuación, basta con introducir el nombre del tema en el parámetro theme al crear un pedido, como se muestra en el ejemplo siguiente:

{
  "number": "1232132132143438",
  "description": "Product",
  "companyName": "Maplink",
  "status": {
    "value": "ON_THE_WAY",
    "label": "Pedido em trânsito"
  },
  "destination": {
    "mainLocation": {
      "lat": -22.7342864,
      "lon": -47.6480644
    }
  },
  "driver": {
    "name": "Maplink BR",
    "currentLocation": {
      "lat": -23.564515,
      "lon": -46.652681
    }
  },
  "theme": "HomeDelivery"
}

La página de seguimiento personalizada puede verse en la siguiente imagen: