
<TEI xmlns="http://www.tei-c.org/ns/1.0" xmlns:h="http://www.w3.org/1999/xhtml" xmlns:t="http://www.tei-c.org/ns/1.0">
  <teiHeader xml:lang="de">
    <fileDesc>
      <titleStmt>
        <title type="main">API</title>
        <author>
          <persName>
            <forename>Gerlinde</forename>
            <surname>Schneider</surname>
          </persName>
        </author>
        <respStmt>
          <resp>Projektleitung</resp>
          <persName>
            <forename>Helmut W.</forename>
            <surname>Klug</surname>
          </persName>
        </respStmt>
        <respStmt>
          <resp>Datenmodellierung</resp>
          <persName>
            <forename>Selina</forename>
            <surname>Galka</surname>
          </persName>
        </respStmt>
        <respStmt>
          <resp>Datenmodellierung</resp>
          <persName>
            <forename>Elisabeth</forename>
            <surname>Steiner</surname>
          </persName>
        </respStmt>
        <funder>Bundesministerium für Wissenschaft, Forschung und Wirtschaft
                    </funder>
      </titleStmt>
      <publicationStmt>
        <publisher>
          <orgName corresp="https://informationsmodellierung.uni-graz.at" ref="http://d-nb.info/gnd/1137284463">Zentrum für
                        Informationsmodellierung - Austrian Centre for Digital Humanities,
                        Karl-Franzens-Universität Graz</orgName>
          <country>Austria</country>
        </publisher>
        <authority>
          <orgName corresp="https://informationsmodellierung.uni-graz.at" ref="http://d-nb.info/gnd/1137284463">Zentrum für
                        Informationsmodellierung - Austrian Centre for Digital Humanities,
                        Karl-Franzens-Universität Graz</orgName>
          <country>Austria</country>
        </authority>
        <distributor>
          <orgName ref="https://gams.uni-graz.at">GAMS - Geisteswissenschaftliches
                        Asset Management System</orgName>
        </distributor>
        <availability>
          <licence target="https://creativecommons.org/licenses/by-nc/4.0">Creative Commons
                            BY 4.0</licence>
        </availability>
        <date when="2021">2021</date>
        <pubPlace>Graz</pubPlace>
        <idno type="PID">o:konde.31</idno>
      </publicationStmt>
      <seriesStmt>
        <title ref="http://gams.uni-graz.at/konde">KONDE Weißbuch</title>
        <respStmt>
          <resp>Projektleitung</resp>
          <persName>
            <forename>Helmut W.</forename>
            <surname>Klug</surname>
          </persName>
        </respStmt>
      </seriesStmt>
      <sourceDesc>
        <bibl>
          <title>Weißbuchartikel: API</title>
          <author>Gerlinde Schneider</author>
          <publisher>Herausgegeben von Helmut W. Klug unter Mitarbeit von Selina Galka und Elisabeth Steiner</publisher>
          <date>2021</date>
          <country>Austria</country>
        </bibl>
      </sourceDesc>
    </fileDesc>
    <encodingDesc>
      <projectDesc>
        <ab>
          <ref target="info:fedora/context:konde" type="context">KONDE Weißbuch</ref>
        </ab>
        <p>Im KONDE-Projekt, das aus Hochschulraumstrukturmitteln finanziert wird,
                        beschäftigten sich sieben universitäre Partner und drei weitere
                        Einrichtungen aus unterschiedlichen Blickwinkeln mit theoretischen und
                        praktischen Aspekten der Digitalen Edition. Ein Outcome des Projektes
                        stellt das Weißbuch dar, welches über 200 Artikel zum Thema Digitale
                        Edition umfasst. Die behandelten Themenkomplexe reichen dabei über
                        Digitale Editionswissenschaft im Allgemeinen, Annotation und
                        Modellierung, Interfaces, Archivierung und Metadaten bis hin zu
                        rechtlichen Aspekten.</p>
      </projectDesc>
    </encodingDesc>
    <profileDesc>
      <langUsage>
        <language ident="de">Deutsch</language>
      </langUsage>
    </profileDesc>
  </teiHeader>
  <text xml:lang="de">
    <body>
      <div>
        <head>API</head>
        <div>
          <head>Schneider, Gerlinde; gerlinde.schneider@uni-graz.at</head>
          <p>
            <hi rend="italic">Application Programming Interfaces</hi> (API) – im Deutschen als Programmierschnittstellen bezeichnet – ermöglichen es, auf eine definierte Weise auf maschinlesbare Daten zuzugreifen. Diese Schnittstellen machen eine Kommunikation/einen Datenaustausch von Maschinen untereinander möglich, ohne Rücksicht auf dahinter liegende Systeme und Technologien nehmen zu müssen. </p>
          <p>Von besonderer Relevanz sind sogenannte RESTFul APIs (REST steht für <hi rend="italic">Representational State Transfer</hi>). Diese setzen auf den Webstandards HTTP und HTML auf und erlauben es, auf Daten/Ressourcen kontrolliert über URLs zuzugreifen. Das ermöglicht es, Webanwendungen mit Daten aus verschiedenen, verteilten Ressourcen zu speisen. Gängige Formate zum Datenaustausch sind <ref target="/o:konde.215" type="internal">XML</ref> und JSON sowie immer öfter auch das <ref target="/o:konde.131" type="internal">RDF</ref>-basierte JSON-LD-Format. <bibl>(Richardson/Amundsen 2013, S. 274f.)</bibl>
          </p>
          <p>Auch im Bereich der <ref target="/o:konde.59" type="internal">Digitalen Edition</ref> ist in den letzten Jahren eine zunehmende Nutzung von APIs feststellbar. Editionen sind dabei nicht mehr ausschließlich als statischer Text zu betrachten <bibl>(Bleier/Klug 2018, S.VIf.)</bibl>, sondern werden immer mehr zu Anwendungen, die einerseits externe Daten konsumieren und zur Beantwortung von Forschungsfragen mit eigenen Daten verknüpfen <bibl>(Witt 2018, S. 255 ff.)</bibl> und andererseits selbst Daten zur Wieder- und Weiterverwendung bereitstellen. Im ersten Fall greifen Editionen beispielsweise als Clients auf Schnittstellen zu und integrieren die erhaltenen Daten beispielsweise auf Ebene der Benutzeroberfläche oder durch Anreicherung auf Datenebene.</p>
          <p>Für Digitale Editionen relevante APIs sind z. B. die APIs des <hi rend="italic">
              <ref target="/o:konde.123" type="internal">International Image Interoperability Framework</ref>

            </hi> (IIIF), die einen definierten Zugriff auf Bildobjekte und -sammlungen anbieten, sowie die API des Webservices <hi rend="italic">correspSearch</hi>, die es ermöglicht, auf aggregierte Metadaten zu unterschiedlichsten Briefeditionen zuzugreifen. In diesem Bereich wurden in den letzten Jahren einige beispielhafte, unmittelbar für Editionen einsetzbare Client-Anwendungen entwickelt bzw. adaptiert (z. B. <hi rend="italic">Mirador Open</hi> und <hi rend="italic">OpenSeadragon</hi> für IIIF, <hi rend="italic">csLink</hi> für <hi rend="italic">correspSearch</hi>). In der klassischen Philologie Verbreitung findet <hi rend="italic">Canonical Text Services</hi> (CTS), ein Protokoll zur Identifizierung und Abfrage von Textpassagen über kanonische Referenzen. Zur Identifizierung und Anreicherung von editorischen Daten kommen außerdem häufig APIs mit universellerer Ausrichtung zur Anwendung. Hier zu nennen sind die Schnittstellen von Normdateien wie der <ref target="/o:konde.109" type="internal">GND</ref> oder von themenbezogenen Datenbanken wie etwa <hi rend="italic">
              <ref target="/o:konde.107" type="internal">GeoNames</ref>
            </hi> im geografischen Bereich. Auch allgemeine Wissensbasen wie <ref target="/o:konde.112" type="internal">Wikidata</ref> und <hi rend="italic">DBpedia</hi> werden über deren Schnittstellen abgefragt und profitieren selbst immer öfter von Daten aus Digitalen Editionen, die über die entsprechenden APIs in den Datenpool zurückgespielt werden. </p>
          <div type="literature">
            <listBibl>
              <biblStruct corresp="http://zotero.org/groups/1332658/items/3QRUAKSA" type="bookSection" xml:id="Bleier2018b">
                <analytic>
                  <title level="a">Discussing Interfaces in Digital Scholarly Editing</title>
                  <author>
                    <forename>Roman</forename>
                    <surname>Bleier</surname>
                  </author>
                  <author>
                    <forename>Helmut W.</forename>
                    <surname>Klug</surname>
                  </author>
                </analytic>
                <monogr>
                  <title level="m">Digital Scholarly Editions as Interfaces</title>
                  <idno type="ISBN">978-3-7481-0925-9</idno>
                  <editor>
                    <forename>Roman</forename>
                    <surname>Bleier</surname>
                  </editor>
                  <editor>
                    <forename>Martina</forename>
                    <surname>Bürgermeister</surname>
                  </editor>
                  <editor>
                    <forename>Helmut W.</forename>
                    <surname>Klug</surname>
                  </editor>
                  <editor>
                    <forename>Frederike</forename>
                    <surname>Neuber</surname>
                  </editor>
                  <editor>
                    <forename>Gerlinde</forename>
                    <surname>Schneider</surname>
                  </editor>
                  <imprint>
                    <pubPlace>Norderstedt</pubPlace>
                    <biblScope unit="volume">12</biblScope>
                    <biblScope unit="page">V-XV</biblScope>
                    <publisher>BoD</publisher>
                    <date>2018</date>
                    <note type="accessed">2020-04-25T08:17:20Z</note>
                    <note type="url">https://kups.ub.uni-koeln.de/9094/</note>
                  </imprint>
                </monogr>
                <series>
                  <title level="s">SIDE</title>
                </series>
              </biblStruct>
              <biblStruct corresp="http://zotero.org/groups/1332658/items/QAQ2BTWP" type="journalArticle" xml:id="Dumont2016">
                <analytic>
                  <title level="a">correspSearch – Connecting Scholarly Editions of Letters</title>
                  <author>
                    <forename>Stefan</forename>
                    <surname>Dumont</surname>
                  </author>
                </analytic>
                <monogr>
                  <title level="j">Journal of the Text Encoding Initiative</title>
                  <imprint>
                    <biblScope unit="issue">10</biblScope>
                    <date>2016</date>
                    <note type="url">http://journals.openedition.org/jtei/1742</note>
                  </imprint>
                </monogr>
              </biblStruct>
              <biblStruct corresp="http://zotero.org/groups/1332658/items/GPFR2F7A" type="book" xml:id="Richardson2013">
                <monogr>
                  <title level="m">RESTful Web APIs</title>
                  <author>
                    <forename>Leonard</forename>
                    <surname>Richardson</surname>
                  </author>
                  <author>
                    <forename>Mike</forename>
                    <surname>Amundsen</surname>
                  </author>
                  <imprint>
                    <pubPlace>Beijing u.a.</pubPlace>
                    <publisher>O&apos;Reilly</publisher>
                    <date>2013</date>
                  </imprint>
                </monogr>
              </biblStruct>
              <biblStruct corresp="http://zotero.org/groups/1332658/items/ZY75VTVU" type="bookSection" xml:id="Witt2018">
                <analytic>
                  <title level="a">Digital Scholarly Editions and API Consuming Applications</title>
                  <author>
                    <forename>Jeffrey C</forename>
                    <surname>Witt</surname>
                  </author>
                </analytic>
                <monogr>
                  <title level="m">Digital Scholarly Editions as Interfaces</title>
                  <idno type="ISBN">978-3-7481-0925-9</idno>
                  <editor>
                    <forename>Roman</forename>
                    <surname>Bleier</surname>
                  </editor>
                  <editor>
                    <forename>Martina</forename>
                    <surname>Bürgermeister</surname>
                  </editor>
                  <editor>
                    <forename>Helmut W.</forename>
                    <surname>Klug</surname>
                  </editor>
                  <editor>
                    <forename>Frederike</forename>
                    <surname>Neuber</surname>
                  </editor>
                  <editor>
                    <forename>Gerlinde</forename>
                    <surname>Schneider</surname>
                  </editor>
                  <imprint>
                    <pubPlace>Norderstedt</pubPlace>
                    <biblScope unit="volume">12</biblScope>
                    <biblScope unit="page">219–247</biblScope>
                    <publisher>BoD</publisher>
                    <date>2018</date>
                    <note type="accessed">2020-04-25T08:02:33Z</note>
                    <note type="url">https://kups.ub.uni-koeln.de/9118/</note>
                  </imprint>
                </monogr>
                <series>
                  <title level="s">SIDE</title>
                </series>
              </biblStruct>
            </listBibl>
          </div>
          <div type="subsection" xml:id="projects">
            <list>
              <item>
                <ref target="https://iiif.io" type="external">International Image Interoperability Framework</ref>
              </item>
              <item>
                <ref target="https://projectmirador.org" type="external">Mirador</ref>
              </item>
              <item>
                <ref target="https://openseadragon.github.io" type="external">OpenSeadragon</ref>
              </item>
              <item>
                <ref target="https://correspsearch.net" type="external">correspSearch</ref>
              </item>
              <item>
                <ref target="https://github.com/correspSearch/csLink" type="external">csLink</ref>
              </item>
              <item>
                <ref target="http://cite-architecture.github.io/cts_spec/specification.html#cts" type="external">Canonical Text Services</ref>
              </item>
              <item>
                <ref target="https://wiki.dbpedia.org" type="external">DBpedia</ref>
              </item>
              <item>
                <ref target="https://json-ld.org/" type="external">JSON-LD</ref>
              </item>
            </list>
          </div>
          <div type="subsection" xml:id="software">
            <list>
              <item>
                <ref target="https://www.wikidata.org/wiki/Wikidata:Main_Page" type="external">Wikidata</ref>
              </item>
              <item>
                <ref target="geonames.org" type="external">Geonames</ref>
              </item>
              <item>
                <ref target="https://github.com/dbpedia-spotlight/dbpedia-spotlight/wiki" type="external">DBpedia Spotlight</ref>
              </item>
            </list>
          </div>
          <div type="subsection" xml:id="links">
            <list>
              <item>
                <ref target="/o:konde.123" type="internal">IIIF</ref>
              </item>
              <item>
                <ref target="/o:konde.107" type="internal">Geonames</ref>
              </item>
              <item>
                <ref target="/o:konde.109" type="internal">GND</ref>
              </item>
              <item>
                <ref target="/o:konde.112" type="internal">Wikidata</ref>
              </item>
              <item>
                <ref target="/o:konde.59" type="internal">Digitale Edition</ref>
              </item>
              <item>
                <ref target="/o:konde.87" type="internal">Bereitstellung von Forschungsdaten</ref>
              </item>       
     </list>
          </div>
          <div type="subsection" xml:id="topics">
            <list>
              <item>Archivierung</item>
              <item>Software und Softwareentwicklung</item>
            </list>
          </div>
        </div>
      </div>
    </body>
  </text>
</TEI>
