Parakstīšanas API

Aprēķināt īssavilkumu (digest)

Darbības joma
Aprēķināt parakstāmos datus no parakstāmā faila, izmantojot saņemto galalietotāja paraksta sertifikātu.

Apraksts

  1. Sāciet parakstīšanas sesiju. Ja rodas problēmas ar failiem vai pieprasījums neatbilst dokumenta parakstīšanas formāta prasībām, process tiek pārtraukts un tiek atgriezta kļūda;

  2. Tiek aprēķinātas katra parakstāmā faila jaucējvērtības (hash), kā arī parakstāmie dati;

  3. Paraksta algoritms tiek noteikts balstoties uz sertifikātu;

  4. Sagatavotie parakstāmie dati base64 formātā tiek atgriezti pieprasītājam parakstīšanai.

Pieprasījums
Pakalpojuma sniedzēja lietojumprogramma, izmantojot TLS, nosūta šādu GET pieprasījumu:

POST /api-sign/v1.0/CalculateDigest

Autorizācija
Pieprasījumā jāiekļauj Authorization galvene ar OAuth Introspekta piekļuves marķieri (Introspect access token), kas iegūts no e-Identitātes platformas, izmantojot pakalpojumu sniedzēja akreditācijas datu piešķiršanas plūsmu (credentials grant flow).

Pamatteksts (body)

{
"sessions":[
    {
      "sessionId": "string"
    }
  ],
  "certificate": "string",
  "signAsPdf": true,
  "createNewEdoc": true
}
ParametrsApraksts
sessionsInformācija par failu apstrādes sesijām
sessions.sessionIdFailu apstrādes sesijas identifikators. Ir iespējams norādīt vairākas sesijas.
certificateParakstīšanas sertifikāts base64 formātā
signAsPdf

True- tiks parakstīts kā PDF (var izmantot tikai PDF parakstīšanai un tikai viens PDF fails vienā sesijā).

False - izveidos XAdES parakstu ASiC-E konteinerā (EDOC).

createNewEdoc

True - Vienmēr izveido jaunu ASiC-E konteineru (pat ja parakstāmais fails jau ir ASiC-E konteiners - ASiC-E konteinerā ASiC-E);

False - Ja esošais fails ir ASiC-E konteinerā, jauns paraksts tiks pievienots esošajā ASiC-E konteinerā. Ja fails nav ASiC-E, tas tiks pievienots ASiC-E konteinerā.

Vienas sesijas parakstīšanas piemērs

POST /api-sign/v1.0/CalculateDigest HTTP/1.1
Authorization: Bearer a477b3a3366768c07e4c458f518711b4b351e8d2c2f0f78a1524e4d3efd00603
Host: signapi-prep.eparaksts.lv
{
  "sessions": [
     {
        "sessionId": "fefdaec2b14bf2977d32a861fb49545244c654f7a4736dcc081ae1857a3a3dd4"
     }
  ],
  "certificate": "MIIG/j.......<sign certificate base64 here>.......xFP/IP==",
  "signAsPdf": false,
  "createNewEdoc": false
}

Partijas sesijas parakstīšanas piemērs

POST /api-signing/v1.0/CalculateDigest HTTP/1.1
Authorization: Bearer a477b3a3366768c07e4c458f518711b4b351e8d2c2f0f78a1524e4d3efd00603
Host: signapi-prep.eparaksts.lv
{
  "sessions": [
          {
                 "sessionId": "fefdaec2b14bf2977d32a861fb49545244c654f7a4736dcc081ae1857a3a3dd4"
          },
          {
                 "sessionId": "fefdaec2b14bf2977d32a861fb49545244c654f7a4736dcc081ae18512121212"
          },
          {
                 "sessionId": "fefdaec2b14bf2977d32a861fb49545244c654f7a4736dcc081ae185bbbbbbbb"
          }
  ],
  "certificate": "MIIG/j.......<sign certificate base64 here>.......xFP/IP==",
  "signAsPdf": false,
  "createNewEdoc": false
}

Atbilde
JSON objekts:

{
"sessionDigests":[
    {
      "sessionId": "string",
      "digest": "string",
      "error": {
          "code": "string",
          "message": "string"
      }
    }
  ],
  "digests_summary": "string",
  "algorithm": "string"
}
ParametrsApraksts
sessionDigestInformācija par parakstāmo datu sesiju
sessionDigest.sessionIdFailu apstrādes sesijas identifikators
sessionDigest.diggest

