Hosted macOS sessions

# One key per session you want. To retry, send the same key with the same body.
IDEMPOTENCY_KEY=$(uuidgen) # Store it with your record of the session: reuse it to retry.
curl -sS -X POST "https://api.isnap.ai/v1/macos-sessions/rent" \
  -H "Authorization: Bearer $ISNAP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDEMPOTENCY_KEY" \
  -d '{"metadata":{"crm_account_id":"acct_1042"}}'

import { randomUUID } from 'node:crypto'
import { APIError, ISnapClient } from '@isnap/sdk'

const client = new ISnapClient({ apiKey: process.env.ISNAP_API_KEY ?? '', maxRetries: 2 })

// One key per session you want.
const idempotencyKey = randomUUID() // Store it with your record of the session: reuse it to retry.

try {
  const session = await client.macosSessions.rent(
    { metadata: { crm_account_id: 'acct_1042' } },
    { idempotencyKey }
  )
  // Store session.id: no operation lists your sessions.
  console.log(session.id, session.anniversary_at)
} catch (err) {
  if (err instanceof APIError && err.code === 'no_macos_session_in_stock') {
    // Nothing was rented. iSnap can attach a session later: watch macos_session.rented.
    console.error('No session is in stock.')
  } else if (err instanceof APIError && err.code === 'not_a_wholesale_partner') {
    console.error('Wholesale partners only.')
  } else {
    throw err
  }
}

import json
import os
import time
import uuid

import requests

# One key per session you want, and the same bytes on every attempt:
# the API compares the body byte for byte.
idempotency_key = str(uuid.uuid4())  # Store it with your record of the session: reuse it to retry.
headers = {
    "Authorization": f"Bearer {os.environ['ISNAP_API_KEY']}",
    "Content-Type": "application/json",
    "Idempotency-Key": idempotency_key,
}
body = json.dumps({"metadata": {"crm_account_id": "acct_1042"}})

response = None
for attempt in range(3):
    if attempt > 0:
        time.sleep(2**attempt)
    try:
        response = requests.post(
            "https://api.isnap.ai/v1/macos-sessions/rent", headers=headers, data=body, timeout=30
        )
    except (requests.ConnectionError, requests.Timeout):
        # No response: the same key makes the retry safe.
        response = None
        continue
    if response.status_code not in (500, 503):
        break
    # 500, or 503 idempotency_in_flight: the same key makes the retry safe.

if response is None:
    raise SystemExit("No response. Retry within 24 hours with the same key and the same body.")

if response.status_code == 201:
    session = response.json()["data"]
    # Store session["id"]: no operation lists your sessions.
    print(session["id"], session["anniversary_at"])
elif response.status_code == 409 and response.json()["error"]["code"] == "no_macos_session_in_stock":
    # Nothing was rented. iSnap can attach a session later: watch macos_session.rented.
    print("No session is in stock.")
elif response.status_code == 403 and response.json()["error"]["code"] == "not_a_wholesale_partner":
    print("Wholesale partners only.")
else:
    response.raise_for_status()

curl -sS -X POST "https://api.isnap.ai/v1/macos-sessions/mcs_7Qd3Vx9Kb2Lm5Tn8Wr4Yc6Hz1/cancel" \
  -H "Authorization: Bearer $ISNAP_API_KEY"

curl -sS -X POST "https://api.isnap.ai/v1/macos-sessions/mcs_7Qd3Vx9Kb2Lm5Tn8Wr4Yc6Hz1/uncancel" \
  -H "Authorization: Bearer $ISNAP_API_KEY"

import { APIError, ISnapClient } from '@isnap/sdk'

const client = new ISnapClient({ apiKey: process.env.ISNAP_API_KEY ?? '', maxRetries: 2 })
const sessionId = 'mcs_7Qd3Vx9Kb2Lm5Tn8Wr4Yc6Hz1'

try {
  const canceled = await client.macosSessions.cancel(sessionId)
  console.log('The rental ends at', canceled.cancel_at)

  const kept = await client.macosSessions.uncancel(sessionId)
  console.log('cancel_at is now', kept.cancel_at)
} catch (err) {
  if (err instanceof APIError && err.code === 'macos_session_not_found') {
    console.error('Unknown session, released session, or a session that another account rents.')
  } else if (err instanceof APIError && err.code === 'macos_session_cancellation_already_due') {
    console.error('cancel_at has passed: the session is about to be released.')
  } else {
    throw err
  }
}

import os

import requests

API = "https://api.isnap.ai"
HEADERS = {"Authorization": f"Bearer {os.environ['ISNAP_API_KEY']}"}
SESSION_ID = "mcs_7Qd3Vx9Kb2Lm5Tn8Wr4Yc6Hz1"

for action in ("cancel", "uncancel"):
    response = requests.post(f"{API}/v1/macos-sessions/{SESSION_ID}/{action}", headers=HEADERS, timeout=30)
    payload = response.json()
    if response.status_code == 200:
        print(action, "cancel_at:", payload["data"]["cancel_at"])
    elif payload["error"]["code"] == "macos_session_not_found":
        print("Unknown session, released session, or a session that another account rents.")
        break
    elif payload["error"]["code"] == "macos_session_cancellation_already_due":
        print("cancel_at has passed: the session is about to be released.")
        break
    else:
        response.raise_for_status()