Physical RFID Reader Setup

Configure and test physical RFID readers on your network

API Endpoint

Endpoint URL

Required Fields:

rfid_code - RFID tag code
location - One of: bramley, quarry_hill, keighley, trailer_1-6, venue
scan_type - Either "entry" or "exit"

Optional Fields:

venue_name - Required if location is "venue"
reader_id - Identifier for the physical reader

Example cURL Request:

curl -X POST https://www.northern-ballet-technical.com/api/functions/processRFIDScan \
  -H "Content-Type: application/json" \
  -d '{
    "rfid_code": "1234567890",
    "location": "bramley",
    "scan_type": "entry",
    "reader_id": "bramley_reader_1"
  }'

Example Python:

import requests

url = "https://www.northern-ballet-technical.com/api/functions/processRFIDScan"
payload = {
    "rfid_code": "1234567890",
    "location": "bramley",
    "scan_type": "entry",
    "reader_id": "bramley_reader_1"
}

response = requests.post(url, json=payload)
print(response.json())

Test Scanner

RFID Code

Location

Scan Type

Reader ID (Optional)

Registered Readers

20 readers

Reader Configuration Guide

Step 1: Configure Reader

Configure your physical RFID reader to POST scan data to the API endpoint. Set the reader's location and scan type in its configuration.

Step 2: Set Location Context

Each reader should be hardcoded with its location (e.g., bramley_reader_1 at Bramley) and whether it's monitoring entry or exit.

Step 3: Test & Deploy

Use the test scanner above to verify the reader is sending data correctly. Multiple readers can operate simultaneously.

Multiple Readers: You can have multiple RFID readers (e.g., 1 at Quarry Hill, 2 at Bramley, 2 at Keighley) working simultaneously. Each reader independently posts scan data to the API endpoint with its own location context. The system automatically determines if equipment is in the correct location and logs all activity.

Response Format: The API returns a JSON response with success, equipment details, scan information, and location status. Use this to provide feedback on the reader's display or trigger alerts.