General

Documentation Index

Fetch the complete documentation index at: https://utilsio.dev/docs/llms.txt

Use this file to discover all available pages before exploring further.

​

Overview

• Base URL: https://utilsio.dev/api/v1
• Authentication: HMAC-SHA256 signatures
• Content Type: application/json

​

Authentication

• Requests originate from your application (not a third party)
• Request data has not been tampered with
• Requests are recent

​

Signing Requirements

​

Signing Logic

${deviceId}-${appId}-${timestamp}${additionalData ? `-${additionalData}` : ""}

• deviceId - The device ID associated with the request
• appId - Your Application ID (from query parameter)
• timestamp - Unix timestamp in seconds (must be within a small allowable skew)
• additionalData - Optional additional data (used for DELETE subscription requests)

​

Timestamp Requirements

• Must be the current Unix timestamp in seconds (not milliseconds).
• Requests with expired or future timestamps are rejected with 401 Unauthorized.

​

CORS Headers

Access-Control-Allow-Origin: <request-origin>
Access-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS
Access-Control-Allow-Headers: Content-Type, X-utilsio-Signature, X-utilsio-Timestamp
Access-Control-Allow-Credentials: true

​

Caching

​

Error Handling

{
  "success": false,
  "error": "Error message"
}