Palabra Clave

Request:

POST 'https://api.mercadolibre.com/shipments/keyword_validation' \ --header 'Authorization: Bearer {accessToken}'

Formato Request

Dentro del body se enviará un objeto JSON con los campos listados a continuación:

Formato Response

Cuando la validación fuese satisfactoria, el resultado del POST retornará un código 200. En estos casos no se incluirá contenido dentro del body de la respuesta.

En aquellos casos en que la validación de la Palabra Clave fuese incorrecta, se incluirá dentro del body de la respuesta la siguiente información:

Status Codes

Ejemplos

Request:

POST 'https://api.mercadolibre.com/shipments/keyword_validation' 
\ --header 'Authorization: Bearer {accessToken}'

{
    "keyword": "manzana" ,
    "method": "online" ,
    "driver_id": "123" ,
    "shipments_ids": [10101033319242, 10101053419321]
}

Response:

SUCCESS (200 OK)

FAILED (400)

{
    "message": "The keyword is invalid",
    "error": "keyword_invalid",
}

{
    "message": "Too Many Requests",
    "error": "too_many_request",
}

ERROR (5xx)

{
        "message": "Internal Server Error",
        "error": "unexpected_error",
}

1. Obtener la Palabra Clave del shipment

Obtener el valor del campo "keyword" del response enviado durante la Autorización del envío.

En caso de no encontrarse este campo, o que el mismo estuviese vacío, no deberá realizarse esta validación.

{
...
"keyword": "3bc405c30cadb4e6eefdf0cff899abcf8234d761c9a3ea1b2f510601ae5fc504"
...
}

2. Generar el hash de la Palabra Clave del receiver

Concatenar el shipment_id y la Palabra Clave informada por el receiver (en minúscula y sin utilizar acentos).

Aplicar el algoritmo SHA256 a la concatenacion anterior

shipment_id = 10101033319242
palabraInformada = "Manzana"
textoAEncriptar = shipment_id + SinAcentosNiMayusculas(palabraInformada)  --> "10101033319242manzana"
nuevoHash = SHA256(textoAEncriptar) --> "3bc405c30cadb4e6eefdf0cff899abcf8234d761c9a3ea1b2f510601ae5fc504"

3. Comparar ambos hash

Realizar la comparación de los hash obtenidos en paso 1 y 2 utilizando una comparación Case-insensitive.

4. Repetir el proceso en caso de fallo

Este proceso podrá ser repetido hasta tanto la comparación sea exitosa o se cumpla la máxima cantidad de reintentos permitida.

De cumplirse la máxima cantidad de reintentos permitida no deberá continuar reintentando hasta el próximo día.

5. Enviar información a Mercadolibre

Todas las validaciones que se realicen en forma Offline deberán ser informadas a Mercadolibre a través del servicio de validación Online definido previamente.