PlatserAPI - Dokumentation

REST API

API:t är ett REST-liknande API som försöker följa HTTP-standarden samt endast kommunicera och ta emot JSON.

Basadress till testmiljö: http://api-t.svenskakyrkan.se/platser/v4

Basadress till produktionsmiljö: http://api.svenskakyrkan.se/platser/v4

Autentisering

API:t kräver autentisering med API-nyckel. För att få en API-nyckel måste man registrera sig:

Testmiljön api-t.svenskakyrkan.se (endast inom kyrknätet)

Produktionsmiljön api.svenskakyrkan.se

För att autentisera sina anrop krävs att man antingen anger sin API-nyckel i anropet som en queryparameter:

HTTP GET .../platser/v4/place?apikey=<apikey>

Alternativt kan man ange API-nyckeln som en HTTP header:

HTTP GET .../platser/v4/place
...
SvkAuthSvc-ApiKey: <apikey>
...

Om man utför ett anrop utan API-nyckel, eller med en ogiltig sådan, så kommer API:t att returnera 403 Not Authorized.

: Mer om APIt och dess resurser

: Sökning i APIt

Changelog

 

Version 4.1.0 (unreleased)

Version 4 (2021-06-21)