{ "openapi": "3.0.0", "info": { "title": "DCAT-AP CH RDF API", "description": "This API exposes all Open Data of a provider, as RDF/XML using the\nDCAT-AP CH v1 (eCH-0200)\nprofile.
\nIt can be used for harvesting by another catalog (e.g. opendata.swiss).\n\nEvery viageo provider gets a unique entrypoint, ending with a dedicated slug.
\nThe slug is the same as the provider's storefront slug.\n\nThis service is not authenticated, and exposes only public Open Data.\n", "termsOfService": "https://viageo.ch/conditions-generales", "contact": { "name": "ASIT Support", "url": "https://viageo.ch/#support", "email": "support@viageo.ch" }, "version": "1.0.0" }, "paths": { "/api/catalog/dcat-ch/{slug}": { "get": { "summary": "List all public geodata, flagged as Open Data.", "description": "To be exposed, a geodata must:\n- Be Open Data\n- Have an optimal or partial Open Data compliance (geodata with insufficient Open Data compliance won't be exposed)\n\nOutput is serialized as XML/RDF using the recommendations of opendata.swiss handbook.\n\nOutput is paginated using Hydra Vocabulary.", "operationId": "get_catalog_api_dcat_provider.fr", "parameters": [ { "name": "slug", "in": "path", "description": "Unique slug of the provider", "required": true, "schema": { "type": "string" } }, { "name": "page", "in": "query", "description": "Hydra page number, 1 by default", "schema": { "type": "integer" } } ], "responses": { "404": { "description": "Provider slug not found" }, "200": { "description": "Sample XML/RDF output :
\n
\n
<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<rdf:RDF xmlns:dcat=\"http://www.w3.org/ns/dcat#\" xmlns:dct=\"http://purl.org/dc/terms/\" xmlns:foaf=\"http://xmlns.com/foaf/0.1/\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema#\" xmlns:rdfs=\"http://www.w3.org/2000/01/rdf-schema#\" xmlns:rdf=\"http://www.w3.org/1999/02/22-rdf-syntax-ns#\" xmlns:vcard=\"http://www.w3.org/2006/vcard/ns#\" xmlns:schema=\"http://schema.org/\" xmlns:hydra=\"http://www.w3.org/ns/hydra/core#\" xmlns:locn=\"http://www.w3.org/ns/locn#\">\n  <dcat:Catalog rdf:about=\"https://viageo.ch/fournisseur/demo-provider#catalog\">\n    <dcat:dataset>\n      <dcat:Dataset rdf:about=\"https://viageo.ch/md/4e143119-fefc-4a96-b78f-a0e01abfd1c7\">\n        <dct:identifier>4e143119-fefc-4a96-b78f-a0e01abfd1c7@demo-provider</dct:identifier>\n        <dct:title xml:lang=\"fr\">Carte d'ensoleillement</dct:title>\n        <dct:publisher>\n          <foaf:Agent rdf:about=\"https://viageo.ch/fournisseur/demo-provider\">\n            <foaf:name xml:lang=\"fr\">ASIT VD</foaf:name>\n          </foaf:Agent>\n        </dct:publisher>\n        <dcat:contactPoint>\n          <vcard:Individual>\n            <vcard:fn>John Doe, Gestionnaire de la donn\u00e9e</vcard:fn>\n            <vcard:hasEmail rdf:resource=\"mailto:test-collaborateur-1@demo-provider.tld\"/>\n          </vcard:Individual>\n        </dcat:contactPoint>\n        <dcat:contactPoint>\n          <vcard:Individual>\n            <vcard:fn>John Doe, Responsable de diffusion</vcard:fn>\n            <vcard:hasEmail rdf:resource=\"mailto:test-collaborateur-1@demo-provider.tld\"/>\n          </vcard:Individual>\n        </dcat:contactPoint>\n        <dct:description xml:lang=\"fr\">Carte issue des relev\u00e9s de l'ensoleillement re\u00e7u par les terrasses au boulevard de Grancy.\n    Mots-cl\u00e9: cadastre, soleil, relev\u00e9, thermique.</dct:description>\n        <dcat:landingPage rdf:resource=\"https://viageo.ch/md/4e143119-fefc-4a96-b78f-a0e01abfd1c7\"/>\n        <dct:spatial/>\n        <dct:language rdf:resource="http://publications.europa.eu/resource/authority/language/FRA"/>\n        <schema:image schema:URL=\"https://viageo.ch/uploads/resource_images/thumb_641c0effe897c.png\"/>\n        <dcat:theme rdf:resource=\"http://dcat-ap.ch/vocabulary/themes/geography\"/>\n        <dcat:theme rdf:resource=\"http://dcat-ap.ch/vocabulary/themes/territory\"/>\n        <dct:accrualPeriodicity rdf:resource=\"http://publications.europa.eu/resource/authority/frequency/CONT\"/>\n        <dct:issued rdf:datatype=\"http://www.w3.org/2001/XMLSchema#dateTime\">2023-03-23T00:00:00</dct:issued>\n        <dcat:distribution>\n          <dcat:Distribution rdf:about=\"https://viageo.ch/md/4e143119-fefc-4a96-b78f-a0e01abfd1c7?format=PDF#orderAction\">\n            <dct:language rdf:resource="http://publications.europa.eu/resource/authority/language/FRA"/>\n            <dct:title xml:lang=\"fr\">Carte d'ensoleillement (PDF)</dct:title>\n            <dct:description xml:lang=\"fr\">Commander sur viageo.ch</dct:description>\n            <dcat:accessURL rdf:resource=\"https://viageo.ch/md/4e143119-fefc-4a96-b78f-a0e01abfd1c7#orderAction\"/>\n            <dct:format>PDF</dct:format>\n            <dct:issued rdf:datatype=\"http://www.w3.org/2001/XMLSchema#dateTime\">2023-03-23T00:00:00</dct:issued>\n            <dct:license rdf:resource="http://dcat-ap.ch/vocabulary/licenses/terms_ask"/>\n          </dcat:Distribution>\n        </dcat:distribution>\n        <dcat:distribution>\n          <dcat:Distribution rdf:about=\"https://viageo.ch/md/4e143119-fefc-4a96-b78f-a0e01abfd1c7?format=PDF#downloadAction\">\n            <dct:language rdf:resource="http://publications.europa.eu/resource/authority/language/FRA"/>\n            <dct:title xml:lang=\"fr\">Carte d'ensoleillement (DXF)</dct:title>\n            <dct:description xml:lang=\"fr\">T\u00e9l\u00e9charger sur viageo.ch</dct:description>\n            <dcat:accessURL rdf:resource=\"https://viageo.ch/md/4e143119-fefc-4a96-b78f-a0e01abfd1c7#downloadAction\"/>\n            <dcat:downloadURL rdf:resource=\"https://viageo.ch/md/4e143119-fefc-4a96-b78f-a0e01abfd1c7#downloadAction\"/>\n            <dct:format>DXF</dct:format>\n            <dct:issued rdf:datatype=\"http://www.w3.org/2001/XMLSchema#dateTime\">2023-03-23T00:00:00</dct:issued>\n            <dct:license rdf:resource="http://dcat-ap.ch/vocabulary/licenses/terms_ask"/>\n          </dcat:Distribution>\n        </dcat:distribution>\n      </dcat:Dataset>\n    </dcat:dataset>\n  </dcat:Catalog>\n  <hydra:PagedCollection rdf:about=\"https://viageo.ch/api/catalog/dcat-ch/unique-slug?page=3\">\n    <hydra:lastPage>https://viageo.ch/api/catalog/dcat-ch/unique-slug?page=4</hydra:lastPage>\n    <hydra:itemsPerPage rdf:datatype=\"http://www.w3.org/2001/XMLSchema#integer\">1000</hydra:itemsPerPage>\n    <hydra:totalItems rdf:datatype=\"http://www.w3.org/2001/XMLSchema#integer\">3479</hydra:totalItems>\n    <hydra:firstPage>https://viageo.ch/api/catalog/dcat-ch/unique-slug?page=1</hydra:firstPage>\n    <hydra:previousPage>https://viageo.ch/api/catalog/dcat-ch/unique-slug?page=2</hydra:previousPage>\n  </hydra:PagedCollection>\n</rdf:RDF>\n
" } } }, "head": { "summary": "List all public geodata, flagged as Open Data.", "description": "To be exposed, a geodata must:\n- Be Open Data\n- Have an optimal or partial Open Data compliance (geodata with insufficient Open Data compliance won't be exposed)\n\nOutput is serialized as XML/RDF using the recommendations of opendata.swiss handbook.\n\nOutput is paginated using Hydra Vocabulary.", "operationId": "head_catalog_api_dcat_provider.fr", "parameters": [ { "name": "slug", "in": "path", "description": "Unique slug of the provider", "required": true, "schema": { "type": "string" } }, { "name": "page", "in": "query", "description": "Hydra page number, 1 by default", "schema": { "type": "integer" } } ], "responses": { "404": { "description": "Provider slug not found" }, "200": { "description": "Sample XML/RDF output :
\n
\n
<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n<rdf:RDF xmlns:dcat=\"http://www.w3.org/ns/dcat#\" xmlns:dct=\"http://purl.org/dc/terms/\" xmlns:foaf=\"http://xmlns.com/foaf/0.1/\" xmlns:xsd=\"http://www.w3.org/2001/XMLSchema#\" xmlns:rdfs=\"http://www.w3.org/2000/01/rdf-schema#\" xmlns:rdf=\"http://www.w3.org/1999/02/22-rdf-syntax-ns#\" xmlns:vcard=\"http://www.w3.org/2006/vcard/ns#\" xmlns:schema=\"http://schema.org/\" xmlns:hydra=\"http://www.w3.org/ns/hydra/core#\" xmlns:locn=\"http://www.w3.org/ns/locn#\">\n  <dcat:Catalog rdf:about=\"https://viageo.ch/fournisseur/demo-provider#catalog\">\n    <dcat:dataset>\n      <dcat:Dataset rdf:about=\"https://viageo.ch/md/4e143119-fefc-4a96-b78f-a0e01abfd1c7\">\n        <dct:identifier>4e143119-fefc-4a96-b78f-a0e01abfd1c7@demo-provider</dct:identifier>\n        <dct:title xml:lang=\"fr\">Carte d'ensoleillement</dct:title>\n        <dct:publisher>\n          <foaf:Agent rdf:about=\"https://viageo.ch/fournisseur/demo-provider\">\n            <foaf:name xml:lang=\"fr\">ASIT VD</foaf:name>\n          </foaf:Agent>\n        </dct:publisher>\n        <dcat:contactPoint>\n          <vcard:Individual>\n            <vcard:fn>John Doe, Gestionnaire de la donn\u00e9e</vcard:fn>\n            <vcard:hasEmail rdf:resource=\"mailto:test-collaborateur-1@demo-provider.tld\"/>\n          </vcard:Individual>\n        </dcat:contactPoint>\n        <dcat:contactPoint>\n          <vcard:Individual>\n            <vcard:fn>John Doe, Responsable de diffusion</vcard:fn>\n            <vcard:hasEmail rdf:resource=\"mailto:test-collaborateur-1@demo-provider.tld\"/>\n          </vcard:Individual>\n        </dcat:contactPoint>\n        <dct:description xml:lang=\"fr\">Carte issue des relev\u00e9s de l'ensoleillement re\u00e7u par les terrasses au boulevard de Grancy.\n    Mots-cl\u00e9: cadastre, soleil, relev\u00e9, thermique.</dct:description>\n        <dcat:landingPage rdf:resource=\"https://viageo.ch/md/4e143119-fefc-4a96-b78f-a0e01abfd1c7\"/>\n        <dct:spatial/>\n        <dct:language rdf:resource="http://publications.europa.eu/resource/authority/language/FRA"/>\n        <schema:image schema:URL=\"https://viageo.ch/uploads/resource_images/thumb_641c0effe897c.png\"/>\n        <dcat:theme rdf:resource=\"http://dcat-ap.ch/vocabulary/themes/geography\"/>\n        <dcat:theme rdf:resource=\"http://dcat-ap.ch/vocabulary/themes/territory\"/>\n        <dct:accrualPeriodicity rdf:resource=\"http://publications.europa.eu/resource/authority/frequency/CONT\"/>\n        <dct:issued rdf:datatype=\"http://www.w3.org/2001/XMLSchema#dateTime\">2023-03-23T00:00:00</dct:issued>\n        <dcat:distribution>\n          <dcat:Distribution rdf:about=\"https://viageo.ch/md/4e143119-fefc-4a96-b78f-a0e01abfd1c7?format=PDF#orderAction\">\n            <dct:language rdf:resource="http://publications.europa.eu/resource/authority/language/FRA"/>\n            <dct:title xml:lang=\"fr\">Carte d'ensoleillement (PDF)</dct:title>\n            <dct:description xml:lang=\"fr\">Commander sur viageo.ch</dct:description>\n            <dcat:accessURL rdf:resource=\"https://viageo.ch/md/4e143119-fefc-4a96-b78f-a0e01abfd1c7#orderAction\"/>\n            <dct:format>PDF</dct:format>\n            <dct:issued rdf:datatype=\"http://www.w3.org/2001/XMLSchema#dateTime\">2023-03-23T00:00:00</dct:issued>\n            <dct:license rdf:resource="http://dcat-ap.ch/vocabulary/licenses/terms_ask"/>\n          </dcat:Distribution>\n        </dcat:distribution>\n        <dcat:distribution>\n          <dcat:Distribution rdf:about=\"https://viageo.ch/md/4e143119-fefc-4a96-b78f-a0e01abfd1c7?format=PDF#downloadAction\">\n            <dct:language rdf:resource="http://publications.europa.eu/resource/authority/language/FRA"/>\n            <dct:title xml:lang=\"fr\">Carte d'ensoleillement (DXF)</dct:title>\n            <dct:description xml:lang=\"fr\">T\u00e9l\u00e9charger sur viageo.ch</dct:description>\n            <dcat:accessURL rdf:resource=\"https://viageo.ch/md/4e143119-fefc-4a96-b78f-a0e01abfd1c7#downloadAction\"/>\n            <dcat:downloadURL rdf:resource=\"https://viageo.ch/md/4e143119-fefc-4a96-b78f-a0e01abfd1c7#downloadAction\"/>\n            <dct:format>DXF</dct:format>\n            <dct:issued rdf:datatype=\"http://www.w3.org/2001/XMLSchema#dateTime\">2023-03-23T00:00:00</dct:issued>\n            <dct:license rdf:resource="http://dcat-ap.ch/vocabulary/licenses/terms_ask"/>\n          </dcat:Distribution>\n        </dcat:distribution>\n      </dcat:Dataset>\n    </dcat:dataset>\n  </dcat:Catalog>\n  <hydra:PagedCollection rdf:about=\"https://viageo.ch/api/catalog/dcat-ch/unique-slug?page=3\">\n    <hydra:lastPage>https://viageo.ch/api/catalog/dcat-ch/unique-slug?page=4</hydra:lastPage>\n    <hydra:itemsPerPage rdf:datatype=\"http://www.w3.org/2001/XMLSchema#integer\">1000</hydra:itemsPerPage>\n    <hydra:totalItems rdf:datatype=\"http://www.w3.org/2001/XMLSchema#integer\">3479</hydra:totalItems>\n    <hydra:firstPage>https://viageo.ch/api/catalog/dcat-ch/unique-slug?page=1</hydra:firstPage>\n    <hydra:previousPage>https://viageo.ch/api/catalog/dcat-ch/unique-slug?page=2</hydra:previousPage>\n  </hydra:PagedCollection>\n</rdf:RDF>\n
" } } } } } }