Ragic Logo
<< API LimitsTable of ContentsPassword authentication >>

HTTP Basic authentication with Ragic API Key

You authenticate to the Ragic API by providing one of your API keys in the request. Your API keys carry many privileges, so be sure to keep them secret!

Authentication to the API occurs via HTTP Basic Auth. Provide your API key as the basic auth username. You do not need to provide a password.

All API requests must be made over HTTPS. Calls made over plain HTTP will fail. You must authenticate for all requests.

curl https://www.ragic.com/demo/sales/1\

--get -d api \

-H "Authorization:Basic YOUR_API_KEY_GOES_HERE"

Note that the HTTP header name is Authorization, and the value is your API key preceded with "Basic ", Basic with a space at the end.

You can find the user's API key in the change password menu in your Ragic account. Just hover over your user name at the top right in your Ragic account and you will find the change password link. You can also just click here to get the API key for the user that you're currently logged in to Ragic. If you're on an on-premises server, you can also log in first and use the following URL to retrieve your API key: http://<your server url>/sims/reg/getAPIKey.jsp

Most HTTP clients (including web-browsers) present a dialog or prompt for you to provide a username and password (empty) for HTTP basic auth. Most clients will also allow you to provide credentials in the URL itself.

If for some reason that you are not able to send the API key as HTTP header or basic authorization, you can send the API key as a parameter with the name APIKey. You will need to add this parameter for every single request you send.

Top of Page
<< API LimitsTable of ContentsPassword authentication >>
Learn more about Ragic:
Why we created Ragic
User Guide
Keep in touch:
Ragic, Inc.