Certificate/accesslevel

From SafeStamper API documentation
Jump to navigation Jump to search

This operation changes the access protection of a certificate.

There are three access protection modes for a certificate:

  • PUBLIC The certificate can be downloaded by anyone who has its validation URL. This is the default, so that any party that receives a Safe Stamper certificate can verify its authenticity.
  • PRIVATE Only the owner can download the certificate
  • PASSWORD The validation URL asks for a password before downloading the certificate.

If you plan to give the certificate to a third party or use it in any legal proceeding, you should make it public or password-protected and provide the password along with the certificate, to allow the receiving party to verify the certificate authenticity.

The certificate owner can always download the certificate without a password. API applications can use certificate/get to download certificates from their users even if they are private or password-protected.

URL

https://www.safestamper.com/api/certificate/accesslevel

Parameters

  • sharedkey: Your API client shared key
  • authkey: Authkey of certificate owner
  • code: Code of certificate to set the password
  • level: Access level for the certificate (PUBLIC, PRIVATE or PASSWORD)
  • password: Certificate access password. Required for PASSWORD access level.
  • signature: Parameters signature, as explained in Signature parameter

Returns

HTTP 200 OK

HTTP Errors

  • 401 Unauthorized: the authkey is not exist
  • 403 Forbidden: the sharedkey or signature are not valid
  • 404 Not found: the certificate does not exist
  • 400 Unrecognized access level or password not provided for PASSWORD level

Example

REQUEST:

https://www.safestamper.com/api/certificate/accesslevel
?authkey=0021d81c-e4a5-4869-8384-2fd70cdb58ec
&code=150730-U27FJH
&level=PASSWORD
&password=1234
&sharedkey=axvmfqn8aex21mxhq5zsj7l482saxfu7j4hh
&signature=b1b22b34967fdf2eb67c3569a1e8b90f9fb63e77

RESPONSE:

HTTP 200 OK