B U S I N E S S   A N A L Y S T   S E R V E R   10.5   R E S T   O V E R V I E W

Using REST to Access Business Analyst Server

Introduction

Web services provide a standard way of exposing objects and methods over the Internet. Representational State Transfer, or REST as it is commonly referred to, is a style of software architecture mainly used in the World Wide Web. REST is a Web services architectural style that accomplishes this simply and effectively by leveraging the same technology that makes the Web browser a useful tool.

Business Analyst Server REST provides a simple, standards-based, and platform-independent Web interface to services hosted by Business Analyst Server. This offers businesses, organizations, and agencies the opportunity to leverage Business Analyst Server's valuable data and powerful analyses in their own network-accessible applications. All services exposed by Business Analyst Server REST are accessible through a set of endpoints for each published service.

Business Analyst Server REST tasks may be executed through the use of HTTP requests. Client HTTP requests, at its most fundamental level, involve constructing and submitting Uniform Resource Identifier (URI) requests through a Web browser, command line, or some other client application/system.

Accessing Business Analyst Server REST Endpoints

When accessing REST, a typical starting point is called a well-known endpoint. In the case of Business Analyst Server REST, it consists of the following base URL:

http://{Business Analyst Server host name}:{6080}/{ArcGIS instance}/REST/services/{Map service with Business Analyst capability}/MapServer/exts/BAServer/{Endpoint name}/execute?{parameters}

Example:

http://localhost:6080/arcgis/rest/services/DefaultMap/MapServer/exts/BAServer/DriveTime/execute?...

All REST endpoints are organized in a hierarchical view with the root accessed with the following URL:

http://{Business Analyst Server host name}:{6080}/{ArcGIS instance}/REST/Login

Example:

http://localhost:6080/ArcGIS/REST/Login

Using Secured Business Analyst Server Web Service

Business Analyst Server REST can be secured. It employs token-based authentication to secure and validate REST requests. A simple understanding of this security model is necessary to submit REST requests to a secured instance of Business Analyst Server. See Using Secured Business Analyst Server Web Services for more information.

Learning More About REST

For more details about understanding ArcGIS REST, see Getting Started with ArcGIS Server REST.