# Frasekatalog

Tinglysningsretten
1.0.0

← Back to Main Page

## Overview

This web service is provided by e-TL and includes operations related to phrases. Phrases allow actors to create their own texts, which can be used in user forms. These texts can then be reused across the user forms created by the actor. When a phrase is submitted, it is assigned a Phrase Identifier, which is later used as a reference in the fields of the user form where the phrase text is needed. Professional users can retrieve a Phrase Identifier for a phrase here, for example, prior to creating a user form. The Phrase Identifier is a UUID, which anyone can subsequently use to retrieve the phrase, provided they know the UUID. The Phrase Identifier will always refer to the original text. Even the smallest change requires a new UUID. There are no search options other than the UUID and the complete text. This means that no one can search for and thus view others' texts before they become public, for example, through use in a published notification. Phrases may only contain text, which can optionally be divided into a heading and one or more sections (see the following XML example). There is no form of approval from the Registration Court for the stored phrases. Phrases are only evaluated in connection with the review or approval of a user form. Phrase texts may be a maximum of 15,000 characters, excluding XML tags.

### Endpoints

#### FraseHent

Endpoint URL: `Frasekatalog/FraseHent`

Description | Ability to retrieve Phrase Identifier(s) for a Phrase Text (or Phrase Texts). e-TL always returns the same Phrase Identifier for the same Phrase Text (and the same Phrase Text for the same Phrase Identifier). This means that if the exact same phrase text exists in the phrase catalog, its UUID is returned; otherwise, the new text is created in the catalog. The e-TL signature on the response’s Phrase Identifier and Phrase Text guarantees that the use of the Phrase Identifier will always correspond precisely to the Phrase Text.
Input | FraseHent.xsd
Output | FraseHentSvar.xsd
Error Handling | No specific requirements in this service operation
Security | Simple web service (i.e., based on HTTP)
Interaction Pattern | Request-response
Invocation Effect | Traceable

#### FraseIdentifikatorHent

Endpoint URL: `Frasekatalog/FraseIdentifikatorHent`

Description | Ability to retrieve a Phrase for one or more Phrase Identifiers. e-TL always returns the same Phrase Text for the same Phrase Identifier (and the same Phrase Identifier for the same Phrase Text). The e-TL signature on the response’s Phrase Identifier and Phrase Text guarantees that the use of the Phrase Identifier always corresponds precisely to the Phrase Text.
Input | FraseIdentifikatorHent.xsd
Output | FraseHentSvar.xsd
Error Handling | No specific requirements in this service operation
Security | Simple web service (i.e., based on HTTP)
Interaction Pattern | Request-response
Invocation Effect | Traceable

Example request:

    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>

Example response:

    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`

Description | Ability to create phrases. e-TL returns Phrase Identifier(s) for the created phrase texts. The e-TL signature on the response’s Phrase Identifier and Phrase Text guarantees that the use of the Phrase Identifier always corresponds precisely to the Phrase Text.
Input | FraseOpret.xsd
Output | FraseHentSvar.xsd
Error Handling | No specific requirements in this service operation
Security | Simple web service (i.e., based on HTTP)
Interaction Pattern | Request-response
Invocation Effect | Traceable