How To Use

Create an app using Etherdrops Bot and obtain API Key and setup Webhook.

Authentication

The Etherdrops API uses Api Keys from Authorization header to authenticate requests.

All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail with 401 Unauthorized error.

Rate Limit

API requests has limit 10 requests per second.

Response

EtherDrops API

Introduction

Webhooks let you subscribe to events happening in your entities and do required action on your side.

Setup

To use webhooks you need to do next steps:

• Implement POST endpoint with public access which will handle events;
• Setup webhook (url and secret) in your Etherdrops Bot profile inside APIsection;

Signature

Each request to your webhook endpoint signed using your secret and send calculated hash in X-Sign header.

In your code that handles webhook events, you should calculate a hash using your secret token. Then, compare the hash that Etherdrops sent with the expected hash that you calculated, and ensure that they match.

Ethedrops uses an HMAC hex digest to compute the hash.

GO

Select...
mac := hmac.New(sha256.New, []byte(Secret))
mac.Write(jsonString)
signature := mac.Sum(nil)
hash = hex.EncodeToString(signature)

Webhook Endpoint

Your Endpoint should return 200 status with any response body.