Fleet Connectivity Extension API Developer's Guide

sendjob

Use the resource sendjob to send a job message to a mobile asset using the Fleet Connectivity Extension API. This resource supports both POST and GET requests. For more information on the Fleet Connectivity Extension API, see Fleet Connectivity Extension API Ecosystem.

For information on the expected structure of the POST body, see Job Request Body.

Note: HERE recommends that you follow standard REST paradigms where possible and that you use the POST method to send job request messages to the Fleet Connectivity Extension API Web Service. For convenience, when using the Fleet Connectivity Extension API API in a pure JavaScript environment, the resource sendjob supports the request parameter job with the GET method, allowing you to send a job request as a parameter.

Resource URI

The pattern for requests to the resource is base-url/1/sendjob.json?<parameter>=<value>. For more information, see Constructing a Request.

Resource Parameters

Parameter Type Mandatory Description
app_id string Y

Typically, but not guaranteed to be, 20 bytes Base64 URL-safe encoded string used for the authentication of the client application. See Acquiring Credentials.

app_code string Y

Typically, but not guaranteed to be, 20 bytes Base64 URL-safe encoded string used for the authentication of the client application. See Acquiring Credentials.

callback string N

Specifies the name of a user-defined function used to wrap the JSON response. Required for JSONP requests.

Default: No JSONP response wrapper

job string Y

URL-escaped JSON message. Either a GET request passes the message in this parameter or a multi-part POST body passes it as its only part.

Response

This resource returns a response with the POST body element job_id.
{
  job_id: "12345"
}