Text API

Quick Guide

Prerequisites

Make sure you have retrieved and saved your API key in the Dot. App;
Make sure you own at least one device and have obtained its device serial number;
Make sure your device is connected to power;
Make sure your device is connected to the network;
Make sure the device has added the Text API content.

API requests are not limited by the app's minimum 5-minute device interval. The API rate limit is 1 request per second. With the API, you can control device behavior and responses more flexibly.

Placeholders wrapped in ‘{{variable}}’ indicate values you must replace. Fill them with your actual values and remove the ‘{{}}’ braces.

Request Examples

curl -X POST \
  https://dot.mindreset.tech/api/open/text \
  -H 'Authorization: Bearer {{API_KEY}}' \
  -H 'Content-Type: application/json' \
  -d '{
    "refreshNow": {{show content immediately}},
    "deviceId": "{{device serial number}}",
    "title": "{{title}}",
    "message": "{{content}}",
    "signature": "{{signature}}",
    "icon": "{{base64-encoded PNG icon data}}",
    "link": "{{NFC tap redirect link}}"
  }'

import requests

url = "https://dot.mindreset.tech/api/open/text"
headers = {
    "Authorization": "Bearer {{API_KEY}}",
    "Content-Type": "application/json"
}
data = {
    "refreshNow": {{show content immediately}},
    "deviceId": "{{device serial number}}",
    "title": "{{title}}",
    "message": "{{content}}",
    "signature": "{{signature}}",
    "icon": "{{base64-encoded PNG icon data}}",
    "link": "{{NFC tap redirect link}}"
}
response = requests.post(url, json=data, headers=headers)
print(response.json())

fetch("https://dot.mindreset.tech/api/open/text", {
  method: "POST",
  headers: {
    "Authorization": "Bearer {{API_KEY}}",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    refreshNow: {{show content immediately}},
    deviceId: "{{device serial number}}",
    title: "{{title}}",
    message: "{{content}}",
    signature: "{{signature}}",
    icon: "{{base64-encoded PNG icon data}}",
    link: "{{NFC tap redirect link}}"
  })
}).then(res => res.json()).then(console.log);

type ApiResponse = {
  code: number;
  message: string;
  result?: any;
};

fetch("https://dot.mindreset.tech/api/open/text", {
  method: "POST",
  headers: {
    "Authorization": "Bearer {{API_KEY}}",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    refreshNow: {{show content immediately}},
    deviceId: "{{device serial number}}",
    title: "{{title}}",
    message: "{{content}}",
    signature: "{{signature}}",
    icon: "{{base64-encoded PNG icon data}}",
    link: "{{NFC tap redirect link}}"
  })
})
  .then(res => res.json() as Promise<ApiResponse>)
  .then(data => {
    console.log(data);
  });

package main

import (
  "bytes"
  "encoding/json"
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://dot.mindreset.tech/api/open/text"
  payload := map[string]interface{}{
    "refreshNow": {{show content immediately}},
    "deviceId": "{{device serial number}}",
    "title": "{{title}}",
    "message": "{{content}}",
    "signature": "{{signature}}",
    "icon": "{{base64-encoded PNG icon data}}",
    "link": "{{NFC tap redirect link}}",
  }
  body, _ := json.Marshal(payload)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(body))
  req.Header.Set("Authorization", "Bearer {{API_KEY}}")
  req.Header.Set("Content-Type", "application/json")
  client := &http.Client{}
  resp, _ := client.Do(req)
  defer resp.Body.Close()
  respBody, _ := ioutil.ReadAll(resp.Body)
  fmt.Println(string(respBody))
}

use reqwest::blocking::Client;
use serde_json::json;

fn main() {
    let client = Client::new();
    let url = "https://dot.mindreset.tech/api/open/text";
    let res = client.post(url)
        .header("Authorization", "Bearer {{API_KEY}}")
        .header("Content-Type", "application/json")
        .json(&json!({
            "refreshNow": {{show content immediately}},
            "deviceId": "{{device serial number}}",
            "title": "{{title}}",
            "message": "{{content}}",
            "signature": "{{signature}}",
            "icon": "{{base64-encoded PNG icon data}}",
            "link": "{{NFC tap redirect link}}"
        }))
        .send()
        .unwrap()
        .text()
        .unwrap();
    println!("{}", res);
}

Response Example

{
	"code": 200,
	"message": "Device Text API content switched",
	"result": {
		"message": "Device ABCD1234ABCD Text API content switched"
	}
}

Reference Usage

Simple text without immediate display

curl -X POST \
  https://dot.mindreset.tech/api/open/text \
  -H 'Authorization: Bearer dot_app_UlSpzXNEXhYZIAFakHLCkMVVBLbsBIWxaRMVaJZGUOYKhDoDRZwLLvLujAIwQxbY' \
  -H 'Content-Type: application/json' \
  -d '{
    "refreshNow": false,
    "deviceId": "ABCD1234ABCD",
    "title": "evnydd0sf",
    "message": "我能吞下玻璃而不伤身体"
  }'

Complex text and display immediately

