RURBANIVE · Rural-Urban Enabler

RS4.0 — Servicios Rurales

RS4.0 (Servicios Rurales) es un marketplace digital geolocalizado que mejora el acceso a servicios profesionales en el medio rural. Los usuarios descubren proveedores en mapa o lista y contactan directamente; los proveedores ganan visibilidad territorial. La RUE está alojada por el consorcio y se integra en el Community Store de RURBANIVE mediante iFrame o enlace, exponiendo datos agregados FAIR del catálogo.

Dominio RURBANIVE 1 · logística y cadenas de valor más cortas · municipios rurales de Badajoz (Extremadura). Consorcio: dM Rural y Cámara de Comercio de Badajoz.

Abrir marketplace Vista embebible Documentación API

Para qué sirve esta RUE

Un Rural-Urban Enabler (RUE) es una solución digital del Open Call RURBANIVE para crear sinergias rural–urbanas. RS4.0 conecta necesidades reales del medio rural con proveedores cercanos, reduce desplazamientos innecesarios y da visibilidad territorial a servicios que hoy están dispersos.

Visibilidad de servicios rurales

La oferta está fragmentada. La RUE concentra proveedores verificados en un solo directorio geolocalizado para que vecinos y empresas encuentren lo que necesitan cerca.

Participación urbano–rural

Los proveedores urbanos y periurbanos no perciben demanda clara en el territorio. El marketplace muestra esa demanda y acorta las cadenas de valor.

Barreras digitales

Flujos simples, acompañamiento territorial (Cámara de Comercio de Badajoz) y recomendaciones supervisadas evitan cajas negras y generan confianza.

Cómo funciona

Recomendación HITL

El motor propone coincidencias por categoría, distancia, disponibilidad e historial. Una persona valida el resultado: Human-in-the-Loop, sin decisiones autónomas.

Datos FAIR

El catálogo agregado (JSON/CSV) es findable, accesible, interoperable y reutilizable.

Community Store

Integración A Soft (iFrame), B Link y C Deep (API). La RUE la aloja el consorcio y se embebe en el ecosistema RURBANIVE.

Integración Community Store

A Soft (iFrame): principal — https://servicios-rurales.vercel.app/embed
B Link: respaldo — https://servicios-rurales.vercel.app
C Deep: APIs FAIR de catálogo — documentación para webmasters

Código iFrame

<iframe src="https://servicios-rurales.vercel.app/embed" title="RS4.0 – Servicios Rurales" width="100%" height="800" loading="lazy" referrerpolicy="no-referrer-when-downgrade" allow="geolocation"></iframe>

Para integradores y webmasters

API RUE

Endpoints para reutilizar el catálogo de Servicios Rurales en el Community Store de RURBANIVE y en webs asociadas. Licencia CC-BY-4.0. Acceso con API key y permiso read.

GETAPI keyreadCORS *CC-BY-4.0

1. URLs

Base canónica: https://servicios-rurales.vercel.app. Las rutas siguientes son las definitivas; en producción se antepone esa base.

Método	Ruta	Uso
GET	`/api/rue/metadata` https://servicios-rurales.vercel.app/api/rue/metadata application/json	Metadata RUE. Identidad RS4.0, URLs de acceso, cumplimiento, principios FAIR y resúmenes multilingües.
GET	`/api/rue/catalogue` https://servicios-rurales.vercel.app/api/rue/catalogue application/json	Catálogo (JSON). Agregados por categoría, región y municipio. Opcionalmente, fichas de negocios.
GET	`/api/rue/catalogue?format=csv` https://servicios-rurales.vercel.app/api/rue/catalogue?format=csv text/csv	Catálogo (CSV). Misma información en CSV (`text/csv`) para reutilización tabular.
GET	`/api/rue/catalogue?include=listings&limit=100` https://servicios-rurales.vercel.app/api/rue/catalogue?include=listings&limit=100 application/json	Catálogo + listados. Agregados más hasta `limit` fichas (máx. 500).
GET	`/api/rue/embed-snippet` https://servicios-rurales.vercel.app/api/rue/embed-snippet application/json	Snippet iFrame. Código HTML y URLs para la integración A Soft en el Community Store.
GET	`/api/rue/openapi` https://servicios-rurales.vercel.app/api/rue/openapi application/json	OpenAPI 3.0. Especificación machine-readable de estos endpoints, parámetros y esquemas. `?lang=es\|en\|fi` cambia la lengua de las descripciones.

2. Documentación

Esta página es la descripción técnica: URLs, campos, filtros y autenticación.
OpenAPI 3.0.3 (Swagger): https://servicios-rurales.vercel.app/api/rue/openapi. Se puede importar en Swagger Editor, Postman o Scalar. Añade `?lang=en` o `?lang=fi` para otra lengua.
Metadata machine-readable (incluye estas URLs): https://servicios-rurales.vercel.app/api/rue/metadata