Parakstāmi dati base64 formātā

Servera parakstīšanas gadījumā - saņemtā digest rekvizīta vērtība tiek izmantota (tāda, kāda tā ir, bez jebkādas pārformatēšanas) elektroniskā paraksta nodrošinātāja API, izveidojot ciparparakstu serverī kā rekvizīta digest_value vērtību.

Parakstot ar viedkarti, izmantojot LVRTC nodrošināto pārlūkprogrammas paplašinājuma integrāciju, šī vērtība tiek konvertēta uz HEX.

sessionDigests.errorSesijas kļūda, ja tāda ir
sessionDigests.error.codeSesijas kļūdas kods
sessionDigests.error.messageSesijas kļūdas ziņojums
digests_summary

⚠️ Šo parametru drīkst izmantot tikai, lai saņemtu galalietotāja autorizāciju digitālā paraksta izveidei, izmantojot servera parakstīšanas identitāti, kas ir aktivizēta ar HSM glabātu paroli. ⚠️

Tas jau ir iepriekš aprēķināts īssavilkums. Servera parakstīšanas gadījumā, iegūstot autorizācijas kodu parakstīšanas darbībai kā rekvizīta digests_summary, OAuth2.0 autorizācijas API jāizmanto parametra digests_summary vērtība (tādā stāvoklī, kādā tā ir, bez jebkādas pārformatēšanas).

algorithmDigitālā paraksta algoritms
signature_algorithmLietotāju parakstīšanas sertifikāta publiskās atslēgas algoritms izmantošanai identitātes platformas metodēs /trustedx-resources/esigp/v1/signatures/server/raw/batch un /trustedx-resources/esigp/v1/signatures/server/raw ar iespējamām vērtībām rsa un ecdsa Ja rsa pievieno -sha256 (piemērs rsa-sha256), ecdsa gadījumā izmantojiet vērtību tādu, kāda tā ir (piemērs ecdsa).

Vienas sesijas parakstīšanas piemērs

{
   "data": {
       "sessionDigests": [
           {
               "sessionId": "a37e460b4c65cb01a01dce5c58149806ca2d20dab22e99905d45128c4e693a90",
               "digest": "4xZX5G+R4gTbK2r6RlismZw4EBftvbSDcE3lXfpLMM4="
           }
       ],
       "digests_summary": "mnF3XVRWujh/Tsc3oA2HVGl0SI8VNb3pmscMcDhEzDo=",
       "algorithm": "SHA256"
   }
}

Partijas sesijas parakstīšanas piemērs

{
  "data": {
          "sessionDigests": [
                 {
                    "sessionId": "fefdaec2b14bf2977d32a861fb49545244c654f7a4736dcc081ae1857a3a3dd4",
                    "digest": "wRX+DNmDdlDrMK8X/MEdersGZbsgTiSFHi26domxjwA="
                 },
                 {
                    "sessionId": "fefdaec2b14bf2977d32a861fb49545244c654f7a4736dcc081ae18512121212",
                    "digest": "wRX+DNmDdlDrMK8X/MEdersGZbsgTiSFHi26domxjwA="
                 },
                 {
                    "sessionId": "fefdaec2b14bf2977d32a861fb49545244c654f7a4736dcc081ae185bbbbbbbb",
                    "digest": "wRX+DNmDdlDrMK8X/MEdersGZbsgTiSFHi26domxjwA="
                 }
           ],
                  "digests_summary": "mnF3XVRWujh/Tsc3oA2HVGl0SI8VNb3pmscMcDhEzDo=",
         "algorithm": "SHA256"
  }
}

Pabeigt parakstīšanu

Darbības joma
Nodrošiniet paraksta vai zīmoga (un konteinera ASiC-E gadījumā) pabeigšanu.

Apraksts

  1. Pievieno dokumentam parakstītus datus;

  2. Sāk LVRTC laika zīmoga pieprasījumu;

  3. Parakstam pievieno laika zīmogu un atsaukšanas datus (piemēram, OCSP);

  4. Veiksmīgas izpildes gadījumā tiek atgriezts ziņojums "OK".

