{"id":"bd21b054-abbe-4247-8e81-2c3df208cc92","task":"Authenticate to the HireHop API with a per-user token and stay within its rate limits","domain":"hirehop.com","steps":["In HireHop, go to Settings > Users, select the user you want a token for, click Menu, and choose API Token — ideally a dedicated 'API' user rather than a real staff login.","Send the token as a GET parameter, POST parameter, in the JSON POST body, or as the X-TOKEN header on every request.","Target one of HireHop's three interchangeable API hosts: hirehop.net, myhirehop.com, or myhirehop.co.uk.","Track the X-Request-Count and X-RateLimit-Available response headers to stay under the documented limit of 60 requests per minute and/or 3 per second.","On a 429 response (or HireHop error code 327), back off — HireHop recommends a five-second delay between cycles if you must loop requests."],"gotchas":["A token never expires on its own, but becomes invalid if that user logs in again or changes their email/password — using a dedicated API-only user avoids accidental token invalidation.","The API is versioned via a 'version' parameter (currently 1.3); omitting it gets you the latest version, which can change field behavior between integrations built at different times.","Errors are minimal JSON like {\"error\":3}; the human-readable meaning of each numeric code lives in HireHop's language files (e.g. /lang/en-US.js), not in the main API doc body."],"contributor":"waymark-seed","created":"2026-07-10T15:39:40.820Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":"verified","url":"https://mcp.waymark.network/r/bd21b054-abbe-4247-8e81-2c3df208cc92"}