# Frasekatalog

Tinglysningsretten
1.0.0

← Tilbage til Hovedside

## Oversigt

Denne web service udstilles af e-TL, og omfatter operationer, som har med fraser at gøre. Fraser giver mulighed for, at aktører kan oprette egne tekster, der kan anvendes i brugerformularer. Teksterne kan da genbruges på tværs af de brugerformularer aktøren opretter. Når man indsender en frase tildeles frasen en FraseIdentifikator, som senere anvendes som reference i de felter i brugerformularen, hvor der er behov for fraseteksten. Professionelle brugere kan her hente en FraseIdentifikator for en frase, fx forud for oprettelse af en brugerformular. FraseIdentifikatoren er en UUID, som alle efterfølgende kan bruge til at hente frasen med, for så vidt de kender UUID’en. FraseIdentifikatoren vil altid henvise til den oprindelige tekst. Selv de mindste ændringer kræver en ny UUID. Der er ikke umiddelbart anden søgemulighed end UUID’en og den komplette tekst. Det betyder at ingen kan fremsøge og dermed lure i andres tekster før de er offentlige, fx via anvendelse i en offentliggjort anmeldelse. Fraser kan kun indeholde tekst evt. opdelt i en overskrift og et eller flere afsnit (se efterfølgende XML-eksempel). Der ligger ingen form for godkendelse fra Tinglysningsrettens side i de lagrede fraser. Fraser vurderes kun i forbindelse med prøvelsen eller i forbindelse med godkendelse af en brugerformlar. Frasetekster må maksimalt være på 15.000 tegn, eksl XML-tags.

### Endpoints

#### FraseHent

Endpoint URL: `Frasekatalog/FraseHent`

Beskrivelse | Mulighed for at få FraseIdentifikator(er) for en FraseTekst (FraseTekst’er). e-TL returnerer altid samme FraseIdentifikator for samme FraseTekst (og samme FraseTekst for samme FraseIdentifikator). Det vil sige, findes den eksakt samme frasetekst i frasekataloget returneres dens uuid, ellers oprettes den nye tekst i kataloget. e-TL’s signatur på svarets FraseIdentifikator og FraseTekst er garant for, at anvendelse af FraseIdentifikator fremover svarer præcist til FraseTekst.
Input | FraseHent.xsd
Output | FraseHentSvar.xsd
Fejlhåndtering | Ingen konkrete behov i denne service operation
Sikkerhed | Simpel web service (dvs. baserer sig på HTTP)
Interaktionsmønster | Forespørgsel-svar
Kaldeeffekt | Sporbar

#### FraseIdentifikatorHent

Endpoint URL: `Frasekatalog/FraseIdentifikatorHent`

Beskrivelse | Mulighed for at få en Frase for en eller flere FraseIdentifikatorer. e-TL returnerer altid samme FraseTekst for samme FraseIdentifikator (og samme FraseIdentifikator for samme FraseTekst). e-TL’s signatur på svarets FraseIdentifikator og FraseTekst er garant for, at anvendelse af FraseIdentifikator svarer præcist til FraseTekst.
Input | FraseIdentifikatorHent.xsd
Output | FraseHentSvar.xsd
Fejlhåndtering | Ingen konkrete behov i denne service operation
Sikkerhed | Simpel web service (dvs. baserer sig på HTTP)
Interaktionsmønster | Forespørgsel-svar
Kaldeeffekt | Sporbar

