Because we use OAuth 2 authentication for applications on the BinCloud® platform (BinView®, FeedView®, ResinView®, CementView®, etc.) accessing the API is a two-step process.
Step One: Get an authorization Token Step Two: Use that token in your API request
Details below:
Step One: Get Authorization Token
The first step to using BinCloud API is to get your authorization token from our BinCloud Authorization Server. You will need the following in order to do so.
| HTTP Method | POST |
| Request URL | https://bincloud.binmaster.com/authorizationserver/connect/token |
| Content-Type (Header) | application/x-www-form-urlencoded |
| Request Body | grant_type=password&resource=Your Resource&client_id=your client id&username=your account username&password=your account password&client_secret=Client Secret |
You can use this method, in a PowerShell script, PowerAutomate or a C# daemon application because the only requirement for this is that you are able to make an HTTP request.
Replace the Bold items above in the Request Body as follows:
| Your Resource | resourceApi |
| Your Client ID | the Client ID provided to you upon request |
| Your Account Username | the username you use to login to BinCloud |
| Your Account Password | the password you use to login to BinCloud |
| Client Secret | Leave Blank but leave it in. |
Example:
You will get a JSON response as shown in below example:
Step Two: Make your API call
Now that we have our access token it's time to make our call to the BinCloud API.
The following table will show all that you need to make a call to the Vendors table and get a list of all your vendors.
| HTTP Method | Get |
| Request URL | https://bincloud.binmaster.com/ResourceApi/api/Vendor/GetVendorsByAccountId/Your account id |
| Content-Type (Header) | application/json |
| Authorization (Header) | Bearer Token |
| Request Body | None |
You can find your account ID by going to your account page in BinCloud and looking at the end of the URL (See Below).
What end points are available?
You can access all the BinCloud endpoints here:
https://bincloud.binmaster.com/resourceapi/index.html