Genius Referrals
Referral Software Solutions
Our platform can help any industry boost sales and unprecedented levels of brand awareness.
Referral Program Templates
Explore our referral program templates that can be customized to mesh seamlessly with your brand.
 

AUTHENTICATION

At Genius Referrals we take security very seriously, that's why we use WSSE (Web Service Security) Authentication for consuming our API. For more information regarding WSSE, please review this.

Adding the authentication to requests

For you to be able to consume our RESTful API you need to build and add an authentication header (X-WSSE) on every request. Here is an example using Curl.

Request:


# Testing Authentication
curl -v -H 'Accept: application/json' -H 'Content-type: application/json' -H 'X-WSSE: UsernameToken Username="test@geniusreferrals.com", PasswordDigest="oCKMP/2zpOOikGksjBcNS3kSd9c=", Nonce="09579a3b30e86b94d887c037b76476baf1bf2519", Created="2014-06-06T20:12:52+00:00"' -X GET https://api.geniusreferrals.com/test-authentication

Response:


GET /test-authentication HTTP/1.1
User-Agent: curl/7.22.0 (x86_64-pc-linux-gnu) libcurl/7.22.0 OpenSSL/1.0.1 zlib/1.2.3.4 libidn/1.23 librtmp/2.3
Host: api.geniusreferrals.com
Accept: application/json
Content-type: application/json
X-WSSE: UsernameToken Username="test@geniusreferrals.com", PasswordDigest="oCKMP/2zpOOikGksjBcNS3kSd9c=", Nonce="09579a3b30e86b94d887c037b76476baf1bf2519", Created="2014-06-06T20:12:52+00:00"
 
HTTP/1.1 200 OK
Date: Mon, 19 May 2014 18:45:58 GMT
Server: Apache/2.2.16 (Debian)
Cache-Control: no-cache
Access-Control-Allow-Origin: *
Allow: GET, OPTIONS
X-Debug-Token: 9a49db
Transfer-Encoding: chunked
Content-Type: application/json
 
* Connection #0 to host api.geniusreferrals.com left intact
* Closing connection #0
{
    "code":200,
    "message":"Hello test@geniusreferrals.com!, You've successfully authenticated on Genius Referrals platform."
}
LANGUAGE