RUFUS Help
RUFUS Cloud Public API
RUFUS Cloud Public API
  • Introduction to RUFUS Cloud API
  • Getting Started
    • Overview
    • Get your api keys
    • Api permissions
  • TIMING DEVICES
    • Overview
    • Bind a new device
    • Unbind a device
    • Get devices by company
    • Get device information
  • TIMING SESSIONS
    • Overview
    • Insert a new session
    • Close a session
    • Get sessions by device
    • Get active session from device
    • Get session information
  • RACE PASSINGS
    • Overview
    • Insert passings
    • Get session passings by range
    • Get device passings by datetime
Powered by GitBook
On this page
  1. TIMING DEVICES

Get devices by company

Gets the list of devices from the company.

Get the list of devices from the company.

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

Headers

Name
Type
Description

api_key*

String

Account api key with READ or READ_WRITE access type.

{
    "description": "Success",
    "result": [
      {
        "deviceid": "1C3A38059155C47209E1D65E076CD3F09210B22D02B079F231A6D4D534282D56",
        "type": "One4All",
        "model": "One4All 5 PRO",
        "alias": "Finish and start",
        "firmware": "1.0.1",
        "serial_number": "O4A-00150",
        "last_seen": null,
        "creation_date": "2023-02-02T11:59:02.000Z",
        "sessions": 0
      },
      {
        "deviceid": "786E082E0A9FF288082463E21C897FB99C1E04B458C19A281337A346FC4083A0",
        "type": "My custom device",
        "model": "2023",
        "alias": "My badass timing system",
        "firmware": null,
        "serial_number": "X1",
        "last_seen": "2023-02-03T15:45:15.000Z",
        "creation_date": "2023-02-02T12:10:13.000Z",
        "sessions": 2
      },
      {
        "deviceid": "920D445EA56150F09400AA21CBDCBB85B862807D1BAE9A86AFB6C303AE0006CB",
        "type": "Android App",
        "model": "RUFUS Timing App",
        "alias": "Manual checkpoint Raul",
        "firmware": null,
        "serial_number": "ae75de2678e6ee2d",
        "last_seen": "2023-02-03T16:04:26.000Z",
        "creation_date": "2023-02-02T12:11:25.000Z",
        "sessions": 3
      }
    ]
  }

{
    description: "Devices not found",
}
curl -X GET \
-H "Content-Type: application/json" \
-H "api_key: ror-ae4fc6c19681a20fad30" \
https://api.runonrufus.com/v0/devices
<?php
$url = "https://api.runonrufus.com/v0/devices";

$options = array(
    'http' => array(
      'method'  => 'GET',
      '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: "GET",
    headers: {
      "Content-Type": "application/json",
      "api_key": "ror-ae4fc6c19681a20fad30",
    },
  })
    .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)
        {
            using var client = new HttpClient();

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

            var response = await client.GetAsync(
                "https://api.runonrufus.com/v0/devices",
            );
            
            if (response.IsSuccessStatusCode)
            {
                var result = await response.Content.ReadAsStringAsync();

                Console.WriteLine(result);
            }
            else
            {
                Console.WriteLine("Error: " + response.StatusCode);
            }
        }
    }
}
PreviousUnbind a deviceNextGet device information

Last updated 2 years ago