curl -sS -H "Authorization: Bearer $RUE_API_KEY" "https://servicios-rurales.vercel.app/api/rue/catalogue" | jq .summary
curl -sS -H "Authorization: Bearer $RUE_API_KEY" "https://servicios-rurales.vercel.app/api/rue/catalogue?include=listings&limit=20"

3. Esquema de respuesta

Los JSON usan UTF-8. Los campos de listado están aplanados (no hay objetos anidados de categoría o municipio).

GET /api/rue/catalogue

Raíz

Campo	Tipo	Detalle
`id`	string (uri)	Identificador persistente del dataset (`{SITE}/api/rue/catalogue`).
`schemaVersion`	string	Versión del contrato JSON. Actualmente `1.0`.
`title`	string	Título del dataset FAIR.
`license`	string	Texto de reutilización. Licencia CC-BY-4.0.
`licenseSpdx`	string	Identificador SPDX. Siempre `CC-BY-4.0`.
`licenseUrl`	string (uri)	URL canónica de la licencia.
`publisher`	object	Organización responsable del dataset.
`language`	string[]	Idiomas ISO 639-1 de la documentación del dataset.
`isDescribedBy`	string (uri)	URL de metadata (`/api/rue/metadata`).
`conformsTo`	string (uri)	URL de la especificación OpenAPI.
`landingPage`	string (uri)	Página humana del catálogo (`/rue`).
`coordinateReferenceSystem`	string	CRS de las coordenadas. Siempre `EPSG:4326` (WGS84).
`coordinatePrecisionDecimals`	integer	Decimales de lat/lng en `listings` (3 ≈ 100 m).
`spatialCoverage`	object	Cobertura territorial (país, región, provincia).
`provenance`	object	Origen, método de generación y contacto organizativo.
`keywords`	string[]	Palabras clave temáticas.
`description`	string	Descripción del dataset FAIR.
`generatedAt`	string (date-time)	Marca de tiempo ISO 8601 de generación.
`summary`	object	Totales del directorio aprobado.
`by_category`	object[]	Conteo de negocios aprobados por categoría.
`by_region`	object[]	Conteo de negocios y municipios por región activa.
`by_locality`	object[]	Conteo de negocios por municipio que tiene al menos un negocio aprobado.
`listings`opcional	object[]	Fichas de negocios. Solo con `include=listings`, máximo 500.
`listings_meta`opcional	object	Límite, filas devueltas, total aprobado y orden (`name`) cuando hay `listings`.

summary

Campo	Tipo	Detalle
`approved_businesses`	integer	Negocios con estado `aprobado`.
`categories`	integer	Categorías del marketplace.
`localities_with_businesses`	integer	Municipios con al menos un negocio aprobado.
`regions`	integer	Regiones activas.

by_category[]

Campo	Tipo	Detalle
`category_id`	string (uuid)	Identificador de la categoría.
`category_slug`	string	Slug de la categoría.
`category_name`	string	Nombre de la categoría.
`businesses`	integer	Negocios aprobados en esa categoría.
`url`	string (uri)	Página de búsqueda filtrada por esta categoría.

by_region[]

Campo	Tipo	Detalle
`region_id`	string (uuid)	Identificador de la región.
`region_name`	string	Nombre de la región.
`region_slug`	string	Slug de la región.
`businesses`	integer	Negocios aprobados en la región.
`localities`	integer	Municipios de la región (con o sin oferta).

by_locality[]

Campo	Tipo	Detalle
`locality_id`	string (uuid)	Identificador del municipio.
`locality_name`	string	Nombre del municipio.
`locality_slug`	string	Slug del municipio.
`region_id`	string (uuid)	Región a la que pertenece el municipio.
`businesses`	integer	Negocios aprobados en el municipio.

listings[] (include=listings)

Campo	Tipo	Detalle
`slug`	string	Identificador en la URL (`/negocio/{slug}`).
`name`	string	Nombre comercial.
`url`	string (uri)	Identificador persistente de la ficha (`/negocio/{slug}`).
`category_slug`	string \| null	Slug de categoría, o `null`.
`category_name`	string \| null	Nombre de categoría, o `null`.
`locality_name`	string \| null	Municipio, o `null`.
`region_name`	string \| null	Región, o `null`.
`lat`	number \| null	Latitud WGS84 redondeada a 3 decimales (~100 m), o `null`.
`lng`	number \| null	Longitud WGS84 redondeada a 3 decimales (~100 m), o `null`.
`rating`	number \| null	Valoración media (0–5), o `null` si no hay reseñas.
`reviews_count`	integer	Número de reseñas publicadas.

GET /api/rue/metadata

Raíz

