Tuhund - Authentication Key Generation API

API List

CRM Integration API

Delivery / Shipment Order API

Expense Claims Integration API

Inventory Module Integration API

Sales Module Integration API

Shopping Cart Integration API

Procurement Module API

Manufacturing Module API

API # : 8001 | API Name : auth

This API is used to generate authentication key, that will be sent with every other API call as unique identifier, and authenticator in single string. At any point of time, by default Tuhund servers allow a maximum of 99 active authentications keys against any single authentication code. Depending on the type of application, this number can be changed. 99 failed attempts to generate authentication key with invalid authentication code blocks all requests from the originating source for a period of 24 hours.

URL : <domain>/apic/auth
Methods Allowed : POST

Request Parameters :

Name	Description
key	Unique authentication code given to each vendor. Authentication code is different for sandbox and production environments.

Request Headers :

Name	Description
device	A short name of your application. Device is mandatory but any value between 3 and 20 characters is accepted.

Sample request :

curl -v http://sandbox.tuhund.com/apic/auth \
-H "device:ECOM" \
-d "key=h9F564O6mLncccccc2222222E5mmCO69e7659F1N9oKnS956n58iBmO967LnxuO9"

Sample success response :

{
  "result": 1,
  "key": "vBD541GO78383p5B95969k8D7654d3nnKDf1GFk41CD0D9kFvdd6
x5d45g6BY938d85K9FsB84678fj3BnLgj565o8f542BWs1F8f52g63eBXgGAg
3B2Ke75n941Iyp4863kqR86fh785D486nK969d52EPk6386Bo8x1LD3kr3B95
8396584ikEe4d6O78Br",
  "message": "Authentication key generated.",
  "caller": 1001,
  "life": 3600000,
  "list": [
    {
      "code": "time",
      "name": "Server Date and Time"
    },
    {
      "code": "pricelist",
      "name": "Price list"
    },
    {
      "code": "registerquotation",
      "name": "Register Quotation"
    }
    ]
}

Sample failure response :

Case 1: Request sent without authentication code
Parameter named “id” not sent with the request

{
	"response":-1,
	"errorcode":401,
	"message":"No such API authentication exists."
}

Case 2: Invalid authentication code

{ "result": -1, "message": "API Key might be corrupt, revoked or expired.", "errorcode": 401 }
Case 3: No such authentication code exists
{ "response":-1, "errorcode":401, "message":"No such API authentication exists." }