RURBANIVE · Rural-Urban Enabler

RS4.0 — Servicios Rurales

RS4.0 (Servicios Rurales) on paikannettu digitaalinen markkinapaikka, joka parantaa ammattipalveluiden saatavuutta maaseudulla. Konsortio isännöi RUE:ta; integrointi RURBANIVE Community Storeen tapahtuu iFramen tai linkin kautta FAIR-katalogidatan kera.

RURBANIVE-alue 1 · logistiikka ja lyhyemmät arvoketjut · Badajozin (Extremadura) maaseutukunnat. Konsortio: dM Rural ja Cámara de Comercio de Badajoz.

Avaa markkinapaikka Upotettava näkymä API-dokumentaatio

Mihin tätä RUE:ta käytetään

Rural-Urban Enabler (RUE) on RURBANIVE Open Callin digitaalinen ratkaisu maaseutu–kaupunki-synergioihin. RS4.0 yhdistää maaseudun todelliset tarpeet läheisiin palveluntarjoajiin, vähentää turhia matkoja ja antaa alueellista näkyvyyttä palveluille, jotka nyt ovat hajallaan.

Maaseutupalvelujen näkyvyys

Tarjonta on pirstaleista. RUE kokoaa varmennetut palveluntarjoajat yhteen paikannettuun hakemistoon, jotta naapurit ja yritykset löytävät tarvitsemansa läheltä.

Kaupunki–maaseutu-osallistuminen

Kaupunkien ja niiden reuna-alueiden palveluntarjoajat eivät näe alueella selvää kysyntää. Markkinapaikka näyttää sen kysynnän ja lyhentää arvoketjuja.

Digitaaliset esteet

Yksinkertaiset prosessit, alueellinen tuki (Cámara de Comercio de Badajoz) ja valvotut suositukset välttävät mustia laatikoita ja rakentavat luottamusta.

Miten se toimii

HITL-suositus

Moottori ehdottaa osumia kategorian, etäisyyden, saatavuuden ja historian mukaan. Ihminen vahvistaa tuloksen: Human-in-the-Loop, ilman autonomisia päätöksiä.

FAIR-data

Koottu luettelo (JSON/CSV) on findable, accessible, interoperable ja reusable.

Community Store

Integraatio A Soft (iFrame), B Link ja C Deep (API). Konsortio isännöi RUE:ta ja upottaa sen RURBANIVE-ekosysteemiin.

Community Store -integraatio

A Soft (iFrame): ensisijainen — https://servicios-rurales.vercel.app/embed
B Link: varalla — https://servicios-rurales.vercel.app
C Deep: FAIR-luettelon APIt — dokumentaatio webmastereille

iFrame-koodi

<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>

Integraattoreille ja webmastereille

RUE API

Päätepisteet Servicios Rurales -luettelon uudelleenkäyttöön RURBANIVE Community Storessa ja liittyvillä sivustoilla. Lisenssi CC-BY-4.0. Käyttö API key -avaimella ja `read`-oikeudella.

GETAPI keyreadCORS *CC-BY-4.0

1. URLs

Kanoninen kanta: https://servicios-rurales.vercel.app. Alla olevat reitit ovat lopullisia; tuotannossa niihin lisätään tuo kanta.

Menetelmä	Polku	Käyttö
GET	`/api/rue/metadata` https://servicios-rurales.vercel.app/api/rue/metadata application/json	RUE-metadata. RS4.0-identiteetti, käyttö-URLs, vaatimustenmukaisuus, FAIR-periaatteet ja monikieliset yhteenvedot.
GET	`/api/rue/catalogue` https://servicios-rurales.vercel.app/api/rue/catalogue application/json	Luettelo (JSON). Koosteet kategorian, alueen ja kunnan mukaan. Valinnaisesti yrityslistaukset.
GET	`/api/rue/catalogue?format=csv` https://servicios-rurales.vercel.app/api/rue/catalogue?format=csv text/csv	Luettelo (CSV). Sama tieto CSV-muodossa (`text/csv`) taulukkomuotoiseen uudelleenkäyttöön.
GET	`/api/rue/catalogue?include=listings&limit=100` https://servicios-rurales.vercel.app/api/rue/catalogue?include=listings&limit=100 application/json	Luettelo + listaukset. Koosteet plus enintään `limit` listausta (maks. 500).
GET	`/api/rue/embed-snippet` https://servicios-rurales.vercel.app/api/rue/embed-snippet application/json	iFrame-pätkä. HTML ja URLs A Soft -integraatioon Community Storessa.
GET	`/api/rue/openapi` https://servicios-rurales.vercel.app/api/rue/openapi application/json	OpenAPI 3.0. Näiden päätepisteiden, parametrien ja skeemojen koneellisesti luettava määritys. `?lang=es\|en\|fi` vaihtaa kuvausten kielen.

