Ricky logorickyDocs

Subir la foto de una ubicación

POST
/knowledge/locations/{location_id}/photo

Inicia una carga en tres pasos: esta llamada responde la ubicación y una upload_url; envía los bytes con PUT a esa URL; luego llama a POST /knowledge/locations/{location_id}/photo/complete. Una ubicación tiene una sola foto: subir otra la reemplaza cuando la carga termina, y mientras tanto se queda la actual.

Permiso: knowledge:write.

Autorización

bearerAuth
headerAuthorizationBearer <clave>

Una clave de API de la organización, rky_live_…, creada en Configuración → API. Envíala solo desde un servidor.

Parámetros de ruta

location_id*string

ID de la ubicación.

Formatouuid

Parámetros de cabecera

Idempotency-Key?string

Opcional. Un valor que eliges, único por escritura lógica, de 8 a 200 caracteres: un UUID o un ID de tu sistema, como order-10482-ready. Reintentar con la misma clave y el mismo cuerpo repite la primera respuesta en lugar de repetir la escritura.

Longitud8 <= length <= 200

Cuerpo de la solicitud

application/json
  1. body

Inicia una carga. Ricky responde adónde enviar los bytes con PUT.

mime_type*string

Tipo de archivo: JPEG o PNG, de hasta 5 MB.

Uno de"image/jpeg""image/png"
size_bytes*integer

Tamaño exacto del archivo que vas a subir.

Rango1 <= value <= 9007199254740991

Cuerpo de la respuesta

Éxito.

application/json
  1. response
data*

Una ubicación, con su foto actual, y dónde poner los bytes de la siguiente.

curl -X POST 'https://getricky.ai/api/v1/knowledge/locations/497f6eca-6276-4993-bfeb-53cbbbba6f08/photo' \  -H 'Idempotency-Key: order-10482-ready' \  -H 'Content-Type: application/json' \  -d '{  "mime_type": "image/jpeg",  "size_bytes": 482133}'
{  "data": {    "location": {      "id": "c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f",      "name": "Casa Nativa Albrook",      "address": "Albrook Mall, local 214, Panamá",      "latitude": 8.9733,      "longitude": -79.5511,      "street": "Albrook Mall, local 214",      "city": "Panamá",      "state": "Panamá",      "postal_code": null,      "country": "Panamá",      "country_code": "PA",      "phone": "+50760000000",      "email": "albrook@example.com",      "hours": "Lunes a sábado, 10:00 a 20:00",      "photo": {        "mime_type": "image/jpeg",        "size_bytes": 482133,        "download_url": null      }    },    "upload_url": "https://storage.example.com/upload/sign/media/d9e0f1a2-b3c4-4d5e-8f6a-7b8c9d0e1f2a/knowledge/locations/c3d4e5f6-a7b8-4c9d-8e0f-1a2b3c4d5e6f/f1a2b3c4-d5e6-4f7a-8b9c-0d1e2f3a4b5c.jpg?token=…"  }}

Eliminar una ubicación DELETE

La elimina de forma definitiva y la responde tal como estaba. Permiso: `knowledge:write`.

Quitar la foto de una ubicación DELETE

Quita la foto y cualquier carga en curso, y responde la ubicación. Las copias ya enviadas en conversaciones se quedan ahí. Una ubicación sin foto se queda igual. Permiso: `knowledge:write`.