Request URL Format

The HTTP client can access SAP Mobile Platform services using a specific URL format.

For accessing services directly through SAP Mobile Server without a Relay Server:

http://host:port/[public/]/{resource}/{resource-specific}

Host is defined by host name and should match with the domain registered with SAP Mobile Platform. If the requested domain name does not match, default domain will be used.

The resource represents one of the built-in SAP Mobile Platform services for managing application registration, settings, or customization resource bundles, or one of the configured Proxy Connection endpoints.

The resource-specific part of the URL specifies the actual resource being referenced.

For accessing services where a Relay Server is configured with the SAP Mobile Server, the URL you use depends on whether Relay Server is installed on an IIS or Apache host.

For an IIS host:

http://{RelayServerName}:80/ias_relay_server/client/rs_client.dll/{Unwired Server Farm ID}/[public/]/{ProxyName}

For an Apache host:

http://{RelayServerName}:80/cli/iasrelayserver/{Unwired Server Farm ID}/[public/]/{ProxyName}

Requests to SAP Mobile Platform require valid transport credentials unless made over a SAP Mobile Platform protocol (Messaging-based synchronization and its Java implementation) or they explicitly request a public resource (indicated when a resource in the "public" context is requested). Each SAP Mobile Platform domain can authenticate requests by using a default security configuration. If a domain has no default security configuration defined, the default security configuration, "admin," is used to authenticate the request.

By explicitly setting the HTTP headers, you can override the domain used to resolve the targeted endpoint, as well as the security configuration used to authenticate a request. For more information, see HTTP Headers and Cookies.

The resource part of the URL corresponds to a proxy endpoint name (connection type PROXY). The SAP Mobile Platform Proxy component handles any request made towards a configured Proxy Connection Endpoint and later forwards the request to the URL specified in the connection template.