Pieprasījums
Pakalpojuma sniedzēja lietojumprogramma, izmantojot TLS, nosūta šādu GET pieprasījumu:

POST /api-sign/v1.0/finalizeSigning

Autorizācija
Pieprasījumā jāiekļauj Authorization galvene ar OAuth Introspekta piekļuves marķieri (Introspect access token), kas iegūts no e-Identitātes platformas, izmantojot pakalpojumu sniedzēja akreditācijas datu piešķiršanas plūsmu (credentials grant flow).

Pamatteksts (body)

{
"sessionSignatureValues": [
    {
      "sessionId": "string",
      "signatureValue": "string"
    }
  ],
  "authCertificate": "string"
}
ParametrsApraksts
sessionSignatureValuesSatur detalizētu informāciju par parakstītajiem datiem
sessionSignatureValues.sessionIdFailu apstrādes sesijas identifikators. Ir iespējams norādīt vairākas sesijas.
sessionSignatureValues.signatureValueParakstīti dati base64 formātā. Ja ir norādītas vairākas sesijas, tad katra norādītā sesija satur savus parakstītus datus.
authCertificateGalalietotāja autentifikācijas sertifikāts

Piemēri:

Viena paraksta piemērs

POST /api-sign/v1.0/finalizeSigning HTTP/1.1
Authorization: Bearer a477b3a3366768c07e4c458f518711b4b351e8d2c2f0f78a1524e4d3efd00603
Host: signapi-prep.eparaksts.lv
{
  "sessionSignatureValues": [
     {
        "sessionId": "76fa04d8e5e2451b867af6ae667558395459fb9d082d31dadb9f22222f80a3d2",
        "signatureValue": "goU+aIw0sZHRwepWiooOdSb0eDbCZcBymXSgsLmYxCr6I6aZdDiG07vp4bbJMtGGPbTKEh6ZR+7eCmNfC02g/hhlGU4OCr+LFhKFIcYqUW1VGvnEPx4eIJlw43pSIo6k/It16RYyYWG1e2DVy1HuMoZEBScUAAN4tHFiHCiIsPuuzIYnRJtZMVi795dvgkEGxnghvzxp0rF+2eoT/5gMKEcBxRIKKs2gWyFK+UIpiXigk0K8LTSEw4XXKDCMSVJ8Vp08nRm1grE0tjLY6tvUVs61Bh5ylC4d7Nh4gQB5VBJHBcng8lFAfXIokX0hD9eoHBrx/bZ7uN1Co5U8H/HFvw=="
     }
  ],
  "authCertificate": "MIIGT....<auth cert base64 here>.......UoKew=="
}

Partijas parakstīšanas piemērs

