<commit_before><commit_msg>API concept topic and consistency checks #507<commit_after>---

copyright:
years: 2017
lastupdated: "2017-01-17"

---

{:new_window: target="blank"}
{:shortdesc: .shortdesc}
{:screen: .screen}
{:codeblock: .codeblock}
{:pre: .pre}

# APIs
{: #overview}

{{site.data.keyword.iot_full}} provides a set of application programming interfaces (APIs) which are implemented based on Representational State Transfer (REST) services. The APIs enable applications to use the same interface to interact with {{site.data.keyword.iot_short_notm}}, regardless of the language in which the application is written. An HTTP status code is used to indicate the success or failure of the operation.

Use the following links to find out more about the REST APIs that are provided by {{site.data.keyword.iot_short_notm}}:

### IBM Watson IoT Platform HTTP REST APIs
{: #IoTP_rest_api}
To access the Watson IoT Platform HTTP REST API and obtain more information about how to build and customize devices that interact with your organization on {{site.data.keyword.iot_short_notm}}, go to [IBM Watson IoT Platform HTTP REST API](https://docs.internetofthings.ibmcloud.com/swagger/v0002.html).

For more information, see [Getting started with Watson IoT Platform](../index.html) and [HTTP REST API for devices](../devices/api.html).

### IBM Watson IoT Platform HTTP Messaging APIs
{: #Messaging_api}
To access the Watson IoT Platform HTTP Messaging API and obtain more information about how to build and customize your applications, go to [IBM Watson IoT Platform HTTP Messaging API](https://docs.internetofthings.ibmcloud.com/swagger/http-messaging.html).

For more information about the capabilities and functions that are supported, see [HTTP REST API for applications](../applications/api.html) and [HTTP REST API for devices](../devices/api.html).

### Gateway Access Control HTTP REST APIs (Beta)
{: #GAC_rest_api}
To access the gateway access control HTTP REST API and obtain more information about how to configure gateway devices, go to [IBM Watson IoT API - Limited Gateway Beta](https://docs.internetofthings.ibmcloud.com/swagger/limited-gateway.html).

For more information, see [Gateway Access Control (BETA)](../gateways/gateway-access-control.html).

### Interface Mapping HTTP REST APIs (Beta)
{: #IM_rest_api}
To access the interface mapping HTTP REST API and obtain more information about how to start mapping your device data by using interfaces, go to [IBM Watson IoT Platform HTTP REST API](https://docs.internetofthings.ibmcloud.com/swagger/info-mgmt-beta.html).

For more information, see [Using interfaces to map device data (Beta)](../information_management/im_index.html).
{'fraction_non_alphanumeric': 0.09366901147723065, 'fraction_numerical': 0.007034431691965938, 'mean_word_length': 5.113122171945701, 'pattern_counts': {'":': 0, '<': 3, '<?xml version=': 0, '>': 3, 'https://': 4, 'lorem ipsum': 0, 'www.': 0, 'xml': 0}, 'pii_count': 0, 'substrings_counts': 0, 'word_list_counts': {'cursed_substrings.json': 0, 'profanity_word_list.json': 0, 'sexual_word_list.json': 0, 'zh_pornsignals.json': 0}}
{'dir': 'git-commits-cleaned', 'id': '1346398', 'n_tokens_mistral': 780, 'n_tokens_neox': 710, 'n_words': 313}