Request URL Format

The HTTP client can access Sybase Unwired Platform services using a specific URL format.

For accessing services directly through Unwired Server without a Relay Server:

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

The domain part of the URL specifies the name of the Sybase Unwired Platform domain where a requested resource is resolved. If the requested domain name does not match a domain registered within Sybase Unwired Platform, Sybase Unwired Platform resolves the requested resource using the default domain.

The resource specified part of the URL represents one of the built-in Sybase Unwired 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 Unwired 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 Sybase Unwired Platform require valid transport credentials unless made over a Sybase Unwired Platform protocol or they explicitly request a public resource (indicated when a resource in the "public" context is requested). Each Sybase Unwired 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.

The resource part of the URL corresponds to a proxy endpoint name (connection type PROXY). The Sybase Unwired 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.