Customer Authentication

Authentication APIs for customers

API authentications are performed by using the API key. Customers will be shared with an API key over email. Alternatively they can get the same via below customer authentication API to get the API key.

Customer Authentication

POST /customer/auth

It's time to authenticate your first integration with a Blowhorn API for customer authentication. This api takes base64 encoded username and password to authenticate the customer and returns the API key. Post authentication customers should be able to authenticate and use Blowhorn APIs by just passing API key each time in the header.

Request Body

Name	Type	Description
username*	String	Base64 encoded username string
password*	String	Base64 encoded password string

200: OK After successful authentication

{
    "status": "PASS",
    "api_key": "Bj143Lm09qjQ"
}

400: Bad Request Bad Request/Validation Error

{
    "status": "FAIL",
    "message": "Sample Error Message"
}

Example/Schema

{
    "email": "[e-mail]",
    "password": "1234"
}

Base64 Encoding

Python

import base64
import requests

auth_string = "email:password"
auth_string_bytes = auth_string.encode('ascii')

base64_bytes  = base64.b64encode(auth_string_bytes)
base64_string = base64_bytes.decode('ascii')

url = 'https://blowhorn.com/api/customer/auth'
headers = {'Authorization': base64_string}

response = requests.get(url, headers=headers)

api_key_string = response.json().get('api_key')
api_key_bytes  = api_key_string.encode('ascii')
b64_bytes      = base64.b64decode(api_key_bytes)
api_key        = b64_bytes.decode('ascii')

PHP

<?php
 $auth_str = "email:password";
 $base64_str = base64_encode($auth_str);
 
 $url = 'https://blowhorn.com/api/customer/auth';
 $ch = curl_init();
 curl_setopt($ch,CURLOPT_URL,$url);   
 curl_setopt($ch, CURLOPT_HTTPHEADER, array(
      'Content-Type: application/json',
      'Authorization: ' . $base64_str)
  );
  $result = curl_exec($ch);
  
  $data = json_decode($result);
  $api_key_string = $data->api_key;
  $api_key = base64_decode($api_key_string);
  ?>