Getting Started with ARTIK Cloud

If you’re new to ARTIK Cloud, there is no shortage of resources to help you get up and running. In addition to the tutorials and SDKs at our documentation site, we recently produced a video that gives a high-level overview of ARTIK Cloud. It demonstrates the simplicity of connecting devices and apps using Rules, as well as building your own Cloud Connectors to connect third-party clouds.

The video is narrated by our lead developer evangelist Jeanine Jue, and is summarized below. Click the links to jump to the corresponding concept in the video.

What is ARTIK Cloud?

ARTIK Cloud is an open data exchange platform for the Internet of Things, designed to accelerate device interoperability and enable new data insights. It comes with extensive APIs, SDKs, and other tools for building connections between applications, devices, and clouds. ARTIK Cloud is device agnostic and scales to all IoT applications, including smart homes, smart cities, and industrial IoT!

Essential tools

Each user has an ARTIK Cloud Account that works on both artik.cloud and developer.artik.cloud. You use this account to log into My ARTIK Cloud and the Developer Dashboard, both web-based interfaces that allow you to utilize different ARTIK Cloud features. On My ARTIK Cloud, you can connect devices to ARTIK Cloud, create Rules, and review, visualize, and export your data in JSON or CSV format.

On the Developer Dashboard, you can create new applications and device types and create Manifests for your device types. See more below!

Messages

ARTIK Cloud supports two types of messages: data-only messages and Actions for devices. Each message type uses its own JSON payload format.

To interpret the contents of messages, developers submit a Manifest that describes the data fields. You can either submit a Simple Manifest or an Advanced Manifest on the Developer Dashboard. A Simple Manifest uses standard fields and Actions, while an Advanced Manifest is fully customizable. Written in Groovy, it has to be approved by the ARTIK Cloud team before you can use it. But don’t worry, we are fast!

Devices and device types

A key concept is the difference between device types and devices. A device type is a category of device that is created by an ARTIK Cloud organization, such as a device manufacturer, on the Developer Dashboard. Each device type is associated with a Manifest.

A device is an instance of a device type. For example, an ARTIK Cloud user can use the interface in My ARTIK Cloud to connect a device called “My Misfit Device” to ARTIK Cloud. This would be an instance of the “Misfit” device type published on ARTIK Cloud.

Rules

ARTIK Cloud Rules are an easy way to create smart device interactions. Using the Developer Dashboard, you can write custom Rules that trigger device Actions based on ARTIK Cloud messages. For example, with a motion sensor and light both connected to ARTIK Cloud, you can write a Rule that causes the lights to turn on when motion is detected. Because ARTIK Cloud is device agnostic, the potential for interoperability is very powerful.

Cloud Connectors

While ARTIK Cloud can accept data from any device, some devices send data to a third-party cloud. For example, Fitbit devices use their own proprietary cloud. The Cloud Connectors feature enables you to connect a third-party cloud (such as Fitbit’s) to ARTIK Cloud and use this as the data source instead of the device itself. An eligible cloud must use OAuth 1 or 2 and include an open API with subscription and notification functionality.

Developer documentation

Our developer documentation features several comprehensive articles especially aimed at new ARTIK Cloud developers.

  • Basics covers key terminology and concepts.
  • Hello, World! walks you through connecting a simulated ARTIK Cloud device that sends and receives data.
  • Authentication describes the OAuth2 flows ARTIK Cloud uses to authenticate users.
  • The Manifest explains in detail how the Manifest works to enable device-agnostic communication, particularly the Advanced Manifest.
  • Connect the data is a series of articles about the available protocols on ARTIK Cloud (and more).

Tutorials

Our tutorials page contains a series of introductory and advanced tutorials, as well as Get Started sample code for several SDKs and communication protocols. Be sure to check out Your first IoT device and Your first web application.

API Console

The API Console allows you to see and test all the APIs, with corresponding JSON responses. You can also use it to retrieve important information such as your user ID and user token.

Device simulator

The ARTIK Cloud Device Simulator is a command-line tool intended to help you send messages to ARTIK Cloud on behalf of any device in the system. Here, Jeanine explains how to set up and start using the device simulator.

Works With

The Works With page lists all the devices and services verified to work with ARTIK Cloud, along with instructions on how to connect them in your account!

Finally, if you still have questions about ARTIK Cloud, read Yujing Wu’s FAQ blog, visit our forum, or send Jeanine an email at developer@artik.cloud. We are here to help!