-
-
Notifications
You must be signed in to change notification settings - Fork 8
Certificate API
The certificate API is used to create, manage, update, and remove certificate. As of now, it isn't authenticated. It functions as a REST API, supporting a variety of routes and methods.
All APIs are mounted on the /api
route, including the certificate API.
Unless states otherwise, all non-empty request bodies are expected to be be JSON.
The following routes and methods are supported in the certificate API.
This route supports 3 methods: GET
, POST
, and DELETE
.
Retrieves the credential IDs of all certificates.
Request
GET /api/certificate
Response
{
"msg": "11 certificate(s) found!",
"count": 11,
"data": [
"e03a698d-e7a4-4a49-af72-7c90c8966a90",
"78966f20-0a4a-4f98-8634-bb2019d5dc94",
...,
"6b7ede30-6924-47f1-92cb-8f974d5f2dc3"
]
}
Generates a new certificate.
Request
POST /api/certificate
Content-Type: application/json
{
"title": "My Certificate",
"template": "stock-best-award",
"values": [
{
"name": "name",
"value": "Param Siddharth"
},
{
"name": "Description",
"value": "This is a sample victory!"
},
{
"name": "signature",
"value": "Param"
}
]
}
Response
{
"msg": "Certificate created!",
"data": {
"title": "My Certificate",
"template": "stock-best-award",
"values": [
{
"value": "Param Siddharth",
"visible": true,
"name": "name"
},
{
"value": "Param",
"visible": true,
"name": "signature"
}
],
"date": "2021-07-22T15:55:11.094Z",
"uid": "126b8636-ccf9-4f78-b795-5a830c48a54e"
}
}
Delete all/multiple certificates. Currently, this method only supports deleting ALL certificates.
Request
DETELE /api/certificate
Response
{
"msg": "All certificates deleted!",
"data": [
"e03a698d-e7a4-4a49-af72-7c90c8966a90",
"78966f20-0a4a-4f98-8634-bb2019d5dc94",
...,
"126b8636-ccf9-4f78-b795-5a830c48a54e"
],
"count": 12
}
This route is used for operations pertaining to the certificate identified by {uid}
.
It supports the GET
, PATCH
, and DELETE
methods.
Retrieves a particular certificate.
Request
GET /api/certificate/126b8636-ccf9-4f78-b795-5a830c48a54e
Response
{
"msg": "Certificate found!",
"data": {
"title": "My Certificate",
"template": "stock-best-award",
"values": [
{
"value": "Param Siddharth",
"visible": true,
"name": "name"
},
{
"value": "Param",
"visible": true,
"name": "signature"
}
],
"date": "2021-07-22T16:25:47.113Z",
"uid": "126b8636-ccf9-4f78-b795-5a830c48a54e"
}
}
Update a particular certificate.
The request body is supposed to have an updated version of the same certificate. The untouched global properties of the certificate and the unchanged values may be omitted.
Request
PATCH /api/certificate/126b8636-ccf9-4f78-b795-5a830c48a54e
Content-Type: application/json
{
"title": "Your Certificate"
}
Response
{
"data": {
"title": "Your Certificate",
"template": "stock-best-award",
"values": [
{
"value": "Param Siddharth",
"visible": true,
"name": "name"
},
{
"value": "Param",
"visible": true,
"name": "signature"
}
],
"date": "2021-07-22T16:25:47.113Z",
"uid": "126b8636-ccf9-4f78-b795-5a830c48a54e"
},
"msg": "Certificate updated!"
}
Deletes a particular certificate.
Request
DELETE /api/certificate/126b8636-ccf9-4f78-b795-5a830c48a54e
Response
{
"msg": "Certificate deleted!",
"data": {
"title": "Your Certificate",
"template": "stock-best-award",
"values": [
{
"value": "Param Siddharth",
"visible": true,
"name": "name"
},
{
"value": "Param",
"visible": true,
"name": "signature"
}
],
"date": "2021-07-22T16:25:47.113Z",
"uid": "126b8636-ccf9-4f78-b795-5a830c48a54e"
}
}
This route supports only GET
requests and returns the
rendered certificate identified by {uid}
. The format
is PNG by default. If the query parameter pdf
is provided
with any value, the certificate is rendered and returned
as a PDF.
- PNG:
GET /api/certificate/126b8636-ccf9-4f78-b795-5a830c48a54e/preview
- PDF:
GET /api/certificate/126b8636-ccf9-4f78-b795-5a830c48a54e/preview?pdf
This route supports only POST
requests and is used to create
certificates in bulk using the same template.
The incoming request body must be of the type multipart/form-data
,
containing the template name under the template
key,
and a CSV file under the list
key.
Request
POST /api/certificate/bulk
Content-Type: multipart/form-data; boundary=biharsehoon
--biharsehoon
Content-Disposition: form-data; name="template"
stock-best-award
--biharsehoon
Content-Disposition: form-data; name="list"; filename="list.csv"
Content-Type: text/csv
name,Description,signature
Param Siddharth,This is a sample victory!,Param
Krishna Kabir Siddharth,This is a sample victory!,Param
Hans Lata,This is a sample appreciation!,Param
Santosh Kumar,This is a sample appreciation!,Param
--biharsehoon--
Response
{
"msg": "Certificates generated!",
"certificates": [
"3aece973-f572-40b9-8292-02d15bbf6ca0",
"6391f246-be6f-4360-9b57-a870db6dfa65",
"6845ce11-5545-4b01-9b6b-136710f7e632",
"bb644daa-e1f0-42bd-9806-a260125ac684"
],
"errors": [],
"template": "stock-best-award"
}