POST /api-sign/v1.0/finalizeSigning HTTP/1.1
Authorization: Bearer a477b3a3366768c07e4c458f518711b4b351e8d2c2f0f78a1524e4d3efd00603
Host: signapi-prep.eparaksts.lv
{
  "sessionSignatureValues": [
    {
        "sessionId": "4bf47a3df5020ed537cc6337429db6dcbf7c299ab03474099a0b592190362d06",
        "signatureValue": "BJjtf/DjqBOTyFjjFci+HyzSnzhKE/diYpM9uf3HGLeX4VN+KYzwwgTiTnHn67zDMj5Qouu3ldBeIvswmD/wDuwk+XyMaII7iVEg9CpvABhjDINXhtu5Wn/X5DLXQovN6Fd2xDBV1a392XfeBDtWNmWUr5P6ZZ7wfaCGuae1YyFUbfep6nL/CC6iwKUmVMYyvHzr1ZHSpg/NAVvXC73Q3Bv3/XBYgPusuJZ5Sfv1Xv6PkyOMB9iC5307xk2V3+ptnDnKus+qYQioNhdKSmR4r92tQkZbtK/kgPmkwpGO/B0wmI18ldzVS8gv7Fhorxp0sbDzjRpj0DI+UH6yEZn7ew=="
     },
     {
        "sessionId": "967e69ed16f7056dfe430f6292fd0f1dd9c28d87379bb7bcef94021ecc096642",
        "signatureValue": "ldH/38RET4fR4nLH5s6/5uzkVbG4GPbsAsL0Wi9fAWWovXaR0ukzdhDnGVNuCQWfulOpEGKyTHvdfqbAKxrGlJ1QKcWvEluqk6bnYqUA/vPOabPpXqWAvhpqf6R507aGCtbsUJ2OoNLyIl3BCP1fqV0uD12bz4x8Geqm2pjB+mj1rbp8kN4og5z4MrPd34Wi0n5JD+pFqd4/UN5ttXB4Px5oZJGw99KvXU8sEDbyxn6qlojn7Z8OAQiwW6+x09degASXKGFHNbLBETbw8K/pUy1eaJDGQDn/+pba7ygCMB4YnK2cl7c7hgvkzQjyYg3PQ5kpwCPiUj4Tt5Zd9u5o5A=="
     },
     {
        "sessionId": "3d87b13595af5094309028b7482df121988f97f4c04873ffd736a4186dd04069",
        "signatureValue": "fR3E287+05Gb8bPjqoiy0SGMtbKLGkopMb+AUgpS872bJ6qctEmpmZ5ZcsQ5j6HjmsZG34qg7Cvj/AuviOEK8XPDrlFtGeHeq5Lb5Kjv7FJbDqoAP+DrRLmtt49/g9tSEbplZAiLiRCQg6uHpMr3gP7Jv6YWsQINArkAB7Gkpy/0eA5egaabxmP78iz8Y74XGl2eBbkUmJCXyOPUTsPmkJZuzVMVIG5GFBoDz32AVUC0S2J5jOW8WUu/JPIeD/UqAE7Rs4c0jKz6PnjbZLFKRE/qk2j2PCjzgd6kKNkNgPCA1mXXTPAd95Rq0FK25ZeHfZW93AaHDV1OFq85J6kMdA=="
     }
  ],
  "authCertificate": "MIIGT......<auth cert base64 here>........UoKew=="
}

Atbilde
JSON objekts:

{
    "data": {
        "results": [
            {
                "sessionId": "string"
            }
        ]
    }
}
ParametrsTipsApraksts
sessionIdVirkne (64)
(String (64))
Failu apstrādes sesijas identifikators.

Viena paraksta piemērs

{
    "data": {
        "results": [
            {
                "sessionId": "2ddec3e17a456417f48b044d71d2db2a31d00b62baea3de1211617e856f0f19d"
            }
        ]
    }
}

Partijas parakstīšanas piemērs

{
    "data": {
        "results": [
            {
                "sessionId": "4bf47a3df5020ed537cc6337429db6dcbf7c299ab03474099a0b592190362d06"
            },
            {
                "sessionId": "967e69ed16f7056dfe430f6292fd0f1dd9c28d87379bb7bcef94021ecc096642"
            },
            {
                "sessionId": "3d87b13595af5094309028b7482df121988f97f4c04873ffd736a4186dd04069"
            }
        ]
    }
}

Arhīva laika zīmoga pieprasījums

Darbības joma
Norādiet arhīva laika zīmogu jau parakstītam dokumentam.

Apraksts

  1. Pieprasa laika zīmogu, izmantojot klienta autentifikācijas sertifikātu;
  2. Saņemtajam arhīva laika zīmogam tiek pievienots paraksts ar tipu "ARCHIVE_TIMESTAMP";
  3. Veiksmīgas izpildes gadījumā tiek atgriezts sesijas unikālais identifikators.

Pieprasījums
Pakalpojuma sniedzēja lietojumprogramma, izmantojot TLS, nosūta šādu POST pieprasījumu:

POST /api-sign/v1.0/addArchive

Autorizācija
Pieprasījumā jāiekļauj Authorization galvene ar OAuth Introspekta piekļuves marķieri (Introspect access token), kas iegūts no e-Identitātes platformas, izmantojot pakalpojumu sniedzēja akreditācijas datu piešķiršanas plūsmu (credentials grant flow).

Pamatteksts (body)

{
  "sessions": [
    {
      "sessionId": "{String}"
    }
  ],
  "authCertificate": "{String}"
}
ParametrsApraksts
sessionIdFailu apstrādes sesijas identifikators
authCertificateGalalietotāja autentifikācijas sertifikāts

Piemērs

