1. RunSignup
  2. API
  3. Protected API

Protected API

Some API calls require a protected_api_signature parameters in the URL. These are protected APIs. To access these APIs, please contact us at to get an ID and signing secret.

Signatures

These are used to generate the protected_api_signature in API requests. The signature should have the format <ID>.<UNIX Timestamp>.<Nonce>.<HMAC Hash>. The <UNIX Timestamp>portion must be within 5 minutes of the current time on the RunSignup servers. The <Nonce> portion must be 8 random alphanumeric characters that are unique within a 15 minute interval. The <HMAC Hash> portion is the SHA1 hash (in hex) using the HMAC method of the string before this value (including the period just before). In PHP, this would be:

$id = …;
$secret = '…';
$nonce = …;
$sig = $id . '.' . time() . '.' . $nonce . '.';
$sig = $sig . hash_hmac('sha1', $sig, $secret);
echo $sig;

Signature Generator (For Testing Only)

If you continue to use this site, you consent to use all cookies. We use cookies to offer you a better browsing experience. Read how we use cookies and how you can control them by visiting our Privacy Policy.

If you continue to use this site, you consent to use all cookies.