Campo	Tipo	Detalle
`schemaVersion`	string	Versión del documento de metadata. Actualmente `1.0`.
`rue`	object	Identidad RS4.0: acrónimo, título, producto, dominio RURBANIVE, consorcio y territorio piloto.
`access`	object	URLs de integración A Soft (iFrame), B Link, página de catálogo y snippet HTML.
`endpoints`	object	URLs absolutas de metadata, catálogo JSON/CSV, snippet y OpenAPI.
`languages`	object	Idiomas de la aplicación y del Community Store.
`compliance`	object	HITL, responsable del tratamiento y correo de contacto.
`fair`	object	Principios FAIR.
`visualAssets`	object	URLs de logo, distintivo UE y logo RURBANIVE.
`generatedAt`	string (date-time)	Marca de tiempo ISO 8601 de generación.
`summaries`	object[]	Resúmenes cortos en varios idiomas para el Community Store.

summaries[]

Campo	Tipo	Detalle
`language`	string	Código ISO 639-1 (`en`, `es`, `el`, `de`, `cs`, `lt`, `fi`).
`languageName`	string	Nombre del idioma en inglés.
`title`	string	Título localizado.
`shortDescription`	string	Resumen corto para fichas del Community Store.
`longDescription`	string	Descripción larga del propósito de la RUE.

GET /api/rue/embed-snippet

Raíz

Campo	Tipo	Detalle
`integration`	string	Enfoque de integración. Siempre `A_soft_iframe`.
`embedUrl`	string (uri)	URL de la vista compacta embebible (`/embed`).
`fallbackUrl`	string (uri)	URL de respaldo (enfoque B Link) si el iFrame no está permitido.
`iframeSnippet`	string	Código HTML `<iframe>` listo para pegar.
`notes`	string[]	Notas de integración para el Community Store.

4. Paginación, filtros y límites

El catálogo agregado no está paginado: `by_category`, `by_region` y `by_locality` cubren todo el directorio aprobado. Las fichas (`listings`) no usan `page`/`offset`; se recortan con `limit`.

Parámetro	Valores	Detalle
`format`	json \| csv	Formato de respuesta. `json` (por defecto) o `csv`.
`include`	listings	Añade fichas si vale `listings`. Equivale a `listings=1`.
`listings`	1	Si vale `1`, incluye el array `listings` (mismo efecto que `include=listings`).
`limit`	1–500	Máximo de fichas en `listings`. Solo aplica con `include=listings`. Por defecto 100; mínimo 1; máximo 500.

Solo negocios con estado `aprobado`. `listings` se ordena por nombre y se corta a 100 por defecto (máx. 500).
No hay filtros por categoría, región o texto en esta API. Para búsqueda filtrada usa `GET /api/v1/businesses` y `GET /api/v1/search`.
Sin caché pública: `Cache-Control: private, no-store`.
CORS: `Access-Control-Allow-Origin: *` en todas las lecturas RUE. Solo método GET.
Estos endpoints no aplican el rate limit de `/api/v1`. Un uso abusivo puede limitarse en el borde; para volúmenes altos, escribid a hola@serviciosrurales.es.

5. Autenticación y API key

API key

Cada petición GET a `/api/rue/*` lleva `Authorization: Bearer <api_key>`. El permiso es `read`. Una clave inválida, revocada o ausente responde `401`.

Otras APIs

Escrituras, datos de cuenta o administración van por OAuth 2.1 en `/api/v1`.

Documentación canónica: https://servicios-rurales.vercel.app/rue#api

Resúmenes multilingües

English (en)

RURBAN SERVICES 4.0 – Rural services marketplace

AI-assisted marketplace connecting rural users with nearby service providers in Badajoz (Extremadura, Spain).

Spanish (es)

RURBAN SERVICES 4.0 – Marketplace de servicios rurales

Marketplace con asistencia IA que conecta usuarios rurales con proveedores cercanos en Badajoz (Extremadura, España).

Greek (el)

RURBAN SERVICES 4.0 – Αγορά αγροτικών υπηρεσιών

Ψηφιακή αγορά με υποβοήθηση ΤΝ που συνδέει αγροτικούς χρήστες με κοντινούς παρόχους υπηρεσιών στο Badajoz (Ισπανία).

German (de)

RURBAN SERVICES 4.0 – Marktplatz für ländliche Dienstleistungen

KI-unterstützter Marktplatz, der ländliche Nutzende mit nahen Dienstleistern in Badajoz (Extremadura, Spanien) verbindet.

Czech (cs)

RURBAN SERVICES 4.0 – Tržiště venkovských služeb

Tržiště s podporou AI propojující venkovské uživatele s blízkými poskytovateli služeb v Badajozu (Španělsko).

Lithuanian (lt)

RURBAN SERVICES 4.0 – Kaimo paslaugų rinka

DI padedama rinka, jungianti kaimo vartotojus su artimais paslaugų teikėjais Badachose (Ispanija).

Finnish (fi)

RURBAN SERVICES 4.0 – Maaseutupalveluiden markkinapaikka

Teköälyn avustama markkinapaikka, joka yhdistää maaseudun käyttäjiä lähellä oleviin palveluntarjoajiin Badajozissa (Espanja).