{"id":4393,"date":"2026-11-12T19:32:54","date_gmt":"2026-11-12T19:32:54","guid":{"rendered":"https:\/\/developers.maplink.global\/?p=4393"},"modified":"2026-11-12T19:32:54","modified_gmt":"2026-11-12T19:32:54","slug":"error-messages","status":"publish","type":"post","link":"https:\/\/developers.maplink.global\/es\/error-messages\/","title":{"rendered":"Error messages"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">La siguiente tabla muestra todos los mensajes de error que la API puede devolver en el campo <code>message<\/code>:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><tbody><tr><th>Par\u00e1metro<\/th><th>Mensaje<\/th><th>Descripci\u00f3n<\/th><\/tr><tr><td><code>zipcode<\/code> \/ <code>label<\/code><\/td><td><code>The zipcode field must contain exactly 8 digits<\/code><\/td><td>El CEP no se inform\u00f3, ni en el par\u00e1metro <code>zipcode<\/code> ni en el <code>label<\/code>, o no tiene exactamente 8 d\u00edgitos despu\u00e9s de quitar el gui\u00f3n.<\/td><\/tr><tr><td><code>road<\/code><\/td><td><code>size must be between 0 and 150<\/code><\/td><td>El <code>road<\/code> tiene m\u00e1s de 150 caracteres.<\/td><\/tr><tr><td><code>label<\/code><\/td><td><code>Structure error on label field<\/code><\/td><td>Falta al menos una de las cinco comas de separaci\u00f3n en el <code>label<\/code>. Este error tiene prioridad sobre los errores de formato del CEP.<\/td><\/tr><tr><td>Todos<\/td><td><code>Request body cannot be empty<\/code><\/td><td>Ninguno de los par\u00e1metros <code>road<\/code>, <code>number<\/code>, <code>zipcode<\/code>, <code>district<\/code>, <code>city<\/code> o <code>label<\/code> fue completado.<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Ejemplo con el formato label<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">En el ejemplo siguiente, el <code>label<\/code> tiene solo cuatro comas, porque falta la separaci\u00f3n entre la calle y el n\u00famero:<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">{\n  \"label\": \"av paulista 1578,bela vista,01310200,sao paulo,SP\"\n}<\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">La solicitud ser\u00e1 rechazada con la respuesta siguiente:<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">{\n  \"title\": \"Constraint Violation\",\n  \"status\": 400,\n  \"violations\": [\n    {\n      \"field\": \"analyze.request.label\",\n      \"message\": \"Structure error on label field\"\n    }\n  ]\n}<\/pre>\n\n\n\n<h3 class=\"wp-block-heading\">Ejemplos con el formato estructurado<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>CEP con menos de 8 d\u00edgitos<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">En el ejemplo siguiente, el <code>zipcode<\/code> tiene solo 7 d\u00edgitos despu\u00e9s de quitar el gui\u00f3n:<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">{\n  \"road\": \"r da cantarera 306 box 12\",\n  \"number\": \"\",\n  \"zipcode\": \"01024-00\",\n  \"district\": \"centro\",\n  \"city\": \"sao paulo\",\n  \"state\": \"SP\"\n}<\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">La solicitud ser\u00e1 rechazada con la respuesta siguiente:<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">{\n  \"title\": \"Constraint Violation\",\n  \"status\": 400,\n  \"violations\": [\n    {\n      \"field\": \"analyze.request.zipcode\",\n      \"message\": \"The zipcode field must contain exactly 8 digits\"\n    }\n  ]\n}<\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Calle por encima del l\u00edmite de caracteres<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">En el ejemplo siguiente, el <code>road<\/code> tiene m\u00e1s de 150 caracteres:<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">{\n  \"road\": \"rua da cantareira 306 box 12 mercado municipal de sao paulo entrada pela porta lateral proximo ao estacionamento falar com o responsavel pelo recebimento no horario comercial\",\n  \"number\": \"\",\n  \"zipcode\": \"01024-000\",\n  \"district\": \"centro\",\n  \"city\": \"sao paulo\",\n  \"state\": \"SP\"\n}<\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">La solicitud ser\u00e1 rechazada con la respuesta siguiente:<\/p>\n\n\n\n<pre class=\"EnlighterJSRAW\" data-enlighter-language=\"generic\" data-enlighter-theme=\"\" data-enlighter-highlight=\"\" data-enlighter-linenumbers=\"\" data-enlighter-lineoffset=\"\" data-enlighter-title=\"\" data-enlighter-group=\"\">{\n  \"title\": \"Constraint Violation\",\n  \"status\": 400,\n  \"violations\": [\n    {\n      \"field\": \"analyze.request.road\",\n      \"message\": \"size must be between 0 and 150\"\n    }\n  ]\n}<\/pre>\n","protected":false},"excerpt":{"rendered":"<p>La siguiente tabla muestra todos los mensajes de error que la API puede devolver en el campo message: Par\u00e1metro Mensaje Descripci\u00f3n zipcode \/ label The zipcode field must contain exactly 8 digits El CEP no se inform\u00f3, ni en el par\u00e1metro zipcode ni en el label, o no tiene exactamente 8 d\u00edgitos despu\u00e9s de quitar [&hellip;]<\/p>\n","protected":false},"author":6,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"inline_featured_image":false,"footnotes":""},"categories":[176],"tags":[],"class_list":["post-4393","post","type-post","status-publish","format-standard","hentry","category-address-analyzer-es"],"acf":[],"_links":{"self":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts\/4393","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/users\/6"}],"replies":[{"embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/comments?post=4393"}],"version-history":[{"count":1,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts\/4393\/revisions"}],"predecessor-version":[{"id":4394,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/posts\/4393\/revisions\/4394"}],"wp:attachment":[{"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/media?parent=4393"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/categories?post=4393"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/developers.maplink.global\/es\/wp-json\/wp\/v2\/tags?post=4393"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}