Get the data for the tokens given in the request body. Any JSON values that are not reference tokens will be returned as is. No more than 1024 values are accepted in a request. If any token is associated with data greater than 3kb, the value will be null in the response. If the total size of the request, after ignoring single values that overflow, is greater than 500kb, the request will be rejected with a 509 status code.
ALTR API's authorization protocol relies on a properly formatted authorization header. The accepted format is: "ALTR " + api_key + ":" + signature. signature is a base64-encoded, SHA-256 hash that uses the API key's secret as the key for the hash function. The payload being hashed must follow the format: HTTP-METHOD + "\n" + RESOURCE + "\n" + DATE + "\n". DATE must match X-ALTR-DATE, and RESOURCE must be empty for a POST request. An example payload for a POST request is: "POST\n\n01-01-1970 00:00:00\n"
The datetime used in the Date signature. If this is more than 15 minutes past the server's internal clock, the request will be rejected.
must be application/json
If any token is over 3kb, or the entire batch is over 500kb this flag will be set and the tokens that overflowed will be returned as null.
date = new Date();
payload = 'PUT\n\n' + date + '\n';
API_KEY = <your API key>;
SECRET = <your API secret>;
"Authorization": "ALTR " + API_KEY + ":" + base64(hmac-sha256(payload, SECRET)),
On success, all tokens given in the request will be replaced with the data associated. All non-tokens are given back. If the data for any token is greater than 3kb, the X-Overflow-Data header will be set to true and the value associated with the key will be null.
HTTP/1.1 200 OK
"key1": <data for token1>,
"key2": <data for token2>
Invalid JSON detected.
The API key could not be authenticated.
API key does not have read permissions.
The requested resource could not be found.
The web server encountered an unexpected error.
Limit Exceeded Request exceeded 500kb limit. X-Overflow-Data header will be set to true.
HTTP/1.1 503 Internal Server Error
"error_message": "Unable to process request at this time."