MicroBilt Portal Quick start guide

Step 1: Create an account

To make your first API request you’ll first need to create a Developer Portal account. 
Once your email address is verified, you’re ready to start developing your first application.

Step 2: Register your first application

Now you have successfully registered, you are ready to create a key and test our APIs.

  1. Go to My API Keys and click on Add A New Key
  2. Give your new Key a name (e.g. ‘My Test Key’)
  3. Select the product that will be associated with this key( e.g. ‘IPAddressValidation’)
  4. Click Create Key and start exploring.

Step 3: Get an access token

When you create a key you are given a Client ID and Client Secret.

Get your access token by following the steps in our OAuth2 tutorial

curl -X POST https://apitest.microbilt.com/OAuth/GetAccessToken \
      -H 'Content-Type: application/json' \
      -d '{ "client_id": "<CLIENT_ID>","client_secret": "<CLIENT_SECRET>" , "grant_type" : "client_credentials" }'
    

Response Example:

{
      "issued_at" : "1525190727056",
      "expires_in" : "3599",
      "token_type" : "BearerToken",
      "access_token" : "kE8WyfAAgaoPPisGakxRw9aEL8eH",
      "status" : "approved"
    }

Step 4: Send your first API request

Use your access token as a bearer token in the authorization header and make your first API call

curl -X GET https://apitest.microbilt.com/IPAddressInfo \
    	-H 'Content-Type: application/json' \
    	-H 'Accept: application/json' \
    	-H 'Authorization: Bearer <ACCESS_TOKEN>' \
    	-d '{ "IP" : "1.2.3.4" }'