Resultater af forespørgsler¶
JSON er et almindeligt tekstformat med forud-bestemte definitioner. Det er et format som er nemt for systemer at Parse og udtrække de netop oplysninger, som brugeren skal anvende.
Resultatet af en forespørgsel er en JSON-tekst, der ser ud som følger:
{
"path": "/najugaq/municipality/1/search",
"terms": "https://doc.test.data.gl/terms",
"requestTimestamp": "2017-06-30T04:28:58.986-02:00",
"responseTimestamp": "2017-06-30T04:28:59.049-02:00",
"username": "[cp______er@magenta.dk]@[Na_________er]",
...
"results: [
... ]
}
- “path”: fortæller kilden til informationerne og dermed kender man også søgetypen, der har været anvendt.
- “terms”: er link til de betingelser og regler, der gælder for data fra datafordeleren. De ses også på siden med Betingelser.
- “requestTimestamp”: er tidspunktet for hvornår serveren fik henvendelsen
- “responseTimestamp”: er tidspunktet for hvornår serveren afleverede resultatet
- “username”: er identifikationen for den anvender, som har bedt om data. Det vil være tomt, hvis brugernavn ikke er anvendt.
- ... Listen fortsætter med flere oplysninger om forespørgselen og her kan også findes fejlbeskeder.
- “results:” starter resultaterne for søgningen.
- ... Indholdet og nøgleord vil variere efter søgningerne, der har været anvendt. Søgemulighederne er beskrevet i den fælles deklaration for API’ere på API-deklarationer.