Certificates - Revision history

Adminwiki: /* Returns */

2026-03-10T08:22:09Z

Returns

← Older revision		Revision as of 04:22, 10 March 2026
Line 49:		Line 49:
	**** '''accuracy''': Accuracy of geographic location, in meters		**** '''accuracy''': Accuracy of geographic location, in meters
	**** '''address''': Human-readable photo location		**** '''address''': Human-readable photo location
			**** '''photoUrl''': Temporary URL for downloading the original photo (valid for 1 hour)
	*** File certificates		*** File certificates
	**** '''filename''': File name		**** '''filename''': File name

Adminwiki: /* Parameters */

2026-01-16T08:08:31Z

Parameters

← Older revision		Revision as of 04:08, 16 January 2026
Line 14:		Line 14:
	** ''mail'' E-mail certificates		** ''mail'' E-mail certificates
	** ''photo'' Geo-located photographs		** ''photo'' Geo-located photographs
			** ''video'' Geo-located video recordings
			** ''audio'' Geo-located audio recordings
			** ''photo_video'' Mobile app certificates (includes ''photo'', ''video'' and ''audio'' certificates)
	** ''file'' Files		** ''file'' Files
			** ''noti'' Notification certificates
			** ''signature'' Signed documents
	* '''fromDate''': Return certificates generated from this date on (optional, format yyyy-MM-dd)		* '''fromDate''': Return certificates generated from this date on (optional, format yyyy-MM-dd)
	* '''toDate''': Return certificates generated up to this date (optional, format yyyy-MM-dd)		* '''toDate''': Return certificates generated up to this date (optional, format yyyy-MM-dd)

Adminwiki: 1 revision imported

2023-10-17T11:27:27Z

1 revision imported

← Older revision	Revision as of 07:27, 17 October 2023
(No difference)

api>Admin: /* Parameters */

2017-04-25T09:49:31Z

Parameters

New page

This operation lists the certificates of the authorizing user.

= URL =
<nowiki>https://www.safestamper.com/api/certificates</nowiki>

= Parameters =
* '''sharedkey''': Your API client shared key
* '''authkey''': Authorization key
* '''type''': Type of certificate to search
** ''web_static'' Static web pages
** ''web_snapshots'' Web browsing sessions with snapshots
** ''web_video'' Web browsing sessions with video
** ''web'' Web certificates, includes ''web_static'', ''web_snapshots'' and ''web_video'' certificates
** ''mail'' E-mail certificates
** ''photo'' Geo-located photographs
** ''file'' Files
* '''fromDate''': Return certificates generated from this date on (optional, format yyyy-MM-dd)
* '''toDate''': Return certificates generated up to this date (optional, format yyyy-MM-dd)
* '''filter''': Text for searching certificates (optional)
* '''page''': Page number to return (optional, defaults to 1)
* '''signature''': Parameters signature, as explained in [[Signature parameter]]

= Returns =

A JSON object with the following fields:

* '''pageSize''': Maximum number of certificates per page
* '''count''': Total number of certificates
* '''pageTotal''': Total number of pages
* '''list''': array of JSON with the certificates data
** '''entryDate''': Date of certificate
** '''code''': Certificate code
** '''url''': Public URL for certificate download
** '''thumbnailUrl''': URL of thumbnail of certificate (optional, just for web and photo certificates)
** '''properties''': JSON with the properties of the certificate
*** Web certificates
**** '''url''': URL that was certified
*** Mail certificates
**** '''toAddresses''': E-mail destinataries
**** '''subject''': Subject of e-mail
*** Photo certificates
**** '''latitude''': Latitude where the photo was taken
**** '''longitude''': Longitude where the photo was taken
**** '''accuracy''': Accuracy of geographic location, in meters
**** '''address''': Human-readable photo location
*** File certificates
**** '''filename''': File name
**** '''size''': Size of file
**** '''md5''': MD5 hash of file
**** '''sha1''': SHA1 hash of file
**** '''sha256''': SHA256 hash of file
**** '''sha512''': SHA512 hash of file

= HTTP Errors =

* '''403''' Forbidden: the sharedkey or signature are not valid
* '''401''' Unauthorized: authkey is not valid or not authorized

= Example =

REQUEST:
<pre>
https://www.safestamper.com/api/certificates
?authkey=0dbb406d-cc0c-4ef8-ae80-971ed108c2f9
&sharedkey=axvmfqn8aex21mxhq5zsj7l482saxfu7j4hh
&type=web
&signature=b1b22b34967fdf2eb67c3569a1e8b90f9fb63e77
</pre>

RESPONSE (actual response has no line breaks or indentation):
<pre>
{
"pageSize":50,
"count":1,
"pageTotal":1,
"list":[
{
"entryDate":"2016-11-11T12:59:36Z",
"code":"161111-8CM65B",
"url":"http://dev.safestamper.com:9001/certificate/161111-8CM65B",
"thumbnailUrl":"https://pagestamper-dev.s3.amazonaws.com/16/11/11/161111-8CM65B.png?AWSAccessKeyId\u003dAKIAI2GFJVQOFPVV5SZA\u0026Expires\u003d1480695450\u0026Signature\u003dL7TBOPa6gKVS5OTGASfq68XMxGk%3D",
"properties":{"url":"https://informaticaglobaldariomo.blogspot.com.es/2016/08/startup-manager-una-aplicacion-android.html"}
}
]
}
</pre>