2. Dokumentaatio

Tämä sivu on tekninen kuvaus: URLs, kentät, suodattimet ja autentikointi.
OpenAPI 3.0.3 (Swagger): https://servicios-rurales.vercel.app/api/rue/openapi. Voit tuoda sen Swagger Editoriin, Postmaniin tai Scalariin. Lisää `?lang=es` tai `?lang=en` toiselle kielelle.
Koneellisesti luettava metadata (sisältää nämä 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. Vastauksen skeema

JSON käyttää UTF-8:aa. Listauskentät ovat litistettyjä (ei sisäkkäisiä kategoria- tai kuntakohteita).

GET /api/rue/catalogue

Juuri

Kenttä	Tyyppi	Yksityiskohta
`id`	string (uri)	Pysyvä dataset-tunniste (`{SITE}/api/rue/catalogue`).
`schemaVersion`	string	JSON-sopimuksen versio. Nykyisin `1.0`.
`title`	string	FAIR-datasetin otsikko.
`license`	string	Uudelleenkäyttöteksti. Lisenssi CC-BY-4.0.
`licenseSpdx`	string	SPDX-tunniste. Aina `CC-BY-4.0`.
`licenseUrl`	string (uri)	Lisenssin kanoninen URL.
`publisher`	object	Datasetistä vastaava organisaatio.
`language`	string[]	Dataset-dokumentaation ISO 639-1 -kielet.
`isDescribedBy`	string (uri)	Metadatan URL (`/api/rue/metadata`).
`conformsTo`	string (uri)	OpenAPI-määrityksen URL.
`landingPage`	string (uri)	Luettelon ihmisille tarkoitettu sivu (`/rue`).
`coordinateReferenceSystem`	string	Koordinaattien CRS. Aina `EPSG:4326` (WGS84).
`coordinatePrecisionDecimals`	integer	lat/lng-desimaalit `listings`-taulukossa (3 ≈ 100 m).
`spatialCoverage`	object	Alueellinen kattavuus (maa, alue, maakunta).
`provenance`	object	Alkuperä, tuottotapa ja organisaation yhteystieto.
`keywords`	string[]	Temaattiset avainsanat.
`description`	string	FAIR-datasetin kuvaus.
`generatedAt`	string (date-time)	ISO 8601 -aikaleima tuotannolle.
`summary`	object	Hyväksytyn hakemiston kokonaismäärät.
`by_category`	object[]	Hyväksyttyjen yritysten määrä kategorian mukaan.
`by_region`	object[]	Yritysten ja kuntien määrä aktiivisen alueen mukaan.
`by_locality`	object[]	Yritysten määrä kunnittain, joissa on vähintään yksi hyväksytty yritys.
`listings`valinnainen	object[]	Yrityslistaukset. Vain `include=listings` kanssa, enintään 500.
`listings_meta`valinnainen	object	Raja, palautetut rivit, hyväksytty kokonaismäärä ja järjestys (`name`), kun `listings` on mukana.

summary

Kenttä	Tyyppi	Yksityiskohta
`approved_businesses`	integer	Yritykset tilassa `aprobado`.
`categories`	integer	Markkinapaikan kategoriat.
`localities_with_businesses`	integer	Kunnat, joissa on vähintään yksi hyväksytty yritys.
`regions`	integer	Aktiiviset alueet.

by_category[]

Kenttä	Tyyppi	Yksityiskohta
`category_id`	string (uuid)	Kategorian tunniste.
`category_slug`	string	Kategorian slug.
`category_name`	string	Kategorian nimi.
`businesses`	integer	Hyväksytyt yritykset kyseisessä kategoriassa.
`url`	string (uri)	Tällä kategorialla suodatettu hakusivu.

by_region[]

Kenttä	Tyyppi	Yksityiskohta
`region_id`	string (uuid)	Alueen tunniste.
`region_name`	string	Alueen nimi.
`region_slug`	string	Alueen slug.
`businesses`	integer	Hyväksytyt yritykset alueella.
`localities`	integer	Alueen kunnat (tarjonnalla tai ilman).

by_locality[]

Kenttä	Tyyppi	Yksityiskohta
`locality_id`	string (uuid)	Kunnan tunniste.
`locality_name`	string	Kunnan nimi.
`locality_slug`	string	Kunnan slug.
`region_id`	string (uuid)	Alue, johon kunta kuuluu.
`businesses`	integer	Hyväksytyt yritykset kunnassa.

listings[] (include=listings)

Kenttä	Tyyppi	Yksityiskohta
`slug`	string	Tunniste URL-osoitteessa (`/negocio/{slug}`).
`name`	string	Toiminimi.
`url`	string (uri)	Listauksen pysyvä tunniste (`/negocio/{slug}`).
`category_slug`	string \| null	Kategorian slug tai `null`.
`category_name`	string \| null	Kategorian nimi tai `null`.
`locality_name`	string \| null	Kunta tai `null`.
`region_name`	string \| null	Alue tai `null`.
`lat`	number \| null	WGS84-leveysaste pyöristettynä 3 desimaaliin (~100 m) tai `null`.
`lng`	number \| null	WGS84-pituusaste pyöristettynä 3 desimaaliin (~100 m) tai `null`.
`rating`	number \| null	Keskiarvo (0–5) tai `null`, jos arvosteluja ei ole.
`reviews_count`	integer	Julkaistujen arvostelujen määrä.

GET /api/rue/metadata

Juuri

Kenttä	Tyyppi	Yksityiskohta
`schemaVersion`	string	Metadata-asiakirjan versio. Nykyisin `1.0`.
`rue`	object	RS4.0-identiteetti: lyhenne, otsikko, tuote, RURBANIVE-alue, konsortio ja pilottialue.
`access`	object	A Soft (iFrame), B Link, luettelosivu ja HTML-pätkä -URLs.
`endpoints`	object	Absoluuttiset URLs metadatalle, JSON/CSV-luettelolle, pätkälle ja OpenAPI:lle.
`languages`	object	Sovelluksen ja Community Storen kielet.
`compliance`	object	HITL, rekisterinpitäjä ja yhteyssähköposti.
`fair`	object	FAIR-periaatteet.
`visualAssets`	object	Logon, EU-tunnuksen ja RURBANIVE-logon URLs.
`generatedAt`	string (date-time)	ISO 8601 -aikaleima tuotannolle.
`summaries`	object[]	Lyhyet yhteenvedot useilla kielillä Community Storelle.

summaries[]

Kenttä	Tyyppi	Yksityiskohta
`language`	string	ISO 639-1 -koodi (`en`, `es`, `el`, `de`, `cs`, `lt`, `fi`).
`languageName`	string	Kielen nimi englanniksi.
`title`	string	Lokalisoitu otsikko.
`shortDescription`	string	Lyhyt yhteenveto Community Storen korteille.
`longDescription`	string	RUE:n tarkoituksen pitkä kuvaus.

GET /api/rue/embed-snippet

Juuri

Kenttä	Tyyppi	Yksityiskohta
`integration`	string	Integraatiotapa. Aina `A_soft_iframe`.
`embedUrl`	string (uri)	Upotettavan tiiviin näkymän URL (`/embed`).
`fallbackUrl`	string (uri)	Varalla oleva URL (B Link), jos iFrame ei ole sallittu.
`iframeSnippet`	string	Liitettävä HTML-`<iframe>`-koodi.
`notes`	string[]	Integraatiomuistiinpanot Community Storelle.

4. Sivutus, suodattimet ja rajat

Koottua luetteloa ei sivuteta: `by_category`, `by_region` ja `by_locality` kattavat koko hyväksytyn hakemiston. Listaukset (`listings`) eivät käytä `page`/`offset`; ne rajataan `limit`-arvolla.

Parametri	Arvot	Yksityiskohta
`format`	json \| csv	Vastausmuoto. `json` (oletus) tai `csv`.
`include`	listings	Lisää listaukset, kun arvo on `listings`. Sama kuin `listings=1`.
`listings`	1	Kun `1`, sisältää taulukon `listings` (sama vaikutus kuin `include=listings`).
`limit`	1–500	Enimmäismäärä `listings`-taulukossa. Vain `include=listings` kanssa. Oletus 100; minimi 1; maksimi 500.

Vain yritykset tilassa `aprobado`. `listings` järjestetään nimen mukaan ja rajataan oletuksena 100 (maks. 500).
Tässä APIssa ei ole suodattimia kategorian, alueen tai tekstin mukaan. Suodatettuun hakuun käytä `GET /api/v1/businesses` ja `GET /api/v1/search`.
Ei julkista välimuistia: `Cache-Control: private, no-store`.
CORS: `Access-Control-Allow-Origin: *` kaikissa RUE-luvuissa. Vain GET.
Nämä päätepisteet eivät käytä `/api/v1`-nopeusrajaa. Väärinkäyttöä voidaan rajoittaa reunalla; suurille volyymeille kirjoita hola@serviciosrurales.es.

5. Autentikointi ja API key

API key

Jokainen GET osoitteeseen `/api/rue/*` lähettää `Authorization: Bearer <api_key>`. Oikeus on `read`. Puuttuva, virheellinen tai peruttu avain palauttaa `401`.

Muut APIt

Kirjoitukset, tilitiedot tai hallinta kulkevat OAuth 2.1:n kautta `/api/v1`:ssä.

Kanoninen dokumentaatio: https://servicios-rurales.vercel.app/rue#api

Monikieliset yhteenvedot

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).