TimestampApi.md

TimestampApi

All URIs are relative to https://api.originstamp.com

Method	HTTP request	Description
createTimestamp	POST /v4/timestamp/create	Submission
getHashStatus	GET /v4/timestamp/{hash_string}	Status
getSeedStatus	GET /v4/timestamp/status/seed/{seed_id}	Seed Status

createTimestamp

DefaultOfTimestampResponse createTimestamp(authorization, timestampRequest)

Submission

With this interface you can submit your hash. If your API key is valid, your hash is added seeds and scheduled for timestamping. You are also able to submit additional information, such as a comment or notification target. If the hash already exists, the 'created' field in the response is set to 'false' and any notification(s) for this hash will be ignored. To later query the status of the hash for a certain blockchain you can use the 'seed_id' field of its inner timestamp structure. This field can be used to query the timestamping status of the selected seed. This is recommended if a large number of hashes were transmitted in a certain time frame. Once a hash is successfully created for a certain crypto currency, we can notify your desired target with the timestamp information (via POST Request). A webhook is triggered as soon as the tamper-proof timestamp with the selected crypto currency has been created.

Example

// Import classes:
//import com.originstamp.api.client.ApiException;
//import com.originstamp.api.TimestampApi;

TimestampApi apiInstance = new TimestampApi();
String authorization = "authorization_example"; // String | A valid API key is essential for authorization to handle the request.
TimestampRequest timestampRequest = new TimestampRequest(); // TimestampRequest | DTO for the hash submission. Add all relevant information concerning your hash submission.
try {
    DefaultOfTimestampResponse result = apiInstance.createTimestamp(authorization, timestampRequest);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling TimestampApi#createTimestamp");
    e.printStackTrace();
}

Parameters

Name	Type	Description	Notes
authorization	String	A valid API key is essential for authorization to handle the request.
timestampRequest	TimestampRequest	DTO for the hash submission. Add all relevant information concerning your hash submission.

Return type

DefaultOfTimestampResponse

Authorization

[API Key Authorization](../README.md#API Key Authorization)

HTTP request headers

• Content-Type: application/json
• Accept: application/json

getHashStatus

DefaultOfTimestampResponse getHashStatus(authorization, hashString)

Status

This interface returns information of a certain hash read from the URL path. If the status of several hashes is to be checked, it is preferable to use the seed status interface. This reduces the required requests and can be tailored to a desired blockchain. All 'created' fields are always set to false for a status request.

Example

// Import classes:
//import com.originstamp.api.client.ApiException;
//import com.originstamp.api.TimestampApi;

TimestampApi apiInstance = new TimestampApi();
String authorization = "authorization_example"; // String | A valid API key is essential for authorization to handle the request.
String hashString = "hashString_example"; // String | The hash in string representation.
try {
    DefaultOfTimestampResponse result = apiInstance.getHashStatus(authorization, hashString);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling TimestampApi#getHashStatus");
    e.printStackTrace();
}

Parameters

Name	Type	Description	Notes
authorization	String	A valid API key is essential for authorization to handle the request.
hashString	String	The hash in string representation.

Return type

DefaultOfTimestampResponse

HTTP request headers

• Content-Type: application/json
• Accept: application/json

getSeedStatus

DefaultOfTimestampData getSeedStatus(authorization, seedId)

Seed Status

With this interface you can request the status for a certain seed. This is used when checking the status of previously submitted hashes and avoids sending individual status requests for each hash.

Example

// Import classes:
//import com.originstamp.api.client.ApiException;
//import com.originstamp.api.TimestampApi;

TimestampApi apiInstance = new TimestampApi();
String authorization = "authorization_example"; // String | A valid API key is essential for authorization to handle the request.
String seedId = "seedId_example"; // String | ID of the timestamp seed
try {
    DefaultOfTimestampData result = apiInstance.getSeedStatus(authorization, seedId);
    System.out.println(result);
} catch (ApiException e) {
    System.err.println("Exception when calling TimestampApi#getSeedStatus");
    e.printStackTrace();
}

Parameters

Name	Type	Description	Notes
authorization	String	A valid API key is essential for authorization to handle the request.
seedId	String	ID of the timestamp seed

Return type

DefaultOfTimestampData

HTTP request headers

• Content-Type: application/json
• Accept: application/json