Authentication

The WumDrop API will only obey your commands if it can successfully establish your identity. We have provided a very simple way for you to authenticate - just provide your API key in the username field (see examples below). A key can be obtained by registering on http://wumdrop.com

We also provide a way to test the functionality without carrying out real world transactions - by using your Sandbox key in the username field instead.

🚧

SSL Only

Only API requests sent over HTTPS will be processed.

Test Authentication

WumDrop API v1 uses Basic HTTP auth.

cURL

$ curl -u YourApiKey https://api.wumdrop.com/v1/test

The response obtained on this endpoint will contain your Username if the authentication has succeeded.

JSON

{
  'message': 'Welcome, UserName. Your request looks good.'
}

Let's try the same request with an incorrect API key:

cURL

$ curl -u WrongApiKey https://api.wumdrop.com/v1/test

And here's what a response to a failed authentication looks like:

JSON

{
  "message": "unauthorized access",
  "status": "error"
}