Skip to content
Mike Russell edited this page Aug 12, 2016 · 4 revisions

#Namespace SugarAPI\SDK\Endpoint\

#Interface SugarAPI\SDK\Endpoint\Interfaces\EndpointInterface

##Methods ###setOptions(); Set any options on the Endpoint that are needed to manage the url, data, requests, response any logic really ####Arguments

Name Type Description
$options array An array of options
####Returns
Type Description
---- -----------
self The current Endpoint Object for method chaining

###setData(); Sets the data on the Endpoint Object. This can be either the exact data that will be passed to the Request object, or a shorthand or altered set of data, that is then configured and passed to the Request ####Arguments

Name Type Description
$data array An array of data which will be parsed and passed to the Request
####Returns
Type Description
---- -----------
self The current Endpoint Object for method chaining

###setUrl($url); Set the full URL that the Endpoint submits data to ####Arguments

Name Type Description
$url string The full URL the Endpoint submits data to
####Returns
Type Description
---- -----------
self The current Endpoint Object for method chaining

###setRequest(); Set the Request Object used by the Endpoint ####Arguments

Name Type Description
$Request SugarAPI\SDK\Request\Interfaces\RequestInterface The Request Object that is to be used by the Endpoint
####Returns
Type Description
---- -----------
self The current Endpoint Object for method chaining

###setResponse(ResponseInterface $Response); Set the Response Object used by the Endpoint ####Arguments

Name Type Description
$Request SugarAPI\SDK\Response\Interfaces\ResponseInterface The Response Object that is to be used by the Endpoint
####Returns
Type Description
---- -----------
self The current Endpoint Object for method chaining

###setAuth(); Configure authentication on the Endpoint. In Sugar's REST API, this is used to store just the 'access_token' on the Endpoint, which can then be properly added to the Header of the Request. ####Arguments

Name Type Description
$token mixed The necessary authentication information that needs to be added to the Request
####Returns
Type Description
---- -----------
self The current Endpoint Object for method chaining

###authRequired(); Check if Authentication is required for this API Endpoint ####Returns

Type Description
boolean Whether or not authentication is required for this API Endpoint

###execute(); Execute the Endpoint Object, by sending the fully configured Request to the API Endpoint. ####Returns

Type Description
self The current Endpoint Object for method chaining

###getOptions(); Get the options configured on the Endpoint ####Arguments

Name Type Description
$Request SugarAPI\SDK\Request\Interfaces\RequestInterface The Request Object that is to be used by the Endpoint
####Returns
Type Description
---- -----------
self The current Endpoint Object for method chaining

###getUrl(); @return string
Get the full URL being used by the Endpoint

###getData(); @return mixed
Get the data URL being used by the Endpoint

###getResponse(); @return ResponseInterface
Get the Response Object being used by the Endpoint

###getRequest(); @return RequestInterface
Get the Request Object being used by the Endpoint

Clone this wiki locally