Nodes

A Node is a single physical touchpoint. It has a unique slug (e.g., o1ulpplq), a permanent scan URL (nearnode.io/v/o1ulpplq), and a configurable function type that determines what happens when someone scans it.

Lifecycle

Every node moves through a lifecycle. Status transitions are tracked and logged.

Status	Description
`draft`	Created but not yet written to hardware
`in_production`	Written to a tag/chip but not yet deployed in the field
`active`	Live and serving scans
`paused`	Temporarily disabled — scans return a 404
`lost`	Tag is reported lost or stolen (kill switch activated)
`retired`	Permanently decommissioned

The transition from draft → active happens automatically when you write and lock a tag via the NFC Writer.

Function Types

The function_type field determines how a scan is handled:

Redirect
vCard
WiFi
Action
Microsite

The simplest type. Scans redirect (HTTP 307) to a destination URL.

{
  "function_type": "redirect",
  "payload": {
    "url": "https://acme.com/welcome"
  }
}

Serves a downloadable contact card (.vcf file). The scanner’s phone prompts “Add to Contacts”.

{
  "function_type": "vcard",
  "payload": {
    "first_name": "James",
    "last_name": "Page",
    "organization": "VidiaI",
    "phone": "+41791234567",
    "email": "james@vidiai.ch"
  }
}

Renders a WiFi connection page with one-tap connect.

{
  "function_type": "wifi",
  "payload": {
    "ssid": "Office-Guest",
    "password": "welcome2026",
    "security": "WPA2"
  }
}

Direct-to-action triggers — WhatsApp, Calendly, email, phone call.

{
  "function_type": "action",
  "payload": {
    "action_type": "whatsapp",
    "phone": "+41791234567",
    "message": "Hi, I scanned your tag!"
  }
}

Supported action types: whatsapp, calendly, email, phone, url.

Routing Rules

Each node can have multiple routing rules evaluated in priority order. Rules enable:

A/B Testing

Split traffic between page variants and measure conversion.

Time-Based

Different destinations for office hours vs. after-hours.

Geo-Targeting

Route DACH region to German content, rest of world to English.

Device Routing

Mobile users get the app store, desktop users get the website.

Getting Started

Core Features

Developer Console

Enterprise Governance

Lifecycle

Function Types

Routing Rules

A/B Testing

Time-Based

Geo-Targeting

Device Routing

Getting Started

Core Features

Developer Console

Enterprise Governance

​Lifecycle

​Function Types

​Routing Rules

A/B Testing

Time-Based

Geo-Targeting

Device Routing

Lifecycle

Function Types

Routing Rules