This API endpoint allows you to certify (timestamp) a document by submitting its hash along with optional metadata such as the filename and context. It stores the document’s hash in the system for future verification and traceability.

Request

• Method: POST
• URL: /certify
• Headers:
  • Authorization: Bearer token for API authentication (required)
  • Content-Type: application/json
• Body Parameters:
  • filename (string, required): The name of the document being certified.
  • hash (string, required): The hash of the document (e.g., SHA-256).
  • context (string, optional): Additional metadata or context (can be plain text or a JSON string).

Example Request:

curl --request POST \\
  --url <https://aerodox.application.trustion-validate.com/certify> \\
  --header 'Authorization: Bearer <token>' \\
  --header 'Content-Type: application/json' \\
  --header 'User-Agent: insomnia/11.2.0' \\
  --data '{
	"filename": "test.pdf",
	"hash": "3904i23-9043i2-490",
	"context": "This is the context of a document. This can be json."
}'

Reponse:

Status code: 201

Response Fields

• success (boolean): Indicates whether the certification (timestamping) was successful.
• message (string): A message describing the result of the operation.

{
	"success": true,
	"message": "Timestamp created successfully"
}