"color:#8b949e"># macOS
brew install pcsc-lite
pcsctest

"color:#8b949e"># Ubuntu/Debian
sudo apt-get install pcscd pcsc-tools
pcsc_scan

curl"color:#FCD116"> -X "color:#79c0ff;font-weight:bold">POST http://localhost:8000/card/scan \
 "color:#FCD116"> -H "Content-Type: application/json" \
 "color:#FCD116"> -d '{
    "station_id": "TERMINAL-01",
    "doc_number": "A12345678",
    "date_of_birth": "1990-03-15",
    "expiry_date": "2028-11-30"
  }'

const response = await fetch('http://localhost:8000/card/scan', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': 'Bearer drewq_xxxx',
  },
  body: JSON.stringify({
    station_id: 'TERMINAL-01',
    doc_number: 'A12345678',
    date_of_birth: '1990-03-15',
    expiry_date: '2028-11-30',
  }),
});

const data = await response.json();
console.log(data.citizen);

"color:#ff7b72">import requests

resp = requests.post(
    "http://localhost:8000/card/scan",
    headers={"Authorization": "Bearer drewq_xxxx"},
    json={
        "station_id": "TERMINAL-01",
        "doc_number": "A12345678",
        "date_of_birth": "1990-03-15",
        "expiry_date": "2028-11-30",
    }
)
citizen = resp.json()["citizen"]
print(citizen["surname"], citizen["given_names"])

Authorization: Bearer drewq_xxxxxxxxxxxxxxxxxxxxxxxxxxxx

// Minimal TypeScript client
const BASE = process.env.DREWQ_API_URL ?? 'http://localhost:8000';

async function scanCard(params: {
  doc_number: string;
  date_of_birth: string;
  expiry_date: string;
  station_id?: string;
}) {
  const res = await fetch(`${BASE}/card/scan`, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      Authorization: `Bearer ${process.env.DREWQ_API_KEY}`,
    },
    body: JSON.stringify(params),
  });
  if (!res.ok) throw new Error(`API error ${res.status}`);
  return res.json();
}

"color:#ff7b72">import os
"color:#ff7b72">import requests

"color:#ff7b72">class DREWQClient:
    "color:#ff7b72">def __init__("color:#ff7b72">self):
        "color:#ff7b72">self.base = os.environ["DREWQ_API_URL"]
        "color:#ff7b72">self.headers = {
            "Authorization": f"Bearer {os.environ['DREWQ_API_KEY']}"
        }

    "color:#ff7b72">def scan("color:#ff7b72">self, doc_number, dob, expiry, station_id="color:#ff7b72">None):
        "color:#ff7b72">return requests.post(
            f"{">self.base}/card/scan",
            headers="color:#ff7b72">self.headers,
            json={
                "doc_number": doc_number,
                "date_of_birth": dob,
                "expiry_date": expiry,
                "station_id": station_id,
            },
        ).json()

client = DREWQClient()
result = client.scan("A12345678", "1990-03-15", "2028-11-30")