Certificate/changepassword

From SafeStamper API documentation
Revision as of 03:02, 22 September 2020 by api>Admin
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigation Jump to search

This operation is deprecated. Use certificate/accesslevel instead.

This operation allows to set a password to protect certificate validation process.

Safe Stamper certificates are publicly downloadable by default, so that any party that receives a Safe Stamper certificate can verify its authenticity.

If a certificate contains sensible data, the user can protect its access with a password. If the user gives a protected certificate to a third party, he should also be provide the certificate password to allow such 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 password-protected.

URL

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

Parameters

  • sharedkey: Your API client shared key
  • authkey: Authkey of certificate owner
  • code: Code of certificate to set the password
  • password: Password certificate. (if not present, the existing password will be deleted)
  • 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

Example

REQUEST:

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

RESPONSE:

HTTP 200 OK