curl -X POST \
  https://dot.mindreset.tech/api/open/text \
  -H 'Authorization: Bearer dot_app_UlSpzXNEXhYZIAFakHLCkMVVBLbsBIWxaRMVaJZGUOYKhDoDRZwLLvLujAIwQxbY' \
  -H 'Content-Type: application/json' \
  -d '{
    "deviceId": "ABCD1234ABCD",
    "title": "验证码小助手",
    "message": "一个来自「少数派」的验证码\n205112",
    "signature": "2025年8月4日 19:58"
  }'

Complex text with icon and link, display immediately

curl -X POST \
  https://dot.mindreset.tech/api/open/text \
  -H 'Authorization: Bearer dot_app_UlSpzXNEXhYZIAFakHLCkMVVBLbsBIWxaRMVaJZGUOYKhDoDRZwLLvLujAIwQxbY' \
  -H 'Content-Type: application/json' \
  -d '{
    "deviceId": "ABCD1234ABCD",
    "title": "每日健康",
    "message": "消耗卡路里：702千卡\n今日步数：4183步\n站立时间：62分钟",
    "signature": "2025年8月4日 20:16",
    "icon": "{{base64-encoded PNG image data}}",
    "link": "x-apple-health://"
  }'

Highly customized text or graphics

Refer to the Image API section on text-as-image usage

Troubleshooting

Endpoint

/api/authV2/open/device/text

Method

POST

Request Schema

Field	Type	Required	Default	Description	Purpose
`refreshNow`	`bool`	No	`true`	Whether to display the content immediately	Control display timing
`deviceId`	`string`	Yes		Device serial number	Identify the device
`title`	`string`	No		Text title	Title shown on screen
`message`	`string`	No		Text content	Content shown on screen
`signature`	`string`	No		Text signature	Signature shown on screen
`icon`	`string`	No		Base64-encoded PNG icon data (40px×40px)	Icon shown at bottom-left
`link`	`string`	No		http/https link or URL scheme	NFC tap redirect target

Response Schema

Field	Type	Description
`code`	`number`	Status code
`message`	`string`	Message
`result`	`object`	Payload

Status Codes

code	Meaning	Description
`200`	Success	Text API content switched / Data updated but content not switched
`400`	Invalid parameters	Invalid icon format
`403`	Forbidden	You do not have permission to operate this device
`404`	Not found	Device not found or not registered Text API content not added
`500`	Device response failure	Failed to switch Text API content

Quick Guide

Prerequisites

Make sure you have retrieved and saved your API key in the Dot. App;
Make sure you own at least one device and have obtained its device serial number;
Make sure your device is connected to power;
Make sure your device is connected to the network;
Make sure the device has added the Text API content.

API requests are not limited by the app's minimum 5-minute device interval. The API rate limit is 1 request per second. With the API, you can control device behavior and responses more flexibly.

Placeholders wrapped in ‘{{variable}}’ indicate values you must replace. Fill them with your actual values and remove the ‘{{}}’ braces.

Request Examples

curl -X POST \
  https://dot.mindreset.tech/api/open/text \
  -H 'Authorization: Bearer {{API_KEY}}' \
  -H 'Content-Type: application/json' \
  -d '{
    "refreshNow": {{show content immediately}},
    "deviceId": "{{device serial number}}",
    "title": "{{title}}",
    "message": "{{content}}",
    "signature": "{{signature}}",
    "icon": "{{base64-encoded PNG icon data}}",
    "link": "{{NFC tap redirect link}}"
  }'

import requests

url = "https://dot.mindreset.tech/api/open/text"
headers = {
    "Authorization": "Bearer {{API_KEY}}",
    "Content-Type": "application/json"
}
data = {
    "refreshNow": {{show content immediately}},
    "deviceId": "{{device serial number}}",
    "title": "{{title}}",
    "message": "{{content}}",
    "signature": "{{signature}}",
    "icon": "{{base64-encoded PNG icon data}}",
    "link": "{{NFC tap redirect link}}"
}
response = requests.post(url, json=data, headers=headers)
print(response.json())

fetch("https://dot.mindreset.tech/api/open/text", {
  method: "POST",
  headers: {
    "Authorization": "Bearer {{API_KEY}}",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    refreshNow: {{show content immediately}},
    deviceId: "{{device serial number}}",
    title: "{{title}}",
    message: "{{content}}",
    signature: "{{signature}}",
    icon: "{{base64-encoded PNG icon data}}",
    link: "{{NFC tap redirect link}}"
  })
}).then(res => res.json()).then(console.log);

type ApiResponse = {
  code: number;
  message: string;
  result?: any;
};

fetch("https://dot.mindreset.tech/api/open/text", {
  method: "POST",
  headers: {
    "Authorization": "Bearer {{API_KEY}}",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    refreshNow: {{show content immediately}},
    deviceId: "{{device serial number}}",
    title: "{{title}}",
    message: "{{content}}",
    signature: "{{signature}}",
    icon: "{{base64-encoded PNG icon data}}",
    link: "{{NFC tap redirect link}}"
  })
})
  .then(res => res.json() as Promise<ApiResponse>)
  .then(data => {
    console.log(data);
  });

