Every endpoint requires an API Key. You will receive an HTTP 403 Unauthorized error if attempting to access any endpoint without a valid API Key.
If you are already working with Wagestream, your Partner Success Manager (PSM) will give you your API key. If you've lost it, contact email@example.com and they will get it right over.
If you are not working with Wagestream, why not contact our sales team at firstname.lastname@example.org? They can get you up-and-running with a trial account in less than 2 minutes.
If you are a developer and you just want to play around, you can register for a temporary API key. It will only be valid for 7 days.
You can log into the developer portal in the top right, and all of the code examples will be pre-filled with your API Key.
If you want to write your own code, simply include an HTTP header with all requests:
When your Wagestream account in in trial mode, APIs will be accessible from any IP address.
However, when it comes time to "go live", we recommend instituting one or more further layers of security.
Contact your Partner Success Manager with one or more IP address blocks in CIDR notation and we will lock down your API to just that range. Any traffic from other IP addresses will be shadowbanned (meaning, the request will appear to have succeeded, with the usual HTTP response, but will be silently ignored).
Wagestream's APIs are hosted in Amazon Web Services, in the data center appropriate for your company's data (
us-east-1). The strongest possible security involves setting up a site-to-site VPN between your servers and a dedicated EC2 VPC. Doing so is beyond the scope of this article, but if you're interested contact email@example.com to learn more.