Working with services you've published
The ArcGIS REST API, short for Representational State Transfer, provides a simple, open Web interface to ArcGIS. A major portion of the API, described in this section of the help, allows access to services hosted by ArcGIS Server.
All resources and operations exposed by the REST API are accessible through a hierarchy of endpoints or Uniform Resource Locators (URLs) for each GIS service published with ArcGIS Server. When using the ArcGIS services portion of the REST API, you typically start from a well-known endpoint, which represents the server catalog. See the Resource hierarchy to learn about how the services in the REST API fit together under the catalog.
The default REST endpoint for an ArcGIS Server site is:
http://<host>:/argis/rest/services
For example, to get to the root directory of ArcGIS Online services, the URL is:
http://server.arcgisonline.com/arcgis/rest/services
From this base URL, you can traverse to any of the listed service and resources and operations associated with the service.
The REST API is stateless, which means that REST does not keep track of transactions from one request to the next. Each request must contain all the information necessary for successful processing.
Getting Started
If you want to learn more about how the REST API works, you can start by following the examples in Getting Started.
Services Directory
Each ArcGIS Server site comes with a Services Directory. Services Directory is a view of your available REST resources and operations in HTML format. You can browse the contents of an ArcGIS Server site and obtain information such as service metadata and supported operations that can be useful in developing applications.
Resources and Operations
The REST API has some level of support for each of the ArcGIS Server service types. Each service is a resource and has a unique URL. Although a REST system always returns only representations of resources to the clients, for the sake of simplicity, the resources of the ArcGIS REST API are divided into two types: resources and operations. For more information, see Resources and Operations.
The supported service types that include operations are map, geocode, geoprocessing, geometry, feature, network and image. Another set of service types that are supported as resources but have no associated operations include mobile, geodata, and globe services.
Output Formats
The REST API supports responses in several formats. The format is specified by using the query parameter f in the URL. The list of supported formats includes html (HyperText Markup Language), json (JavaScript Object Notation), image, kmz (compressed KML, or Keyhole Markup Language), help, lyr (layer file), nmf (ArcGIS Explorer map file), amf (Action Message Format) and jsapi (JavaScript). For more details, see Output formats.
KML Support
You can request KML in several different ways, which is summarized in KML support.
Versioning
As the REST API evolves over time, different versions of the API will become available. For information on the rules of versioning, see REST API Versioning
REST API Administration
In addition to being a browser for your published data, Services Directory also provides access to an administrative console. The administration page is needed to refresh the site after adding, deleting, and updating services or after updating to a new version of the REST API. Services Directory can also be disabled through the console. For more information, see REST API Admin.