POST /api-sign/v1.0/addArchive HTTP/1.1
Authorization: Bearer a477b3a3366768c07e4c458f518711b4b351e8d2c2f0f78a1524e4d3efd00603
Host: signapi-prep.eparaksts.lv
{
  "sessions": [
    {
      "sessionId": "26ae33853f7df73eaa84346a04a188db1614305aee43de0da667c67a4d371490"
    }
  ],
  "authCertificate": "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"
}

Atbilde
JSON objekts:

{
    "data": {
        "results": [
            {
                "sessionId": {String}
            }
        ]
    }
}
ParametrsApraksts
sessionIdFailu apstrādes sesijas identifikators

Piemērs

{
    "data": {
        "results": [
            {
                "sessionId": "26ae33853f7df73eaa84346a04a188db1614305aee43de0da667c67a4d371490"
            }
        ]
    }
}

eZīmoga pievienošana

Darbības joma
Uzliek failam organizācijas elektronisko zīmogu.

Apraksts
Izveido elektroniskā zīmoga parakstu, izmantojot organizācijas elektroniskā zīmoga sertifikātu, laika zīmogu, izmantojot autentifikācijas sertifikātu, un atsaukšanas datus (piemēram, OCSP).

Pieprasījums
Pakalpojuma sniedzēja lietojumprogramma, izmantojot TLS, nosūta šādu POST pieprasījumu:

POST /api-sign/v1.0/eSealCreate

Autorizācija
Pieprasījumā jāiekļauj Authorization galvene ar OAuth Introspekta piekļuves marķieri (Introspect access token), kas iegūts no e-Identitātes platformas, izmantojot pakalpojumu sniedzēja akreditācijas datu piešķiršanas plūsmu (credentials grant flow).

Pamatteksts (body)

{
  "sessions": [
    {
      "sessionId": "string"
    }
  ],
  "signAsPdf": false,
  "createNewEdoc": false,
  "signKey": "string",
  "signKeyPassword": "string",
  "authCertificate": "string"
}
ParamtersApraksts
sessionId

Failu apstrādes sesijas identifikators

Vairākas sesijas var noslēgt vienlaikus

signAsPdf

True - tiks parakstīts kā PDF

False - pārbaudīs XAdES parakstu ASiC-E konteinerā (EDOC).

createNewEdoc

True - Vienmēr izveido jaunu ASiC-E konteineru (pat ja parakstāmais fails jau ir ASiC-E konteiners - ASiC-E konteinerā ASiC-E);

False - Ja esošais fails ir ASiC-E konteiners, esošajam ASiC-E konteineram tiks pievienots jauns paraksts.

signKeyeSeal sertifikāta atslēga PFX faila formātā, kas kodēts base64.
signKeyPassword

eZīmoga sertifikāta atslēga parole šifrēta ar API eZīmoga paroles šifrēšanas sertifikāts (izsniedz LVRTC) publiskā atslēga kodēta base64

⚠️ RSA šifrēšana ar SHA-1 papildinājumu (padding)Jaunā produkcijas API (signapi.eparaksts.lv) eSeal paroles šifrēšanas sertifikāta publiskā atslēga ir pieejama zemāk. ( DERĪGS NO 19.12.2025. 00:00 GMT+2 )

⚠️ Pašreizējo publisko atslēgu var iegūt arī, izmantojot Konfigurācijas API metodi GET /api-config/v1.0/public/key

authCertificateAutentifikācijas sertifikāts, kas saistīts ar eZīmogu laika zīmoga pieprasījumam PEM formātā
🚧

Atslēga jāiesniedz pfx formātā

📘

Jaunā produkcijas API (signapi.eparaksts.lv) eSeal paroles šifrēšanas sertifikāta publiskā atslēga ir pieejama zemāk. ( DERĪGS NO 19.12.2025. 00:00 GMT+2 )

-----BEGIN PUBLIC KEY-----
MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAtHNLC+ipZ9/GA19g/xPI
txZGWISp7yN49hmtlvYIjACiOLvp1jsgCUhRZItoReGwy29s5xRZizGkS5R3XS6g
myKIONGrfgXNIVEYPyukLL1T35hCHnFqhFb9ofVpsYcbXo+9pgukxqk0Cs7hGisa
7/f/gwkrnYweM3d2hVj1a7Hlj+2iEFsoqekI25XtOFwXIBj7kviHwVOa22FNrVjA
9GJQnGaSlWLBu6BBVI1BcNp60+HZqQ0XsUEHLk8d2mbs2Em9GG1HbU4aPGkJcGjs
0unlyiFvNY+61132NkyCctiUh11RU6cXhv1jGoq9439Q005ve05n21ocfREHtSYw
nwIDAQAB
-----END PUBLIC KEY-----

