Vefþjónustur í Sarpi

Vefþjónustur (API) gera aðildarsöfnum kleift að sækja eða uppfæra gögn úr Sarpi sjálfvirkt, t.d. til birtingar á ytri vef, til tengingar við önnur kerfi eða til gagnasöfnunar og tölfræði. Þetta sparar handvirka vinnu og tryggir samræmda miðlun milli kerfa.

Tveir kostir fyrir aðildarsöfn

• Nota vefþjónustur (API) sem fylgja kerfinu til að sækja/birta gögn á eigin vefum.
• Nota gagnasett sem starfsfólk Sarps skilgreinir fyrir safnið og vinna út frá þeim (einfaldara fyrir marga).

Helstu hugtök

• REST API – algeng samskiptaleið; svör yfirleitt í JSON.
• SOAP þjónusta – eldri staðall; skil oft í XML.
• API-lykill – auðkennir beiðnir (passaðu öryggi).
• Endapunktur (endpoint) – slóð þjónustunnar, t.d. /api/objects.
• Síur/parametrar – móta niðurstöðu, t.d. ?type=myndlist&limit=20.

Skref fyrir skref — Nota vefþjónustu

1. Sækja aðgangslykil hjá kerfisstjóra og varðveita örugglega.
2. Velja endapunkt miðað við hvaða gögn á að sækja/uppfæra og setja viðeigandi síur.
3. Keyra beiðni með Postman eða í forritun (t.d. JavaScript/Python) — setja lykil í haus (Authorization).
4. Vinna úr gögnum (JSON/XML) og flytja í vef/kerfi eftir þörf.

Öryggi og verklag

• Geymdu API-lykil á öruggum stað; aldrei í opinberum kóðageymslum eða skjölum.
• Notaðu test-umhverfi og litlar fyrirspurnir til að byrja.
• Skráðu (loggaðu) status-kóða og villur til að auðvelda bilanaleit.