package main

import (
  "bytes"
  "encoding/json"
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {
  url := "https://dot.mindreset.tech/api/open/text"
  payload := map[string]interface{}{
    "refreshNow": {{show content immediately}},
    "deviceId": "{{device serial number}}",
    "title": "{{title}}",
    "message": "{{content}}",
    "signature": "{{signature}}",
    "icon": "{{base64-encoded PNG icon data}}",
    "link": "{{NFC tap redirect link}}",
  }
  body, _ := json.Marshal(payload)
  req, _ := http.NewRequest("POST", url, bytes.NewBuffer(body))
  req.Header.Set("Authorization", "Bearer {{API_KEY}}")
  req.Header.Set("Content-Type", "application/json")
  client := &http.Client{}
  resp, _ := client.Do(req)
  defer resp.Body.Close()
  respBody, _ := ioutil.ReadAll(resp.Body)
  fmt.Println(string(respBody))
}

use reqwest::blocking::Client;
use serde_json::json;

fn main() {
    let client = Client::new();
    let url = "https://dot.mindreset.tech/api/open/text";
    let res = client.post(url)
        .header("Authorization", "Bearer {{API_KEY}}")
        .header("Content-Type", "application/json")
        .json(&json!({
            "refreshNow": {{show content immediately}},
            "deviceId": "{{device serial number}}",
            "title": "{{title}}",
            "message": "{{content}}",
            "signature": "{{signature}}",
            "icon": "{{base64-encoded PNG icon data}}",
            "link": "{{NFC tap redirect link}}"
        }))
        .send()
        .unwrap()
        .text()
        .unwrap();
    println!("{}", res);
}

Response Example

{
	"code": 200,
	"message": "Device Text API content switched",
	"result": {
		"message": "Device ABCD1234ABCD Text API content switched"
	}
}

Reference Usage

Simple text without immediate display

curl -X POST \
  https://dot.mindreset.tech/api/open/text \
  -H 'Authorization: Bearer dot_app_UlSpzXNEXhYZIAFakHLCkMVVBLbsBIWxaRMVaJZGUOYKhDoDRZwLLvLujAIwQxbY' \
  -H 'Content-Type: application/json' \
  -d '{
    "refreshNow": false,
    "deviceId": "ABCD1234ABCD",
    "title": "evnydd0sf",
    "message": "我能吞下玻璃而不伤身体"
  }'

Complex text and display immediately

curl -X POST \
  https://dot.mindreset.tech/api/open/text \
  -H 'Authorization: Bearer dot_app_UlSpzXNEXhYZIAFakHLCkMVVBLbsBIWxaRMVaJZGUOYKhDoDRZwLLvLujAIwQxbY' \
  -H 'Content-Type: application/json' \
  -d '{
    "deviceId": "ABCD1234ABCD",
    "title": "验证码小助手",
    "message": "一个来自「少数派」的验证码\n205112",
    "signature": "2025年8月4日 19:58"
  }'

Complex text with icon and link, display immediately

curl -X POST \
  https://dot.mindreset.tech/api/open/text \
  -H 'Authorization: Bearer dot_app_UlSpzXNEXhYZIAFakHLCkMVVBLbsBIWxaRMVaJZGUOYKhDoDRZwLLvLujAIwQxbY' \
  -H 'Content-Type: application/json' \
  -d '{
    "deviceId": "ABCD1234ABCD",
    "title": "每日健康",
    "message": "消耗卡路里：702千卡\n今日步数：4183步\n站立时间：62分钟",
    "signature": "2025年8月4日 20:16",
    "icon": "{{base64-encoded PNG image data}}",
    "link": "x-apple-health://"
  }'

Highly customized text or graphics

Refer to the Image API section on text-as-image usage

Field	Type	Required	Default	Description	Purpose
`refreshNow`	`bool`	No	`true`	Whether to display the content immediately	Control display timing
`deviceId`	`string`	Yes		Device serial number	Identify the device
`title`	`string`	No		Text title	Title shown on screen
`message`	`string`	No		Text content	Content shown on screen
`signature`	`string`	No		Text signature	Signature shown on screen
`icon`	`string`	No		Base64-encoded PNG icon data (40px×40px)	Icon shown at bottom-left
`link`	`string`	No		http/https link or URL scheme	NFC tap redirect target

Response Schema

Field	Type	Description
`code`	`number`	Status code
`message`	`string`	Message
`result`	`object`	Payload

Status Codes

code	Meaning	Description
`200`	Success	Text API content switched / Data updated but content not switched
`400`	Invalid parameters	Invalid icon format
`403`	Forbidden	You do not have permission to operate this device
`404`	Not found	Device not found or not registered Text API content not added
`500`	Device response failure	Failed to switch Text API content

Quick Guide

Prerequisites

Request Examples

Response Example

Reference Usage

Troubleshooting

Endpoint

Method

Request Schema

Response Schema

Status Codes

Contents

Text API

Quick Guide

Prerequisites

Request Examples

Response Example

Reference Usage

Troubleshooting

Endpoint

Method

Request Schema

Response Schema

Status Codes

Contents