Eksempel på forespørgsel:

    GET /s2s/Frasekatalog/FraseIdentifikatorHent HTTP/1.1
    Content-Type: application/xml
    Tinglysning-Message-ID: uuid:7e3e8ad7-dc16-429d-8f53-6ee9ef67c8ed
    Tinglysning-Relates-To: s2s-http-xml-api-end2end-test
    Content-Length: 592

    <?xml version="1.0" encoding="UTF-8"?><FraseIdentifikatorHent xmlns="http://rep.oio.dk/tinglysning.dk/service/message/administration/1/" xmlns:ns="http://rep.oio.dk/tinglysning.dk/schema/model/1/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://rep.oio.dk/tinglysning.dk/service/message/administration/1/ http://rep.oio.dk/tinglysning.dk/service/message/administration/1/FraseIdentifikatorHent.xsd">
      <ns:FraseTekstSamling>
        <ns:FraseTekst>
          <ns:Afsnit>AFSNIT</ns:Afsnit>
        </ns:FraseTekst>
      </ns:FraseTekstSamling>
    </FraseIdentifikatorHent>

Eksempel på svar:

    HTTP/1.1 200 OK

    <ns:FraseHentSvar xmlns:ns="http://rep.oio.dk/tinglysning.dk/service/message/administration/1/" xmlns:ds="http://www.w3.org/2000/09/xmldsig#" xmlns:dsigModel="http://rep.oio.dk/tinglysning.dk/schema/model/1/" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="http://rep.oio.dk/tinglysning.dk/service/message/administration/1/ http://rep.oio.dk/tinglysning.dk/service/message/administration/1/FraseHentSvar.xsd"><ns1:FraseSamling xmlns:ns1="http://rep.oio.dk/tinglysning.dk/schema/model/1/"><ns1:Frase><ns1:FraseIdentifikator>072f25e3-317a-4191-b7b7-2f0ad5295b98</ns1:FraseIdentifikator><ns1:FraseTekst><ns1:Afsnit>AFSNIT</ns1:Afsnit></ns1:FraseTekst></ns1:Frase></ns1:FraseSamling><Signature xmlns="http://www.w3.org/2000/09/xmldsig#" Id="ID26320421215001-ReplySignature"><SignedInfo Id="ID26320421215002-ReplySignatureInfo"><CanonicalizationMethod Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/><SignatureMethod Algorithm="http://www.w3.org/2000/09/xmldsig#rsa-sha1"/><Reference URI=""><Transforms><Transform Algorithm="http://www.w3.org/2000/09/xmldsig#enveloped-signature"/><Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/></Transforms><DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/><DigestValue>AfGvrwpA0Q7CC9Ijo1MquT/umsA=</DigestValue></Reference><Reference Type="http://www.w3.org/2000/09/xmldsig#SignatureProperties" URI="#ID26320421215004-ReplySignatureProperty"><Transforms><Transform Algorithm="http://www.w3.org/2001/10/xml-exc-c14n#"/></Transforms><DigestMethod Algorithm="http://www.w3.org/2000/09/xmldsig#sha1"/><DigestValue>CRgRPRb9/bIXlqbh/avFNkYhcfU=</DigestValue></Reference></SignedInfo><SignatureValue> </SignatureValue><KeyInfo><X509Data><X509Certificate> </X509Certificate></X509Data></KeyInfo><Object Id="ID26320421215003-ReplySignatureObject"><SignatureProperties><SignatureProperty Id="ID26320421215004-ReplySignatureProperty" Target="#ID26320421215001-ReplySignature"><dsigModel:UnderskriftTidspunkt>2025-10-31T15:31:40</dsigModel:UnderskriftTidspunkt></SignatureProperty></SignatureProperties></Object></Signature></ns:FraseHentSvar>

#### FraseOpret

Endpoint URL: `Frasekatalog/FraseOpret`

Beskrivelse | Mulighed for at oprette Fraser. e-TL returnerer FraseIdentifikator(er) for de oprettede frasetekster. e-TL’s signatur på svarets FraseIdentifikator og FraseTekst er garant for, at anvendelse af FraseIdentifikator svarer præcist til FraseTekst.
Input | FraseOpret.xsd
Output | FraseHentSvar.xsd
Fejlhåndtering | Ingen konkrete behov i denne service operation
Sikkerhed | Simpel web service (dvs. baserer sig på HTTP)
Interaktionsmønster | Forespørgsel-svar
Kaldeeffekt | Sporbar