Este webservice se utiliza para enviar una consulta al cliente. Se solicitan y validan los datos básicos y se realiza una verificación antispam.
| Información del recurso | |
|---|
| Autenticación | Requerida |
| HTTP Method | POST |
| Response | JSON |
| Version | 1 |
https://mapaprop.app/api/action/express-v1/messages
| Key | Type | Required | Descripción |
|---|
| propertyHash | string | yes | El hash ID de la propiedad. Obtené los IDs en los servicios GET /api/action/express-v1/properties o GET /api/action/express-v1/properties/{propertyHash} |
| userAgent | string | yes | El string real del userAgent del browser. Requerido para la verificación antispam |
| referer | string | yes | El string referer de la solicitud de envío de consulta. Requerido para la verificación antispam. |
| ip | string | yes | La IP del usuario que envía la consulta. Requerida para la verificación antispam. |
| url | string | yes | La URL del aviso en tu sitio. Puede ser igual al referer. |
| name | string | yes | Nombre del usuario que envía la consulta. |
| email | string | or | Email del usuario que envía la consulta. Se debe enviar email o teléfono. |
| phone | string | or | Teléfono del usuario que envía la consulta. Se debe enviar email o teléfono. |
| message | string | yes | Texto enviado por el usuario respecto a la consulta o un texto generado automáticamente legible para la agencia |
POST /api/action/express-v1/messages HTTP/1.1
Host: mapaprop.app
Content-Type: application/x-www-form-urlencoded
Content-Length: 0
Authorization: Bearer {access_token}
propertyHash=32ojflsdfjasld-avC&
userAgent=Mozilla%2F5.0%20%28X11%3B%20Linux%20x86_64%29%20AppleWebKit%2F537.36%20%28KHTML%2C%20like%20Gecko%29%20Chrome%2F32.0.1700.77%20Safari%2F537.36
&referer=http%3A%2F%2Ftrovit.com%2Fad%3Fid%3D111
&ip=85.33.65.69&domain=someinmo.com&url=http%3A%2F%2Fsomeinmo.com%2Fad%3Fid%3D111
&name=John%20Doe&phone=6667117&message=Want%20to%20know%20more%20about%20this
La respuesta JSON indica si la consulta fue enviada correctamente. En caso de error, informa el motivo: la consulta está en cola de moderación por parecer spam o tiene campos inválidos.
| Objeto | Campo | Tipo | Requerido | Descripción |
|---|
| Response | success | boolean | yes | Booleano que indica si el envío fue exitoso o no |
| error | string | no | Texto que indica el tipo de error si success == false |
{
"success": false,
"error": "INVALID_EMAIL"
}
