Bind a new device

Binds a new device to the company account.

Returns the deviceid identification token for the new binded device. This deviceid token must be stored in the device in order to later authenticate and communicate with the cloud.

Binds a new device to the company account and returns the deviceid.

POST https://api.runonrufus.com/v0/devices

Headers

Name

Type

Description

api_key*

String

Account api key with WRITE or READ_WRITE access type.

Request Body

Name

Type

Description

model*

String

Device model.

serial_number*

String

Device serial number.

alias

String

Device name or alias.

firmware

String

Device firmware version.

{
    "description":"Device binded succesfully"
    "deviceid":"65A1B7E0C6BC3D32C268C1506E3F6F39E225DC6ED79573E177E7243E8E38115B"
}

curl -X POST \
-H "Content-Type: application/json" \
-H "api_key: ror-ae4fc6c19681a20fad30" \
-d '{"model": "Model X1", "serial_number":"DEVICE-123"}' \
https://api.runonrufus.com/v0/devices

<?php
$url = "https://api.runonrufus.com/v0/devices";

$data = array('model' => 'Model X1', 'serial_number' => 'DEVICE-123');

$options = array(
    'http' => array(
      'method'  => 'POST',
      'content' => json_encode($data),
      'header'=>  "Content-Type: application/json\r\n" .
                  "api_key: ror-ae4fc6c19681a20fad30\r\n" .
                  "Accept: application/json\r\n"
      )
  );
  
$context  = stream_context_create($options);
$result = file_get_contents($url, false, $context);
$response = json_decode($result);
var_dump($response);
?>

fetch("https://api.runonrufus.com/v0/devices", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "api_key": "ror-ae4fc6c19681a20fad30",
    },
    body: JSON.stringify({"model": "Model X1", "serial_number":"DEVICE-123"}),
  })
    .then((response) => console.log(response))
    .catch((error) => console.error(error));

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

namespace HttpClientExample
{
    class Program
    {
        static async Task Main(string[] args)
        {
            var data = new
            {
                model = "Model X1",
                serial_number = "DEVICE-1234"
            };

            using var client = new HttpClient();

            client.DefaultRequestHeaders.Add("Content-Type", "application/json");
            client.DefaultRequestHeaders.Add("api_key", "ror-ae4fc6c19681a20fad30");

            var response = await client.PostAsync(
                "https://api.runonrufus.com/v0/devices",
                new StringContent(
                    Newtonsoft.Json.JsonConvert.SerializeObject(data),
                    Encoding.UTF8,
                    "application/json"
                )
            );
            
            if (response.IsSuccessStatusCode)
            {
                var result = await response.Content.ReadAsStringAsync();

                Console.WriteLine(result);
            }
            else
            {
                Console.WriteLine("Error: " + response.StatusCode);
            }
        }
    }
}

PreviousOverview NextUnbind a device

Last updated 1 year ago

Good evening

hashtagBinds a new device to the company account and returns the deviceid.

hashtagHeaders

hashtagRequest Body

Binds a new device to the company account and returns the deviceid.

Headers

Request Body