Desarrolladores
API y conectores de Ciber City
Con esto un negocio mantiene su catálogo de Ciber City al día desde su propia tienda o web, y cualquier sistema puede leer los negocios y catálogos publicados. Toda consulta de un cliente llega por WhatsApp con un mensaje que dice que lo encontró en Ciber City.
Conectores
WordPress y WooCommerce
Publica los productos de WooCommerce y los tipos de contenido que elijas (servicios, tours, planes, cursos) como productos o servicios. Cada entrada se puede incluir o excluir a mano. Funciona aunque el sitio tenga la API REST bloqueada.
- Instala el plugin y actívalo.
- En Ajustes → Ciber City elige qué publicar.
- Copia la dirección de conexión y entrégala a quien administra tu ficha.
PrestaShop 1.7 y 8
Publica los productos activos con precio, precio antes del descuento, existencias, foto y categoría.
- Sube el módulo en Módulos → Subir un módulo.
- En Configurar copia la dirección de conexión.
Shopify
No necesita instalar nada: toda tienda Shopify publica su catálogo en /products.json. Basta con dar la dirección de la tienda, por ejemplo https://mitienda.myshopify.com.
WooCommerce sin plugin
Si la tienda tiene abierta la Store API de WooCommerce (/wp-json/wc/store/v1/products), Ciber City puede leerla directamente. El plugin es preferible porque también publica servicios.
Ciber City lee cada catálogo todas las noches y, si el conector tiene activado el aviso, también un minuto después de cada cambio. Se publican tantos productos como permita el plan del negocio (Starter 20, Shop 100, Grow 300).
Formato de catálogo (feed v1)
Cualquier sistema puede publicar su catálogo en este formato JSON en una dirección protegida con clave (?clave=...). Es el mismo que generan los conectores.
{
"version": 1,
"source": "woocommerce",
"store": {
"name": "Mi tienda",
"url": "https://mitienda.com/",
"currency": "COP"
},
"generated_at": "2026-10-28T20:00:00+00:00",
"items": [
{
"id": "123",
"type": "producto",
"name": "Café de origen 500 g",
"description": "Café especial del Meta, tostado medio.",
"price": 32000,
"regular_price": 36000,
"currency": "COP",
"in_stock": true,
"url": "https://mitienda.com/producto/cafe-500g",
"image": "https://mitienda.com/cafe.jpg",
"category": "Café"
},
{
"id": "88",
"type": "servicio",
"name": "Tour cafetero",
"description": "Recorrido por la finca con cata.",
"price": 0,
"regular_price": 0,
"in_stock": true,
"url": "https://mitienda.com/tour",
"image": null,
"category": "Experiencias"
}
]
}
| Campo | Uso |
|---|---|
| id | Identificador estable en tu sistema. Si cambia, Ciber City lo trata como un producto nuevo. |
| type | producto o servicio. Cambia el texto del mensaje de WhatsApp. |
| price, regular_price | Precio actual y precio antes del descuento. 0 muestra "Consultar precio". |
| currency | ISO 4217. Si no es COP, el precio se muestra como texto en la descripción. |
| in_stock | false marca el producto como agotado. |
| url, image, category | Página del producto en tu tienda, foto principal (Ciber City guarda una copia optimizada) y categoría. |
Los productos que desaparecen del feed se ocultan en Ciber City; no se borran, así que vuelven si reaparecen.
API v1
Lectura pública, sin clave, de los negocios publicados. Respuestas en JSON, límite de 120 consultas por minuto por IP.
| Método y ruta | Devuelve |
|---|---|
| GET /api/v1/negocios | Negocios publicados. Filtros: q, categoria, municipio, por_pagina (máx. 100), page. |
| GET /api/v1/negocios/{slug} | Ficha completa: contacto, redes, horario, coordenadas y enlace al catálogo. |
| GET /api/v1/negocios/{slug}/catalogo | Productos y servicios activos con precio, foto, enlace y WhatsApp con el mensaje de Ciber City. |
| GET /api/v1/categorias | Categorías con el número de negocios publicados. |
| POST /api/v1/catalogo/sincronizar | Pide releer el catálogo de un negocio. Requiere la clave de su conector. |
curl https://ciber.city/api/v1/negocios?municipio=Villavicencio&q=cafe
curl https://ciber.city/api/v1/negocios/masu-coffee
curl https://ciber.city/api/v1/negocios/masu-coffee/catalogo
Sincronizar al instante
Los conectores lo hacen solos. Desde otro sistema, envía la clave del conector en la cabecera X-CiberCity-Key. Máximo 10 llamadas por minuto.
curl -X POST https://ciber.city/api/v1/catalogo/sincronizar \
-H "X-CiberCity-Key: TU_CLAVE"
¿Necesitas ayuda para conectar tu tienda? Escríbenos a hola@ciber.city.
