Skall-krav

Åtkomst till data

• All data ska vara öppen och åtkomlig via APIer (utan extra kostnad för Sundsvalls kommunkoncern)

Åtkomst till funktion

• Alla funktioner som går att exekvera via applikationens användargränssnitt skall även gå att exekvera via APIer (utan extra kostnad för Sundsvalls kommunkoncern)

Interoperabilitet

• Det ska finnas öppna ramverk i lösningen som möjliggör integration mot andra applikationer

• Leverantören är medveten om att Sundsvalls kommunkoncern har avtal med andra leverantörer och är skyldig att (utan extra kostnad för Sundsvalls kommunkoncern) säkerställa och tillgängliggöra information och data för att Sundsvalls kommunkoncern ska kunna integrera lösningen från Leverantören med annan leverantörs lösningar

Bedömning av kravuppfyllnad

Åtkomst till data/åtkomst till funktion

Sundsvalls kommunkoncerns API-strategi, och till den kopplade riktlinjer för API-design, säger att:

• APIer skall exponeras som REST APIer och följa OpenAPI Specification (https://swagger.io/specification/ )

• API-standarder skall användas i så stor utsträckning som möjligt (uppfinn inte hjulet i onödan)

  • Exempel: SensorThings API (https://en.wikipedia.org/wiki/SensorThings_API ) för APIer som hanterar sensor-data

• Om API-standard saknas skall APIer designas i enlighet med grundprinciperna för REST (https://sv.wikipedia.org/wiki/Representational_State_Transfer )

Underlag till bedömning av kravuppfyllnad

Sundsvalls kommunkoncern kommer att utvärdera er uppfyllnad av vår API-strategi samt er kompatibilitet med kommunkoncernens API-strategi. Vi utvärderar i första hand utifrån om era API:er följer OpenAPI Specification samt om era API:er följer standarder inom det område er lösning verkar. För att få fullt reduktionsvärde skall båda uppfyllas.

Om ni ej uppfyller dessa delar, men kan leverera API:er utifrån grundprinciper för REST. Så får ni del av reduktionsvärde.

Om ni ej uppfyller någon del uppnås inget reduktionsvärde.

Beskriv vilka standarder och protokoll ert API är baserat på.

Interoperabilitet

Sundsvalls kommunkoncern har behov av att bygga integrerade lösningar med applikationer i det digitala arvet som använder olika tekniker och protokoll för integration, som till exempel REST, SOAP, JMS, FTP.

Beskriv vilka standarder och protokoll er lösning har stöd för att bygga integrationer mot (REST, SOAP, JMS, FTP, mm). Beskriv även vilket programmeringsspråk och ramverk ni använder.

Underlag till bedömning av kravuppfyllnad

Högst reduktionsvärde nås genom att er lösning har öppna gränssnitt enligt icke proprietär standard samt där ni kan påvisa en öppen och standardiserad dokumentation av dessa gränssnitt.