Usługa API do weryfikacji dokumentu w RDE
- Służy do weryfikacji autentyczności dokumentu (np. dyplomu) na podstawie danych identyfikacyjnych dokumentu i podstawowych danych osobowych.
- Pozwala sprawdzić, czy wskazany dokument istnieje w systemie oraz czy wprowadzone dane osoby są zgodne z zapisanymi w rejestrze.
- Ma zastosowanie przede wszystkim dla dokumentów elektronicznych. Może być również wykorzystana w przypadku weryfikacji dokumentu wydanego w formie papierowej na wniosek, bez wykorzystania identyfikatora uuid. W takim przypadku weryfikacja jest możliwa wyłącznie dla dokumentów papierowych, które zostały wydane równolegle z ich elektronicznym odpowiednikiem i są zapisane w systemie.
- Może być wykorzystywana przez różne podmioty, w szczególności:
- uczelnie wyższe,
- instytucje publiczne,
- podmioty weryfikujące wykształcenie w procesie rekrutacji lub nadawanie uprawnień zawodowych (np. samorządy zawodowe),
- przedsiębiorców (np. w procesach rekrutacyjnych).
- Może być wykorzystana bezpośrednio przez aplikacje zewnętrzne poprzez integrację z udostępnionym API.
Nadmierna liczba zapytań do API może spowodować zastosowanie ograniczeń, w tym czasowe lub trwałe zablokowanie dostępu do usługi dla danego użytkownika.
Metoda POST do weryfikacji dokumentu
POST https://dyplomy.nauka.gov.pl/api/v1/public/verify/document
Nagłówki HTTP
Content-Type: application/json;charset=UTF-8
Accept: */* Zawartość żądania (body)
{
"documentType": "DIPLOMA",
"documentData": {
"uuid": "0b0695ab-5f4c-11f1-8ec7-d5fc3203351f",
"firstName": "Jan",
"otherNames": "",
"surname": "Kowalski",
"issuerName": "",
"issuerDocumentId": "",
"graduationDate": ""
}
} Dane wejściowe
- documentType – typ dokumentu:
- dyplom ukończenia studiów (DIPLOMA),
- suplement do dyplomu ukończenia studiów (SUPPLEMENT),
- dyplom doktorski (PHD_DIPLOMA),
- dyplom habilitacyjny (DSC_DIPLOMA).
- uuid – unikalny identyfikator dokumentu zarejestrowanego w Repozytorium dyplomów elektronicznych
- firstName – imię właściciela dokumentu (wymagane, jeśli są na dyplomie)
- surname – nazwisko właściciela dokumentu (wymagane, jeśli są na dyplomie)
- otherNames – pozostałe imiona (opcjonalne, wymagane, jeśli są na dyplomie)
- issuerName – nazwa instytucji wydającej dokument (pole opcjonalne, ma zastosowanie tylko w przypadku weryfikacji dokumentu bez identyfikatora uuid, który został wydany w wersji papierowej na wniosek. Weryfikacja dokumentu papierowego jest możliwa tylko dla dokumentu, który został wydany wraz dyplomem elektronicznym).
- issuerDocumentId – numer dyplomu (pole opcjonalne, ma zastosowanie tylko w przypadku weryfikacji dokumentu bez identyfikatora uuid, który został wydany w wersji papierowej na wniosek. Weryfikacja dokumentu papierowego jest możliwa tylko dla dokumentu, który został wydany wraz dyplomem elektronicznym).
- graduationDate – data uzyskania tytułu zawodowego/nadania stopnia naukowego (pole opcjonalne, ma zastosowanie tylko w przypadku weryfikacji dokumentu bez identyfikatora uuid, który został wydany w wersji papierowej na wniosek. Weryfikacja dokumentu papierowego jest możliwa tylko dla dokumentu, który został wydany wraz dyplomem elektronicznym).
Odpowiedź
Struktura odpowiedzi:
- verificationStatus – status weryfikacji dokumentu (np. POSITIVE, NEGATIVE)
- resultDocumentData – obiekt zawierający dane dokumentu
Pola wspólne
- classType, documentType – typ dokumentu
- dyplom ukończenia studiów (DIPLOMA),
- suplement do dyplomu ukończenia studiów (SUPPLEMENT),
- dyplom doktorski (PHD_DIPLOMA),
- dyplom habilitacyjny (DSC_DIPLOMA).
- uuid – unikalny identyfikator dokumentu
- issuerName – nazwa instytucji wydającej dokument
- name – imię właściciela
- surname – nazwisko właściciela
- otherNames – pozostałe imiona
- subjects
- graduationDate – data ukończenia studiów/nadania stopnia
Pola dla dyplomu ukończenia studiów, suplementu do dyplomu ukończenia studiów
- professionalTitle – tytuł zawodowy
- level – poziom studiów
- fieldOfStudy – kierunek studiów
Pola tylko dla suplementu do dyplomu ukończenia studiów:
- issuingDate – data wydania suplementu
Pola dla dyplomu doktorskiego i habilitacyjnego:
- degreeTitle – stopień naukowy
- domain – dziedzina nauki
- discipline – dyscyplina naukowa
Przykład pozytywnej weryfikacji dokumentu – dyplom ukończenia studiów
{
"verificationStatus": "POSITIVE",
"resultDocumentData": {
"classType": "DIPLOMA",
"documentType": "DIPLOMA",
"uuid": "3cc0b8f8-55c4-11f1-a975-8764834fa6b9",
"issuerName": "Uniwersytet Cybernetyki Stosowanej w Warszawie",
"subjects": [],
"graduationDate": "2026-11-28",
"name": "Jan",
"otherNames": "",
"surname": "Kowalski",
"professionalTitle": "Inżynier",
"level": "studia pierwszego stopnia",
"fieldOfStudy": "Inżynieria Inteligentnych Systemów Cyberfizycznych"
}
} Przykład pozytywnej weryfikacji dokumentu – suplement do dyplomu ukończenia studiów
{
"verificationStatus": "POSITIVE",
"resultDocumentData": {
"classType": "SUPPLEMENT",
"documentType": "SUPPLEMENT",
"uuid": "1543327c-5f4a-11f1-9804-81a6d418e6a0",
"issuerName": "Uniwersytet Innowacyjnych Technologii w Gdańsku",
"subjects": [],
"graduationDate": null,
"name": "Jan",
"otherNames": "",
"surname": "Kowalski",
"professionalTitle": "Inżynier",
"level": "studia pierwszego stopnia",
"fieldOfStudy": "Informatyka Stosowana i Systemy Inteligentne",
"issuingDate": "2026-07-03"
}
} Przykład pozytywnej weryfikacji dokumentu – dyplom doktorski
{
"verificationStatus": "POSITIVE",
"resultDocumentData": {
"classType": "PHD_DIPLOMA",
"documentType": "PHD_DIPLOMA",
"uuid": "a38e7e22-5499-11f1-b1a1-db2739198975",
"issuerName": "Akademia Zaawansowanych Technologii Kwantowych w Krakowie",
"subjects": [],
"graduationDate": "2026-12-18",
"name": "Jan",
"otherNames": "",
"surname": "Kowalski",
"professionalTitle": null,
"degreeTitle": "doktor nauk",
"domain": "dziedzina nauk inżynieryjno-technicznych",
"discipline": "automatyka, elektronika i elektrotechnika"
}
} Przykład pozytywnej weryfikacji dokumentu – dyplom habilitacyjny
{
"verificationStatus": "POSITIVE",
"resultDocumentData": {
"classType": "DSC_DIPLOMA",
"documentType": "DSC_DIPLOMA",
"uuid": "70b69087-5477-11f1-b1a1-db2739198975",
"issuerName": "Krajowy Instytut Zaawansowanych Badań Technologicznych",
"subjects": null,
"graduationDate": "2026-05-15",
"name": "Jan",
"otherNames": "",
"surname": "Kowalski",
"professionalTitle": null,
"degreeTitle": "doktor habilitowany nauk",
"domain": "dziedzina nauk inżynieryjno-technicznych",
"discipline": "inżynieria materiałowa"
}
} Przykład negatywnej weryfikacji dokumentu
{
"verificationStatus": "NEGATIVE",
"resultDocumentData": null
} Przykłady wywołania usługi weryfikacji
Przykłady pokazują sposób weryfikacji dokumentu elektronicznego na podstawie danych udostępnionych przez posiadacza dokumentu tj. imienia, nazwiska i unikalnego identyfikatora dokumentu w repozytorium dyplomów elektronicznych.
Przykład wywołania usługi (CURL)
curl -X POST "https://dyplomy.nauka.gov.pl/api/v1/public/verify/document" \
-H "Content-Type: application/json;charset=UTF-8" \
-H "Accept: */*" \
-d '{
"documentType": "DIPLOMA",
"documentData": {
"uuid": "0b0695ab-5f4c-11f1-8ec7-d5fc3203351f",
"firstName": "Jan",
"otherNames": "",
"surname": "Kowalski",
"issuerName": "",
"issuerDocumentId": ""
}
}' Przykład wywołania usługi za pomocą skryptu w języku Python
import requests
url = "https://dyplomy.nauka.gov.pl/api/v1/public/verify/document"
headers = {
"Content-Type": "application/json;charset=UTF-8",
"Accept": "*/*"
}
payload = {
"documentType": "DIPLOMA",
"documentData": {
"uuid": "0b0695ab-5f4c-11f1-8ec7-d5fc3203351f",
"firstName": "Jan",
"otherNames": "",
"surname": "Kowalski",
"issuerName": "",
"issuerDocumentId": ""
}
}
response = requests.post(url, json=payload, headers=headers)
print("Status:", response.status_code)
print("Response:", response.text)