Sveriges dataportal, DIGG - Myndigheten för digital förvaltning
Sök data Nyheter Om oss Community
  • Hem
  • Kategorier
  • Senaste
  • Taggar
  • Populära
  • Användare
  • Grupper
  • Sök
  • Ser ut som din anslutning till %1 gick förlorad, vänta medan vi försöker att återansluta.
  • Registrera
  • Logga in

Navigering

    Förslag till nationell API-profil på Utvecklarportalen

    Data
    api-hantering api utvecklarportalen openapi
    9
    20
    549
    RSS Feed
    Laddar fler inlägg
    • Äldst till nyaste
    • Nyaste till äldst
    • Flest röster
    Svara
    • Svara som ämne
    Logga in för att posta
    Det här ämnet har raderats. Endast användare med ämneshanterings-privilegier kan se det.
    • M
      Magnus Sälgö @Magnus Sälgö Senaste redigerad av

      @jonass annan vag tanke med DOI för dataset var att man skulle kunna ha dom som GITHUB subject (Wikidata egenskap P9100 - video tankar) för att göra lösningar med ett visst dataset mer findable

      dvs. det skall vara enklare att hitta lösningar som skapats med visst dataset... känns lite som om du också varit inne på detta att det vore inte helt fel att tänka på samma sätt med olika API:er att man hittar en "konvention" kanske med GITHUB ämne så man enkelt hittar vilka lösningar som skapats med ett API.... så att andra kommer igång snabbt... leker en del på Kaggle och där är det självklart att koppla kod med dataset

      Skrev lite om det på GITHUB community forum.... idag är det ofta forskare som är duktiga på att ange DOI för sina vetenskapliga papper och tillhörande dataset...

      5cede088-124f-4bb8-94e5-83308023d783-image.png

      • "How to Cite Datasets and Link to Publications"
      J Ett svar Senaste svaret Svara Citera Gilla 1 Post Tools Trigger
      • J
        jonor @vesstrom Senaste redigerad av

        @vesstrom Jag förstod utan större problem det övriga innehållet på sidan om hypermedia fram till det sista stycket. Där introduceras plötsligt begreppet "händelser" utan någon särskild motivering när man tidigare pratat om transaktioner, länkrelationer och typer.

        Jag gick direkt in på sidan om hypermedia, så jag vet inte om man möjligen refererar underförstått till något som tas upp i andra delar av API-handledningen. Eller handlar det om att överföra befintliga RPC-liknande API:er till ett hypermedia-baserat gränssnitt?

        De exempel som förekommer på sidan handlar om organisationer och kontotransaktioner, och där det gäller egna relationstyper anges svenska uttryck som "insättning" och "uttag" (är det realistiska exempel?).

        Varför inte i så fall nämna "insättning, uttag och överföring" som exempel på domänspecifika typer då de redan tagits upp i ett sammanhang. Om nu detta också utgör ett exempel på vad man vill kalla "händelser" så kanske det uttrycket kan nämnas redan där det finns en kontext, t.ex. koppla det till ordet "transaktioner" som annars verkar användas för exemplen med "insättning", "uttag", "överföring", "edit", "replace", "delete".

        "Olika typer av händelser" skulle kanske tydligare beskrivas av "representera domänspecifika händelseorienterade operationer som relationstyper/transaktioner" eller något liknande, och samtidigt referera till exemplen med kontotransaktioner (domänspecifika) och organisationer (standard).

        Något som också är oklart är varför det är asterisker i relationstyperna, är det kanske ursprungligen märkspråk för fetstil i exemplet?

        Inklistrat som vanlig inläggstext:

        {"rel": " insättning", "href":"/konton/12345/insattning"},
        {"rel": " uttag", "href":"/konton/12345/uttag"},
        {"rel": " överföring", "href":"/konton/12345/overforing"}

        {
             "kontonummer":"12345",
             "balans": 100.00,
             "_links":[
                 {"rel": " **insättning**", "href":"/konton/12345/insattning"},
                 {"rel": " **uttag**", "href":"/konton/12345/uttag"},
                 {"rel": " **överföring**", "href":"/konton/12345/overforing"}
             ]
        }
        
        {
          "kontonummer":"12345",
          "balans": -25.00,
          "_links":[{
            "rel": "insättning",
            "href":"/konton/12345/insattning"
          }]
        }
        
        vesstrom Ett svar Senaste svaret Svara Citera Gilla 2 Post Tools Trigger
        • vesstrom
          vesstrom @jonor Senaste redigerad av

          @jonor Uppskattar att du är engagerad och intresserad av vad vi tagit fram. Som sagt så finns det utrymme för förbättringar och delar som behöver förtydligas i texten. Dina åsikter är relevanta och vi ser gärna att du använder vår enkät som vi har för att mer formellt samla in feedback på REST API profilen.
          Läs mer om detta här, https://www.digg.se/publicerat/remisser-och-yttranden/remisser-fran-digg/2020/lamna-synpunkter-pa-nationell-rest-api-profil

          Tack

          J Ett svar Senaste svaret Svara Citera Gilla 2 Post Tools Trigger
          • J
            jonass @Magnus Sälgö Senaste redigerad av

            @salgo60-ej-aktiv För en handling, ett dokument, eller en forskningsartikel känns det naturligt att ha en unik global identifierare. Spontant tänker jag dock att ett DOI/sameAs attribut som i googles exempel gäller hela datasetet (en samling dokument, handlingar, forskningsartiklar), och kanske är en mer fråga för https://docs.dataportal.se/dcat/sv/. Dvs att objektet "datamängd" borde ha en identifierare. Hoppas att en expert på DCAT-AP-Se läser och tycker till.

            Exempel från arbetsmarknaden när det är svårt att få dataproducenter att tagga sitt innehåll med en unik identifierare (jobbannonser förekommer ofta på många sajter).

            Dubbletthantering: https://gitlab.com/arbetsformedlingen/joblinks/job_ad_hash/-/tree/develop

            Tjänst: https://arbetsformedlingen.se/platsbanken/annonser?s=2

            https://en.wikipedia.org/wiki/Jaccard_index och https://en.wikipedia.org/wiki/MinHash används för att identifiera informationsmängder som har stort överlapp.

            Konsekvensen av att inte använda bra identifierare blir ju precis som du säger att det är svårt att i efterhand sortera upp informationen rätt.

            D Ett svar Senaste svaret Svara Citera Gilla 3 Post Tools Trigger
            • J
              jonor @vesstrom Senaste redigerad av

              @vesstrom Tack, jag ser gärna en öppen dialog då jag även är intresserad av att ta del av andras synpunkter och erfarenheter och följa diskussionen.

              Ett svar Senaste svaret Svara Citera Gilla 1 Post Tools Trigger
              • D
                Dennis_Priskorn @jonass Senaste redigerad av Dennis_Priskorn

                @jonass sa i Förslag till nationell API-profil på Utvecklarportalen:

                Exempel från arbetsmarknaden när det är svårt att få dataproducenter att tagga sitt innehåll med en unik identifierare (jobbannonser förekommer ofta på många sajter).

                jag känner mig inte förvånad. 🙂

                Dubbletthantering: https://gitlab.com/arbetsformedlingen/joblinks/job_ad_hash/-/tree/develop

                Tjänst: https://arbetsformedlingen.se/platsbanken/annonser?s=2

                https://en.wikipedia.org/wiki/Jaccard_index och https://en.wikipedia.org/wiki/MinHash används för att identifiera informationsmängder som har stort överlapp.

                Intressant

                Konsekvensen av att inte använda bra identifierare blir ju precis som du säger att det är svårt att i efterhand sortera upp informationen rätt.

                Exakt och det är jobbigt för alla inblandade. Ett jobbuppslag är en historisk unik händelse. Den berättar mycket om vår samtid och om organisationen. Det är en värdefull datapunkt men behandlas att döma efter vad du skriver ovan styvmoderligt av alla inblandade...

                Sparar riksarkivet alla annonser? Kan jag lätt kolla upp alla annonser SJ/Banverket hade ute i 1936? Är de bra kvalitet så jag kan köra NLP topic classification på dem? Kanske visualisera elektrifieringen av järnvägen med jobbannonserna som prism?

                För att detta ska kunna göras så MÅSTE vi ha bra data med unika identifierare i grunden och gärna även grafdata som beskriver rollen de söker (tex backendutvecklare Q110245834 != frontendutvecklare Q54568999 != webbutvecklare Q6859454). För att detta ska funka måste vi ha in rollerna i en graf som vi kan peka på. Här har jag angett Wikidata QID men AF eller nån annan skulle lika väl kunna ha sin egen graf som beskriver varenda typ av jobb som förekommer eller har förekommit någonsin på svenska arbetsmarknaden.

                Om ni vill ha hjälp att skapa en sådan graf så hojta till 🙂 Era samarbetspartners och resten av världen kommer älska er! Inget har gjort det öppet än (@salgo60-ej-aktiv gissar att LinkedIn redan gör detta, men de håller korten tät till kroppen så det har inget allmänt värde för samhället utan syftar till vinstmaximering hos dem)

                Jag skrev just riksarkivet
                "Hej
                Jag undrar om ni sparat jobbannonser från 1900-talet? Tex från banverket så jag kan se hur elektrifieringen påverkade jobbannonserna över tid?

                Är de digitaliserade? Om inte, är det planerad? Vad är ETA på det arbetet i så fall?"

                J Ett svar Senaste svaret Svara Citera Gilla 1 Post Tools Trigger
                • J
                  jonass @Dennis_Priskorn Senaste redigerad av

                  @dennis_priskorn https://data.arbetsformedlingen.se/annonser/historiska här kan annonser för åren 2006-2021 laddas ner.

                  Ett svar Senaste svaret Svara Citera Gilla 0 Post Tools Trigger
                  • Stefan Wallin
                    Stefan Wallin @Kristine_ Senaste redigerad av

                    @kristine_ ni säger att ni vill ta emot synpunkter på ett strukturerat sätt. Men ändå vill ni ha en enkät med fritext. Varför publicerar ni inte API-profilen som ett gäng markdown-filer i ett publikt repo på exvis github eller gitlab så att kommentarer kan göras i kontext?

                    ”Tala till de lärde på de lärdes vis och till apor på apors vis”.

                    Jag vill passa på att berömma att ni öppnar upp för feedback i en såpass tidig fas ändå!👏👏🤩

                    Kristine_ Ett svar Senaste svaret Svara Citera Gilla 3 Post Tools Trigger
                    • Kristine_
                      Kristine_ @Stefan Wallin Senaste redigerad av

                      @stefan-wallin
                      Bra input, just idag använde vi inte Markdown men vi tar med oss frågan för hur vi långsiktigt ska arbeta med profilen och playbooken.

                      Hälsningar, Kristine

                      Admin på Sveriges dataportal och community

                      Ett svar Senaste svaret Svara Citera Gilla 1 Post Tools Trigger
                      • Moved from Tipsa och fråga by  Maria_Dalhage Maria_Dalhage 
                      • P
                        Peter_Bengtsson Senaste redigerad av

                        Finns det en möjlighet att följa arbetet med API-profilen eller annars någon tidplan alternativt uppskattning av hur stora förändringar som förväntas som man kan ta del av?

                        Jordbruksverket är i ett läge där vi arbetar med att låta API:er ta en mer central roll i både applikations- och integrationsutveckling, vilket gör att behovet av förutsägbarhet kring API-profilen ökar då vi önskar utgå från den.

                        jenniferskoglund Ett svar Senaste svaret Svara Citera Gilla 2 Post Tools Trigger
                        • jenniferskoglund
                          jenniferskoglund @Peter_Bengtsson Senaste redigerad av

                          @peter_bengtsson Vad kul att ni är intresserade och vill följa arbetet!
                           
                          REST API-profilen har varit ute på remiss där personer som jobbar med utveckling av API:er har fått möjlighet att lämnar synpunkter. De inkomna synpunkterna hanteras och bearbetas nu av DIGG tillsammans med arbetsgruppen kring utvecklingen av REST API-profilen.
                           
                          Vår plan är att releasa (publicera) och fastställa version 1.0 av REST-API Profilen inom ramen för Q2. På grund av att vi genomför en migrering av CMS (Content Management System) har vi svårt att lova någon specifik tidsplan och det gör det svårt att följa arbetet.

                          Om ni har mer specifika frågor kopplat till något specifikt område i profilen kontakta info@digg.se. Jordbruksverket har lämnat synpunkter på profilen, så det har vi med oss.
                           
                          Läs mer om profilen på vår webbplats Utvecklarportalen, https://dev.dataportal.se/sv/rest-api--profil/.

                          Läs mer om synpunktsarbetet på vår webbplats, https://www.digg.se/publicerat/remisser-och-yttranden/remisser-fran-digg/2020/lamna-synpunkter-pa-nationell-rest-api-profil.

                          Observera att det inte längre går att skicka in synpunkter.

                          Handläggare DIGG - Moderator på forumet för Sveriges dataportal

                          P Ett svar Senaste svaret Svara Citera Gilla 1 Post Tools Trigger
                          • P
                            Peter_Bengtsson @jenniferskoglund Senaste redigerad av

                            @jenniferskoglund

                            Tackar för svaret! Q2 är ändå någonting att förhålla sig till. 🙂

                            Jag är en av de som var med och tog fram synpunkterna för Jordbruksverkets räkning, så skulle det uppstå några frågor är det bara att höra av sig.

                            Ett svar Senaste svaret Svara Citera Gilla 3 Post Tools Trigger
                            • Första inlägg
                              Sista inlägg