Important

You are browsing the documentation for version 3.1 of OroCommerce, OroCRM and OroPlatform, which is no longer maintained. Read version 5.1 (the latest LTS version) of the Oro documentation to get up-to-date information.

See our Release Process documentation for more information on the currently supported and upcoming releases.

ApiAccessor

Abstraction of api access point. This class is by design to be initiated from the server configuration.

The following example of configuration provided on the server is a sample usage of api_accessor with a full set of options provided(except route_parameters_rename_map):

 1 save_api_accessor:
 2     route: orocrm_opportunity_task_update # for example this route uses following mask
 3                         # to generate url /api/opportunity/{opportunity_id}/tasks/{id}
 4     http_method: POST
 5     headers:
 6         Api-Secret: ANS2DFN33KASD4F6OEV7M8
 7     default_route_parameters:
 8         opportunity_id: 23
 9     action: patch
10     query_parameter_names: [action]

Then the following code on the client:

1 var apiAP = new ApiAccessror(serverConfiguration);
2 apiAP.send({id: 321}, {name: 'new name'}).then(function(result) {
3     console.log(result)
4 })

Will raise POST request to /api/opportunity/23/tasks/321?action=patch with body == {name: ‘new name’} and will put response to console after completion

Extends BaseClass:

Param

Type

Description

options

Object

Options container

options.route

string

Required. Route name

options.http_method

string

Http method to access this route (e.g., GET/POST/PUT/PATCH. By default ‘GET’.

options.form_name

string

Optional. Wraps the request body into a form_name, so request will look like {<form_name>:<request_body>}

options.headers

Object

Optional. Allows to provide additional http headers

options.default_route_parameters

Object

Optional. Provides default parameters for route, this defaults will be merged the urlParameters to get url

options.route_parameters_rename_map`

Object

Optional. Allows to rename incoming parameters, which came into send() function, to proper names. Please provide here an object with following structure: {<old-name>: <new-name>, …}

options.query_parameter_names

Array.&lt;string&gt;

Optional. Array of parameter names to put into query string (e.g. ?<parameter-name>=<value>&<parameter-name>=<value>). (The reason of adding this argument is that FOSRestBundle doesn’t provides acceptable query parameters for client usage, so it is required to specify list of them)

apiAccessor.initialize(options)

Kind: instance method of ApiAccessor

Param

Type

Description

options

Object

passed to the constructor

apiAccessor.isCacheAllowed() ⇒ boolean

Returns true if selected HTTP_METHOD allows caching

Kind: instance method of ApiAccessor

apiAccessor.clearCache()

Clears response cache

Kind: instance method of ApiAccessor

apiAccessor.validateUrlParameters(urlParameters) ⇒ boolean

Validates url parameters

Kind: instance method of ApiAccessor Returns: boolean - true, if parameters are valid and route url can be built

Param

Type

Description

urlParameters

Object

Url parameters to compose the url

apiAccessor.send(urlParameters, body, headers, options) ⇒ $.Promise

Sends request to the server and returns $.Promise instance with abort() support

Kind: instance method of [ApiAccessor](#module_ApiAccessor) Returns: $.Promise - - $.Promise instance with abort() support

Param

Type

Description

urlParameters

Object

Url parameters to compose the url

body

Object

Request body

headers

Object

Headers to send with the request

options

Object

Additional options

options.processingMessage

string

Shows notification message while request is going

options.preventWindowUnload

boolean &#124; string

Prevent window from being unloaded without user confirmation until request is finished. If true provided - page unload will be prevented with default message. If string provided - please describe change in it. This string will be added to list on changes.Default message will be like: Server is being updated and the following changes might be lost:{messages list, each on new line}

apiAccessor._makeAjaxRequest(options)

Makes Ajax request or returns result from cache

Kind: instance method of [ApiAccessor](#module_ApiAccessor) Access: protected

Param

Type

Description

options

Object

options to pass to ajax call

apiAccessor.hashCode(url) ⇒ string

Returns hash code of url

Kind: instance method of [ApiAccessor](#module_ApiAccessor)

Param

Type

url

string

apiAccessor.isCacheExistsFor(urlParameters)

Returns true if data is cached for concrete urlParameters

Kind: instance method of [ApiAccessor](#module_ApiAccessor) Access: protected

Param

Type

Description

urlParameters

Object

url parameters to check

apiAccessor.getHeaders(headers) ⇒ Object

Prepares headers for the request.

Kind: instance method of [ApiAccessor](#module_ApiAccessor)

Param

Type

Description

headers

Object

Headers to merge into the default list

apiAccessor.prepareUrlParameters(urlParameters) ⇒ Object

Prepares url parameters before the url build

Kind: instance method of [ApiAccessor](#module_ApiAccessor)

Param

urlParameters

apiAccessor.getUrl(urlParameters) ⇒ string

Prepares url for the request.

Kind: instance method of [ApiAccessor](#module_ApiAccessor)

Param

Type

Description

urlParameters

Object

Map of url parameters to use

apiAccessor.formatBody(body) ⇒ Object

Prepares the request body.

Kind: instance method of [ApiAccessor](#module_ApiAccessor)

Param

Type

Description

body

Object

Map of the url parameters to use

apiAccessor.formatResult(response) ⇒ Object

Formats response before it is sent out from this api accessor.

Kind: instance method of [ApiAccessor](#module_ApiAccessor)

Param

Type

response

Object

apiAccessor.getErrorHandlerMessage(options) ⇒ boolean

Returns error handler message attribute from given options

Kind: instance method of [ApiAccessor](#module_ApiAccessor)

Param

options