General information

In general, people who got vaccine shots will be provided a Digital Covid Certificate with a QR code that can scan by the app of goverment. This page provide an api that can decode the text certificate from the qr code, then show you detail information about the shot and also verify if the vaccination certificate is valid.

Vaccine Certificate text from Qr-Code

The vaccine certificate text can be obtained by scan your QR-Code with any Qr-code scanner

Key API

We provide free key for using the API

Key Value
ApiKey #frEehegdKEY%^%_)

Overview

In general, users can use postman to send request to the API for specify response. A succesful request using postman will look like below

reponsive image
The application can be dowloaded with the link below
Dowload Postman




Verify covid cerificate

This section show how to send request todesigned API for verifying covpass

Prerequiste
Url: https://site/covidverifier

Replace the "site" with the url to the webpage


Covid Certificate Text: The text from covpass QR-code

Can be obtained by using any QR-Scanner


API Keys: Custom API-Key for authentication

Can be founded in the General Information


Step 1: After create a untitled request, select the Post method and pass the URL to the box next to it
reponsive image

Step 2: Then select "Header"then fill the "Key" and "Value" as shown in the picture below
reponsive image

Step 3: Then select "Body-->"Raw"-->"JSON" as shown in the picture below
reponsive image

Step 4: Finally, pass the covpass certificate text with the double quote "" into the box as shown below and click Send
reponsive image

Result: If the request is success the response will be shown in the "Response" box with 3 main values

+ The first one is "cwt" which stand for "CBOR web token" and contains all information about the certificate like name, issuer, issue-time, expiration, etc.


+ The second one is "isValid" which confirm if the cov-pass is valid or not


+ In case the cov-pass is invalid the "Reason" show the proof why the cov-pass is invalid




Get Document Signer Certificates (DSCs)

Using the Postman user can also request the Dicument signer certificate for specify country

Prerequiste
Url for query all dscs: https://site/covidverifier/dscs/all
Url for query all dscs from specify country: https://site/covidverifier/dscs/all/{countryname}

Replace the "site" with the url to the webpage

Covid Certificate Text: The text from covpass QR-code

Can be obtained by using any QR-Scanner

API Keys: Custom API-Key for authentication

Can be founded in the General Information


Step 1: After create a untitled request, select the Get method and pass the URL to the box next to it
reponsive image

Step 2: Then select "Header"then fill the "Key" and "Value" as shown in the picture below and click send
reponsive image
Result: If the request is success the response will be shown in the "Response" box with certificates and their detail values


Verify covid cerificate

This section shows how to use C# to send a request to the designed API to verify the certificate

Step 1: Create HttpClient Object with the given ApiKey to send the request to the server.
        
            HttpClient client = new HttpClient();
            client.DefaultRequestHeaders.Accept.Clear();
            client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
            client.DefaultRequestHeaders.Add("ApiKey", "Your Key");

            var URL = "https//covidvalidator.website"; //replace with the correct URL
            client.BaseAddress = new System.Uri("URL");
        
        
Step 2: Input the string from QR code and convert it to Json Object.
        
            string qrString = "String from QR code";
            var jObj = JsonSerializer.Serialize(qrString);
            var content = new StringContent(jObj, Encoding.UTF8, "application/json");
        
        
Step 3: Send the request using POST method and get the content of the response.
        
            var response = await client.PostAsync("covidverifier", content);
            var responseString = await response.Content.ReadAsStringAsync();
        
        

Get Document signer certificates (DSCs)

This section shows how to use C# to send a request to the designed API to Get all DSCs or DSCs from specific country

Step 1: Create HttpClient Object with the given ApiKey to send the request to the server.
        
            HttpClient client = new HttpClient();
            client.DefaultRequestHeaders.Accept.Clear();
            client.DefaultRequestHeaders.Accept.Add(new MediaTypeWithQualityHeaderValue("application/json"));
            client.DefaultRequestHeaders.Add("ApiKey", "Your Key");

            var URL = "https//covidvalidator.website"; //replace with the correct URL
            client.BaseAddress = new System.Uri("URL");
        
        
Step 2: Send the request using GET method and get the content of the response.

Get all DSCs list that are accepted by Germany:
            
            // Get all DSCs
            var response = await client.GetAsync("covidverifier/dscs/all");
            var responseString = await response.Content.ReadAsStringAsync();
        
        
Or Get DSCs list from other country that are accepted by Germany:
            
            // Get DSCs from a country            
            var country = "de"; // Use another country code such as fr if you want to get DSCs from France
            var response = await client.GetAsync($"covidverifier/dscs/{country}");
            var responseString = await response.Content.ReadAsStringAsync();