Requests

All operations follow this address

[PlatformAddress]/[WebApplicationAddress]/[Resource]/[Operation]
  • PlatformAddress – Base address of the BPN Maestro API, depends on environment (Demo : https://demo.bpn-solutions.com, Live : https://app.bpn-solutions.com).
  • WebApplicationAddress – Address of the BPN Maestro web application(api).
  • Resource – Logical group of operations, in most cases identifies target of the operations(dml or grm).
  • Operation – Name of the operation to be performed(for e.g. problem_location_list, list_request, store etc ).
For e.g. 
https://app.bpn-solutions.com/api/dlm/problem_location_list

Body

All operations of the API require an api-key and api-secret to be present in the request. Those are used to authenticate incoming requests.

{
    "api-key": "1b037676-76fc-4b85-aaad-054b25a20828",
    "api-secret": "591c3034-c67b-4fd3-986d-0d9b85044a13",
    "api-lang": "zhh"
}
ParameterTypeContractDescription
api-keyStringRequiredApplication key
api-keyStringRequiredApplication Secret key
api-langStringOptionalzh, zhh, en, fr, de, it, ja, th, vi, es, kr, id
Default value is an en.

Authentication

Each BPN Maestro environment (e.g. demo, live) requires a different set of tokens.

When api-key and api-sectet pass in api call a unique AccessToken is generated for each new property using the connection and allows the partner to access the data of that enterprise.

How to get api-key and api-secrete?

Hotel Manager can find api-key and secret-key from property setting. Click on My profile => Property Settings => API Setting. Here is link https://app.bpn-solutions.com/en/profile/user/property/setting

Updated on June 4, 2022

Was this article helpful?

Related Articles

Leave a Comment