Šifrēšana

byte[] signKeyPasswordBytes = Encoding.UTF8.GetBytes(req.SignKeyPassword);
byte[] signKeyPasswordBytesEncrypted = publicKey.Encrypt(signKeyPasswordBytes, RSAEncryptionPadding.Pkcs1);
req.SignKeyPassword = Convert.ToBase64String(signKeyPasswordBytesEncrypted);

Piemērs

POST /api-sign/v1.0/eSealCreate  HTTP/1.1
Authorization: Bearer a477b3a3366768c07e4c458f518711b4b351e8d2c2f0f78a1524e4d3efd00603
Host: signapi-prep.eparaksts.lv
{
  "sessions": [
     {
        "sessionId": "702e9106e3fe2987d04a0bf7d585050477c1c0dce4d5b76fafc1178b537bc891"
     }
  ],
  "signAsPdf": false,
  "createNewEdoc": false,
  "signKey": "gbfb43564/70OeyYmqoLJ+YAU1kl+vwGVHT0L+ywky80EO8qx/kMZ7hq1Rm9p/SjzexaS0lIH4yf0OJ74BdZCRGaeBfjZWHiQxBdQSXyeuCqDgawbcOjNMjQeLUK5s4a6T17WXjsPTqPulu8mdyhV+tPhwUE/UdtOcSrJeY+ZkGMsn1i+YcNk1cg12+A/zQZ8lWach7M7Fj7gYhNaHiNW5JUREJKGgVKU4rSEE1T2LosJ9H/b+I3Fj0AVR3Cw57W+VSxn8bXqQG8kq+MWdeomaprRvFQoSwY+MFUedqXgVNOioO8lARJNcd2duMLiy4PKEheqq6rZFftSlYulv+o9nPsbZXMO7H",
  "signKeyPassword": "6hCV2AEjVdTWDw5EEurDANBgkqhkiG9w0BAQsFADCBgzELMAkGA1UEBhM",
   "authCertificate": "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"}

Atbilde
JSON objekts:

{
    "results": "string"[
        {
            "sessionId": "string",
            "error": {
                "code": "string",
                "message": "string"
            }
        }
    ]
}
ParametrsApraksyts
resultsParakstīšanas rezultāti: veiksmīgi, ja error == null vai izlaists
results.sessionIdFailu apstrādes sesijas identifikators
results.errorSesijas kļūda, ja tāda ir
results.error.codeSesijas kļūdas kods
results.error.messageSesijas kļūdas ziņojums

Piemērs

{
  "data": {
     "results": [
        {
           "sessionId": "76fa04d8e5e2451b867af6ae667558395459fb9d082d31dadb9f22222f80a3d2"
        }
     ]
  }
}

⚠️ Svarīga informācija par eID Scan Parakstīšanas platformā

Izmantojot eID Scan Parakstīšanas platformā, lūdzu, ņemiet vērā šādas galvenās atšķirības salīdzinājumā ar citām parakstīšanas metodēm:

  1. Grupveida parakstīšana netiek atbalstīta. Parakstīšana ir iespējama tikai:
  • Vienam dokumentam;

  • Vienai dokumentu pakotnei.

  1. Klienta puses verifikācijas koda prasība

    Lietotājam parādītais verifikācijas kods tiek aprēķināts, pamatojoties uz faktisko digest_value :

    vesels skaitlis (SHA256(jaucējs) [-2:-1]) mod 10000

Aprēķiniet SHA256 no faktiskā digest_value , izvelciet no rezultāta 2 galējos labos baitus, interpretējiet tos kā lielu neparakstītu veselu skaitli un ņemiet pēdējos 4 ciparus decimāldaļās attēlošanai.
Šeit vienmēr tiek izmantots SHA256, neatkarīgi no tā, kāds algoritms tika izmantots, lai aprēķinātu sākotnējo jaucējvērtību (hash).