<divid="doc"class="markdown-body container-fluid"><h1id="API-for-ordbokuibno-beta"><aclass="anchor hidden-xs"href="#API-for-ordbokuibno-beta"title="API-for-ordbokuibno-beta"><iclass="fa fa-link"></i></a>API for <ahref="http://ordbok.uib.no"target="_blank"rel="noopener">ordbok.uib.no</a> (beta)</h1><h2id="Innledning"><aclass="anchor hidden-xs"href="#Innledning"title="Innledning"><iclass="fa fa-link"></i></a>Innledning</h2><p>Denne REST-APIen gir tilgang til JSON-representasjon av alle oppslag (artikler) i ordbøkene for bokmål og nynorsk fra Språkrådet og UiB. Det er fire endepunkt i APIen: <ahref="#Direkte-oppslag">direkte oppslag</a>, <ahref="#Teksts%C3%B8k">tekstsøk</a>, <ahref="#Forslag">forslag</a> og <ahref="#Metadata">ordbok-metadata</a></p><p>Alle API-kall er på formen:<br>
<li><code>bob,no</code> for begge språk (bare for søk/forslag)</li>
</ul>
</li>
<li><code>article_id</code>: numerisk id for en ordboksartikkel</li>
<li><code>query</code>: Søkeuttrykk</li>
</ul><h2id="Direkte-oppslag"><aclass="anchor hidden-xs"href="#Direkte-oppslag"title="Direkte-oppslag"><iclass="fa fa-link"></i></a>Direkte oppslag</h2><p>Dersom man kjenner den numeriske IDen til en artikkel kan man slå den opp vha. dette endepunktet.</p><h3id="Eksempel-på-direkte-oppslag"><aclass="anchor hidden-xs"href="#Eksempel-på-direkte-oppslag"title="Eksempel-på-direkte-oppslag"><iclass="fa fa-link"></i></a>Eksempel på direkte oppslag</h3><p>Spesifikasjonen til denne operasjonen finner du <ahref="https://beta.ordbok.uib.no/api/swagger-ui.html#/default/get_dict__dict_id__article__art_id_"target="_blank"rel="noopener">her</a></p><pre><codeclass="http hljs"><spanclass="hljs-keyword">GET</span><spanclass="hljs-string">/api/dict/bob/article/69947</span> HTTP/1.1
<li><code>lemmas</code>: Ett eller flere oppslagsord som artikkelen beskriver. Elementene i denne listen er på et format som er beskrevet <ahref="https://ordbank.uib.no/api/guide.html"target="_blank"rel="noopener">her</a></li>
<li><code>article_id</code>: Artikkelens ID, som i forespørselen</li>
<li><code>body</code>: Selve innholdet i artikkelen, formatet er beskrevet <ahref="#Artikkelkroppen">her</a></li>
</ul><h2id="Tekstsøk"><aclass="anchor hidden-xs"href="#Tekstsøk"title="Tekstsøk"><iclass="fa fa-link"></i></a>Tekstsøk</h2><p>Denne formen for søk leter etter søketeksten i alle bøyningsformer i oppslagsord, samt i artikkelelementer av typen <code>usage</code> som beskrives senere.</p><h3id="Eksempel-på-søk"><aclass="anchor hidden-xs"href="#Eksempel-på-søk"title="Eksempel-på-søk"><iclass="fa fa-link"></i></a>Eksempel på søk</h3><pre><codeclass="http hljs"><spanclass="hljs-keyword">GET</span><spanclass="hljs-string">/api/dict/bob/search?q=katt</span> HTTP/1.1
</span></code></pre><p>Resultatet er en liste av objekter (som det man får ved direkte oppslag), men med to ekstra elementer:</p><ul>
<li><code>score</code>: Et mål på hvor god match denne artikkelen er ift. søket, treffene er sortert synkende etter dette måltallet</li>
<li><code>dict_id</code>: ID på ordboken artikkelen kommer fra (for tospråklig søk)</li>
</ul><h2id="Forslag"><aclass="anchor hidden-xs"href="#Forslag"title="Forslag"><iclass="fa fa-link"></i></a>Forslag</h2><p>Fungerer som <ahref="#Teksts%C3%B8k">tekstsøk</a>, men returnerer bare artikler for ord som begynner med søkeuttrykket. Her er heller ingen <code>score</code> inkludert. Kan brukes til <em>autocomplete.</em></p><h3id="Eksempel-på-spørring"><aclass="anchor hidden-xs"href="#Eksempel-på-spørring"title="Eksempel-på-spørring"><iclass="fa fa-link"></i></a>Eksempel på spørring</h3><pre><codeclass="http hljs"><spanclass="hljs-keyword">GET</span><spanclass="hljs-string">/api/dict/bob/suggest?q=katt</span> HTTP/1.1
<aid="tocLabel"class="ui-toc-label btn btn-default"data-toggle="dropdown"href="#"role="button"aria-haspopup="true"aria-expanded="false"title="Table of content">
</div><divclass="toc-menu"><aclass="expand-toggle"href="#">Expand all</a><aclass="back-to-top"href="#">Back to top</a><aclass="go-to-bottom"href="#">Go to bottom</a></div>
</div><divclass="toc-menu"><aclass="expand-toggle"href="#">Expand all</a><aclass="back-to-top"href="#">Back to top</a><aclass="go-to-bottom"href="#">Go to bottom</a></div>