Reintentar la ingesta de los assets
POST /property-v1/properties/{paId}/assets
En el camino normal no la llamás. Las fotos y el plano viajan dentro del objeto cuando das de alta la propiedad, y nosotros las descargamos solos. Este endpoint existe para reintentar cuando alguna no se pudo bajar.
Por qué descargamos tus imágenes
Porque si el aviso viaja con la URL de tu CDN, el portal termina sirviendo contenido que no controlamos. Al bajarlas y servirlas nosotros, el aviso deja de depender de que tu CDN siga en pie y sirviendo lo mismo.
Cuándo llamarlo
Cuando el bloque images de cualquier respuesta te diga que algo falló. Ese bloque viene en todas
las respuestas de la propiedad —alta, actualización, baja y lectura— justamente para que no tengas que
preguntar aparte:
status | Qué significa | ¿Reintentar? |
|---|---|---|
processing | las estamos bajando | no: esperá y volvé a leer la propiedad |
ready | todas listas y servidas por nosotros | no |
partial | algunas sí, otras no | sí, y el detalle de cuáles está en ese mismo bloque |
failed | no se pudo | sí |
Cómo se pide
curl -X POST https://property-api.mapaprop.com/property-v1/properties/01M4.../assets \
-H "Authorization: Bearer $TOKEN" \
-H "x-client-ref: cliente-42"
Sin body: las URLs ya están en la propiedad, así que no hay nada que mandar. Lo que hace es volver a intentar lo que quedó pendiente.
Es idempotente y determinista. Reintentar sobreescribe lo que ya se había bajado con el mismo resultado, así que llamarlo dos veces no duplica nada ni cambia las URLs. Si querés cambiar una imagen, eso es actualizar la propiedad, no reintentar.
Qué se acepta
| Formatos | |
|---|---|
| Fotos | JPEG · PNG · WebP |
| Plano | JPEG · PNG · WebP · PDF |
Un archivo vacío, de un tipo que no está en esa lista o que supera el tope de tamaño no se
reintenta solo: el bloque images te dice cuál y por qué, y eso se arregla cambiando el archivo de
tu lado.
Códigos de respuesta
| Código | Qué pasó |
|---|---|
200 | el reintento corrió; mirá el bloque images para ver cómo quedó |
400 | falta identificar al cliente, o el paId no es válido |
401 · 403 | token ausente, inválido o sin permiso de escritura |
404 | no hay una propiedad con ese paId para ese cliente |
409 | ya se están bajando ahora mismo. No es un error tuyo: esperá y volvé a leer la propiedad |
El 409 es la respuesta correcta a "reintentá mientras todavía está procesando". Reintentar en
loop sobre un 409 no acelera nada — la ingesta ya está corriendo.
Relacionado
- Alta de propiedades — donde las imágenes viajan la primera vez
GET /properties/{paId}— para leer el bloqueimagessin costo- Publicar un aviso — el flujo completo, y por qué las imágenes no bloquean publicar