GDPR Compliance
- Random, unique, collision-proof, 128bit token
- Secure token expiry
- One time use delay interval
- GDPR Controller designation
- Encrypted in transit; encrypted at rest with AES-256
- Token records automatically removed after TTL and OTU with system level delete
- No secondary index for maximum GDPR compliance
GET checktoken
Returns the key value pairs associated with the token.
Resource URL
https://api.magiclinkmaker.com/checktoken
Resource Information
Response formats: JSON
Requires authentication? No
Rate limited? Yes
Rate: 10 requests per second
Burst: 100 requests
Parameters
Name: TokenId
Required: Yes
Description: 128 bit id of the record item
Example Request
GET https://api.magiclinkmaker.com/checktoken?TokenId=0b56244cc5e643fab930dfd2b69fe459
Example Responses
Example 1
{
"ItemData":{
"egg salad":"chopped hard-boiled eggs gently tossed with mayonnaise, a dash of mustard and a pinch of paprika for color",
"GDPRController": "MyCompany, LLC"
},
"TokenId":"29f3714ba4ae43ada46ec0ea9552b8ed",
"UTCExpiry":1586390400,
"UTCOTUDelay":15,
"UTCOTUTimestamp":1586387247}
}
Example 2
"Invalid Token"
Example 3
"Token Expired"
Example 4
"Token Used"
(response indicates token was used AND the TokenConfigOTUDelay interval has passed)
POST createtoken
Returns the key value pairs associated with the token.
Resource URL
https://api.magiclinkmaker.com/createtoken
Resource Information
Response formats: JSON
Requires authentication? Yes, API Key
Rate limited? Yes
Rate: 10 requests per second
Burst: 100 requests
Parameters
Name: token_otu_delay
Required: Yes
Description: One Time Use Delay. Seconds until token expires afer first use.
Name: token_expiry
Required: Yes
Description: hours until token expires
Name: gdpr_controller
Required: Yes
Description: Name or Entity Name of GDPR Controller
Request Headers
"Content-Type", "application/json"
"x-api-key", "[KEY GOES HERE]"
Example Request
POST https://api.magiclinkmaker.com/createtoken
{
"token_expiry": "24",
"token_otu_delay": "15",
"gdpr_controller": "MyCompany, LLC",
"egg salad":"chopped hard-boiled eggs gently tossed with mayonnaise, a dash of mustard and a pinch of paprika for color",
}
Example Response
"29f3714ba4ae43ada46ec0ea9552b8ed"
