API v1 is deprecated

01Deprecation timeline

v1 keeps serving traffic until sunset, but it receives no new features — only critical security patches.

1. 17 Oct 2026

   Deprecation announced

   v1 is frozen. Deprecation, Sunset and Link headers are added to every v1 response. New catalog fields (firmware channels, ICE ratings) are exposed in v2 only.

2. 01 Dec 2026

   No new v1 API keys

   The developer dashboard stops issuing v1 keys. Existing keys keep working. New integrations must use v2 OAuth clients.

3. 02 Dec 2026 · 14:00–15:00 UTC

   Brownout #1 — 1 hour

   All v1 endpoints return 410 Gone for one hour so you can detect hidden dependencies in your stack.

4. 13 Jan 2027 · 14:00–18:00 UTC

   Brownout #2 — 4 hours

   Same behaviour, longer window. If anything breaks here, it will break for good on sunset day.

5. 31 Jan 2027 · 23:59 UTC

   Sunset — v1 flatlines

   v1 is permanently shut down. Every request returns 410 Gone with an application/problem+json body pointing to v2. All v1 API keys are revoked.

02Why v2 is better chrome

v2 was rebuilt around how cyberware is actually sold, installed and maintained — not just listed.

03Breaking changes

v2 is not a drop-in replacement. These are the changes most likely to break an existing integration.

04Endpoint mapping

Every v1 endpoint and its v2 replacement. Paths are relative to https://cyber-punk.online.

05Cyberware data model

v2 exposes the full technical profile of every implant in the catalog. Here is what each spec field means.

neuralLoad · int 0–100

Neural Load Index (NLI): how much of the nervous system's processing headroom the implant consumes. A standard client has a budget of 100; stacks above 85 trigger a warning, above 100 are rejected.

interfaceBus · enum

Neural link bus generation: NL-3 (legacy, flagged legacy: true), NL-4 (current standard) and NL-5 (high-bandwidth, required for full-sensory implants).

powerDrawMw · int

Continuous draw in milliwatts from the client's subdermal bio-cell. The default power budget is 1,200 mW; the compatibility engine warns under 20% headroom.

bioRejectionRisk · enum

low · moderate · high. Derived from material biocompatibility and the client's immunosuppressant profile when one is supplied.

surgeryClass · A–D

A: non-invasive / outpatient. B: minor invasive. C: spinal or cranial. D: full-limb or full-body replacement. Clinics can only book classes they are certified for.

firmware · object

Current version, release channel and otaSupported flag. Images are signed with Ed25519; always verify before flashing.

iceRating · int 1–5

Security-class implants only. Tier of intrusion countermeasures (ICE) protecting the neural port against unauthorized access.

compatibleWith · string[]

Interface buses the implant can run on, with adapters where applicable. Use it to pre-filter catalog results.

Implant categories

{
  "id": 1042,
  "product_name": "KX-7 Ocular Overlay",
  "price": "2499.00",
  "neural_load": "18",
  "in_stock": 1,
  "updated": 1792228200
}

{
  "data": {
    "sku": "KSL-OCU-KX7",
    "name": "KX-7 Ocular Overlay",
    "category": "ocular",
    "manufacturer": "Kessler Neuroworks",
    "price": { "amount": 249900, "currency": "EUR" },
    "stock": { "status": "in_stock", "quantity": 14 },
    "specs": {
      "interfaceBus": "NL-4",
      "neuralLoad": 18,
      "powerDrawMw": 340,
      "bioRejectionRisk": "low",
      "surgeryClass": "B",
      "firmware": {
        "version": "4.2.1",
        "channel": "stable",
        "otaSupported": true
      }
    },
    "compatibleWith": ["NL-4", "NL-5"],
    "updatedAt": "2026-10-17T09:30:00Z"
  },
  "meta": { "apiVersion": "2.0", "requestId": "req_01JAX9F3K2" }
}

06Migration guide

Four steps cover most integrations. Test with cp_test_ credentials first — test-mode orders never charge and never ship.

1 · Get an access token

curl -X POST https://cyber-punk.online/oauth/token \
  -d grant_type=client_credentials \
  -d client_id=$CP_CLIENT_ID \
  -d client_secret=$CP_CLIENT_SECRET \
  -d scope="catalog:read orders:write"

# → { "access_token": "eyJhbGciOi...", "token_type": "Bearer", "expires_in": 3600 }

2 · Replace page-based listing with cursors

const res = await fetch(
  `https://cyber-punk.online/api/v1/products?page=2&api_key=${KEY}`
);
const products = await res.json();
// errors came back as 200 { error: "..." }

async function* listImplants(token, category) {
  let cursor = null;
  do {
    const url = new URL("https://cyber-punk.online/api/v2/implants");
    url.searchParams.set("limit", "50");
    if (category) url.searchParams.set("filter[category]", category);
    if (cursor) url.searchParams.set("cursor", cursor);

    const res = await fetch(url, {
      headers: { Authorization: `Bearer ${token}` }
    });
    if (!res.ok) throw await res.json(); // RFC 9457 problem+json

    const { data, meta } = await res.json();
    yield* data;
    cursor = meta.nextCursor;
  } while (cursor);
}

3 · Check implant compatibility before checkout

curl -X POST https://cyber-punk.online/api/v2/compatibility/check \
  -H "Authorization: Bearer $CP_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "neuralProfile": { "interfaceBus": "NL-4", "neuralBudget": 100, "powerBudgetMw": 1200 },
    "installed":  ["KSL-OCU-KX7"],
    "candidates": ["OZU-NEU-SYN3"]
  }'

{
  "compatible": true,
  "totalNeuralLoad": 52,
  "totalPowerDrawMw": 1020,
  "warnings": [
    {
      "code": "POWER_HEADROOM_LOW",
      "detail": "Power headroom below 20% of budget (180 mW remaining)."
    }
  ]
}

4 · Create orders idempotently & listen to webhooks

curl -X POST https://cyber-punk.online/api/v2/orders \
  -H "Authorization: Bearer $CP_TOKEN" \
  -H "Idempotency-Key: 6f1c2a9e-3b7d-4c55-9a0e-8d2f41b7c3aa" \
  -H "Content-Type: application/json" \
  -d '{ "cartId": "cart_8QZ2", "clinicId": "clinic_PAR_03", "compatibilityCheck": true }'

# Webhook deliveries are signed:
# CP-Signature: t=1792195200,sha256=<hex HMAC of "t.body" with your webhook secret>
# Reject deliveries older than 5 minutes to prevent replay.

HTTP/1.1 410 Gone
Content-Type: application/problem+json

{
  "type": "https://cyber-punk.online/docs/errors/api-version-sunset",
  "title": "API version sunset",
  "status": 410,
  "detail": "API v1 was shut down on 2027-01-31. Use /api/v2.",
  "successor": "https://cyber-punk.online/api/v2/"
}

07Migration checklist

Tick items as you go — progress stays in this browser only.

08FAQ