End-to-end walkthrough

curl -s -X POST "$PHOSRA_BASE/api/v1/setup/quick" \
  -H "Content-Type: application/json" \
  -d '{
    "child_name": "Ruby",
    "birth_date": "2018-02-14",
    "family_name": "Ruby'\''s Family",
    "strictness": "relaxed"
  }'

const BASE = "https://phosra-api-sandbox-production.up.railway.app";

const res = await fetch(`${BASE}/api/v1/setup/quick`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    child_name: "Ruby",
    birth_date: "2018-02-14",
    family_name: "Ruby's Family",
    strictness: "relaxed",
  }),
});
const setup = await res.json();
const familyId = setup.family.id; // carry this into every step below

import requests

BASE = "https://phosra-api-sandbox-production.up.railway.app"

setup = requests.post(
    f"{BASE}/api/v1/setup/quick",
    json={
        "child_name": "Ruby",
        "birth_date": "2018-02-14",
        "family_name": "Ruby's Family",
        "strictness": "relaxed",
    },
    timeout=30,
).json()
family_id = setup["family"]["id"]  # carry this into every step below

curl -s "$PHOSRA_BASE/api/v1/platforms"

const platforms = await (
  await fetch(`${BASE}/api/v1/platforms`)
).json();
// 22 connectable platforms; pick two to link

platforms = requests.get(f"{BASE}/api/v1/platforms", timeout=30).json()
# 22 connectable platforms; pick two to link

curl -s -X POST "$PHOSRA_BASE/api/v1/compliance" \
  -H "Content-Type: application/json" \
  -d "{
    \"family_id\": \"$FAMILY_ID\",
    \"platform_id\": \"netflix\",
    \"credentials\": \"sandbox-demo-token\"
  }"

const netflix = await (
  await fetch(`${BASE}/api/v1/compliance`, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      family_id: familyId,
      platform_id: "netflix",
      credentials: "sandbox-demo-token",
    }),
  })
).json();
const netflixLinkId = netflix.id; // you unlink and relink with this

netflix = requests.post(
    f"{BASE}/api/v1/compliance",
    json={
        "family_id": family_id,
        "platform_id": "netflix",
        "credentials": "sandbox-demo-token",
    },
    timeout=30,
).json()
netflix_link_id = netflix["id"]  # you unlink and relink with this

curl -s "$PHOSRA_BASE/api/v1/families/$FAMILY_ID/compliance"

const links = await (
  await fetch(`${BASE}/api/v1/families/${familyId}/compliance`)
).json();

links = requests.get(
    f"{BASE}/api/v1/families/{family_id}/compliance", timeout=30
).json()

curl -s -X POST "$PHOSRA_BASE/api/v1/compliance" \
  -H "Content-Type: application/json" \
  -d "{
    \"family_id\": \"$FAMILY_ID\",
    \"platform_id\": \"xbox\",
    \"credentials\": \"sandbox-demo-token\"
  }"

const xbox = await (
  await fetch(`${BASE}/api/v1/compliance`, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      family_id: familyId,
      platform_id: "xbox",
      credentials: "sandbox-demo-token",
    }),
  })
).json();
const xboxLinkId = xbox.id;

xbox = requests.post(
    f"{BASE}/api/v1/compliance",
    json={
        "family_id": family_id,
        "platform_id": "xbox",
        "credentials": "sandbox-demo-token",
    },
    timeout=30,
).json()
xbox_link_id = xbox["id"]

curl -s "$PHOSRA_BASE/api/v1/families/$FAMILY_ID/compliance"

const managed = await (
  await fetch(`${BASE}/api/v1/families/${familyId}/compliance`)
).json();
// managed.length === 2  → [netflix, xbox]

managed = requests.get(
    f"{BASE}/api/v1/families/{family_id}/compliance", timeout=30
).json()
# len(managed) == 2  → [netflix, xbox]

curl -s -o /dev/null -w "%{http_code}\n" \
  -X DELETE "$PHOSRA_BASE/api/v1/compliance/$NETFLIX_LINK_ID"
# → 204

const res = await fetch(`${BASE}/api/v1/compliance/${netflixLinkId}`, {
  method: "DELETE",
});
// res.status === 204

res = requests.delete(
    f"{BASE}/api/v1/compliance/{netflix_link_id}", timeout=30
)
# res.status_code == 204

curl -s "$PHOSRA_BASE/api/v1/families/$FAMILY_ID/compliance"

const afterUnlink = await (
  await fetch(`${BASE}/api/v1/families/${familyId}/compliance`)
).json();
// afterUnlink.length === 1  → [xbox]

after_unlink = requests.get(
    f"{BASE}/api/v1/families/{family_id}/compliance", timeout=30
).json()
# len(after_unlink) == 1  → [xbox]

curl -s -X POST "$PHOSRA_BASE/api/v1/compliance/$XBOX_LINK_ID/verify" \
  -H "Content-Type: application/json" -d '{}'

const check = await (
  await fetch(`${BASE}/api/v1/compliance/${xboxLinkId}/verify`, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: "{}",
  })
).json();
// check.status === "verified"

check = requests.post(
    f"{BASE}/api/v1/compliance/{xbox_link_id}/verify",
    json={},
    timeout=30,
).json()
# check["status"] == "verified"

curl -s -X POST "$PHOSRA_BASE/api/v1/compliance" \
  -H "Content-Type: application/json" \
  -d "{
    \"family_id\": \"$FAMILY_ID\",
    \"platform_id\": \"netflix\",
    \"credentials\": \"sandbox-demo-token\"
  }"

const relinked = await (
  await fetch(`${BASE}/api/v1/compliance`, {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      family_id: familyId,
      platform_id: "netflix",
      credentials: "sandbox-demo-token",
    }),
  })
).json();
// relinked.id !== netflixLinkId  → a brand-new link

relinked = requests.post(
    f"{BASE}/api/v1/compliance",
    json={
        "family_id": family_id,
        "platform_id": "netflix",
        "credentials": "sandbox-demo-token",
    },
    timeout=30,
).json()
# relinked["id"] != netflix_link_id  → a brand-new link