API i MCP – Tourism.one Data

Dostęp

Dane otwarte odczytasz bez klucza. Są to obiekty pochodzące wyłącznie ze źródeł z otwartą licencją.

Klucz klienta daje dostęp do danych regionu lub klienta, a w przypadku danych własnych także do zapisu. Jest wydawany tylko na zapytanie i wysyłany w nagłówku „Authorization: Bearer <klucz>”.

Poproś o klucz

Interfejs REST

Adres bazowy: https://data.tourism.one. Interfejs ma oznaczenie wersji 0; zmiany są jeszcze możliwe.

GET /api/v0/objects: Wyszukiwanie obiektów. Filtry: query, type (Place, Accommodation, Event, Tour, Organization), category, limit.
GET /api/v0/objects/{id}: Jeden obiekt ze wszystkimi danymi i ich pochodzeniem.
GET /objects/{id}: Ten sam obiekt jako JSON-LD (Schema.org). Język wybierasz parametrem lang.
GET /schema/v0.1/object.schema.json: Schemat JSON obiektów.
GET /api/v0/sources: Rejestr źródeł. Filtry: mode, category, status.
GET /api/v0/stats: Łączne liczby danych otwartych.
GET /api/v0/categories: Kategorie (taksonomia).
GET /api/v0/changes: Zmiany od wskazanego momentu (since).

Przykładowe zapytanie

curl "https://data.tourism.one/api/v0/sources?mode=read-only"
curl "https://data.tourism.one/api/v0/objects?type=Event&limit=5"
curl -H "Authorization: Bearer <key>" "https://data.tourism.one/api/v0/objects?query=sauna"

MCP dla asystentów AI

Przez punkt końcowy MCP https://mcp.tourism.one asystenci AI przeszukują dane, wyświetlają źródła i kategorie oraz sprawdzają pochodzenie poszczególnych informacji. Bez klucza dostęp jest tylko do odczytu i ogranicza się do danych otwartych.

Adres mcp.tourism.one jest obecnie w trakcie konfiguracji.

Przykładowa konfiguracja klienta MCP

Bez klucza (dane otwarte, tylko odczyt). Zapis konfiguracji różni się w zależności od klienta.

{
  "mcpServers": {
    "tourism-one-data": {
      "type": "http",
      "url": "https://mcp.tourism.one"
    }
  }
}

Z kluczem klienta (dane klienta, dane własne także do zapisu). Zastąp symbol zastępczy własnym kluczem i nigdy nie umieszczaj go w repozytorium.

{
  "mcpServers": {
    "tourism-one-data": {
      "type": "http",
      "url": "https://mcp.tourism.one",
      "headers": { "Authorization": "Bearer <key>" }
    }
  }
}

Narzędzia

Bez klucza (odczyt)

search_objects
get_object
find_nearby
list_events
list_changes
describe_schema
list_sources
list_categories

Z kluczem klienta

tenant_stats
search_tenant_objects
upsert_own_object
delete_own_object
export_tourismus_one

Zakres rośnie wraz z kolejnymi wersjami; wiążąca jest lista narzędzi, którą zwraca sam serwer.