Feature Flags

Feature flags and gradual rollouts: define flags, evaluate per user/context, toggle and roll out by percentage — LaunchDarkly-style.

Overview

Base path: https://api.infrai.cc/v1/flags

Auth header: Authorization: Bearer $INFRAI_API_KEY

bash

# Call any /v1/flags capability over raw HTTP — no SDK to install.
# curl:
curl https://api.infrai.cc/v1/flags/... \
  -H "Authorization: Bearer $INFRAI_API_KEY" \
  -H "Content-Type: application/json"

Methods

flags.is_enabled

GET /v1/flags/is_enabled/{key}

Evaluate a feature flag for the current context.

Parameters

Name	Type	Required	Description
`key`	`string`	Required	Feature flag key.

Returns

{ enabled: boolean }

Example

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at https://infrai.cc/login (Google/GitHub gives
# you $2 free credit; email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT, add
# funds at https://infrai.cc/billing (or POST /v1/account/topup and open the
# returned checkout_url).
export INFRAI_API_KEY="ifr_..."

bash

curl -X GET https://api.infrai.cc/v1/flags/is_enabled/KEY \
  -H "Authorization: Bearer $INFRAI_API_KEY"

python

import os, requests

resp = requests.get(
    "https://api.infrai.cc/v1/flags/is_enabled/KEY",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/flags/is_enabled/KEY",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/flags/is_enabled/KEY",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

flags.set

POST /v1/flags/set

创建或更新功能开关定义

Parameters

Name	Type	Required	Description
`key`	`string`	Required	功能开关键
`description`	`string`	Optional	功能开关描述
`type`	`'bool' \| 'string' \| 'number' \| 'json'`	Optional	取值类型：bool/string/number/json
`default_value`	`unknown`	Optional	默认取值
`rules`	`FlagRule[]`	Optional	定向规则列表
`rollout`	`RolloutConfig`	Optional	灰度发布配置
`tags`	`Record<string, string>`	Optional	键值标签
`enabled`	`boolean`	Optional	是否启用
`version`	`number`	Optional	版本号，用于乐观并发控制

Returns

Flag

Example

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at https://infrai.cc/login (Google/GitHub gives
# you $2 free credit; email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT, add
# funds at https://infrai.cc/billing (or POST /v1/account/topup and open the
# returned checkout_url).
export INFRAI_API_KEY="ifr_..."

bash

curl -X POST https://api.infrai.cc/v1/flags/set \
  -H "Authorization: Bearer $INFRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "new_checkout", "type": "bool", "default_value": false, "description": "new checkout UX"}'

python

import os, requests

resp = requests.post(
    "https://api.infrai.cc/v1/flags/set",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
    json={'key': 'new_checkout', 'type': 'bool', 'default_value': False, 'description': 'new checkout UX'},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/flags/set",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"key": "new_checkout", "type": "bool", "default_value": false, "description": "new checkout UX"}),
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/flags/set",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"key": "new_checkout", "type": "bool", "default_value": false, "description": "new checkout UX"}),
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

flags.list

GET /v1/flags/list

分页列出功能开关

Parameters

Name	Type	Required	Description
`cursor`	`string`	Optional	分页游标
`limit`	`number`	Optional	每页返回数量
`include_archived`	`boolean`	Optional	是否包含已归档开关

Returns

FlagList

Example

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at https://infrai.cc/login (Google/GitHub gives
# you $2 free credit; email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT, add
# funds at https://infrai.cc/billing (or POST /v1/account/topup and open the
# returned checkout_url).
export INFRAI_API_KEY="ifr_..."

bash

curl -X GET https://api.infrai.cc/v1/flags/list \
  -H "Authorization: Bearer $INFRAI_API_KEY"

python

import os, requests

resp = requests.get(
    "https://api.infrai.cc/v1/flags/list",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/flags/list",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/flags/list",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

flags.get

GET /v1/flags/get/{key}

获取功能开关定义

Parameters

Name	Type	Required	Description
`key`	`string`	Required	功能开关键

Returns

Flag

Example

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at https://infrai.cc/login (Google/GitHub gives
# you $2 free credit; email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT, add
# funds at https://infrai.cc/billing (or POST /v1/account/topup and open the
# returned checkout_url).
export INFRAI_API_KEY="ifr_..."

bash

curl -X GET https://api.infrai.cc/v1/flags/get/KEY \
  -H "Authorization: Bearer $INFRAI_API_KEY"

python

import os, requests

resp = requests.get(
    "https://api.infrai.cc/v1/flags/get/KEY",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/flags/get/KEY",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/flags/get/KEY",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

flags.get_value

GET /v1/flags/get_value/{key}

在上下文下求值单个功能开关

Parameters

Name	Type	Required	Description
`key`	`string`	Required	功能开关键
`user_id`	`string`	Optional	求值上下文中的用户 ID
`context`	`Record<string, unknown>`	Optional	求值上下文属性
`default`	`unknown`	Optional	求值失败时的兜底默认值

Returns

FlagValue

Example

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at https://infrai.cc/login (Google/GitHub gives
# you $2 free credit; email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT, add
# funds at https://infrai.cc/billing (or POST /v1/account/topup and open the
# returned checkout_url).
export INFRAI_API_KEY="ifr_..."

bash

curl -X GET https://api.infrai.cc/v1/flags/get_value/KEY \
  -H "Authorization: Bearer $INFRAI_API_KEY"

python

import os, requests

resp = requests.get(
    "https://api.infrai.cc/v1/flags/get_value/KEY",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/flags/get_value/KEY",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/flags/get_value/KEY",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

flags.get_all

GET /v1/flags/get_all

在上下文下批量求值所有开关

Parameters

Name	Type	Required	Description
`user_id`	`string`	Optional	求值上下文中的用户 ID
`context`	`Record<string, unknown>`	Optional	求值上下文属性

Returns

FlagEvaluationMap

Example

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at https://infrai.cc/login (Google/GitHub gives
# you $2 free credit; email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT, add
# funds at https://infrai.cc/billing (or POST /v1/account/topup and open the
# returned checkout_url).
export INFRAI_API_KEY="ifr_..."

bash

curl -X GET https://api.infrai.cc/v1/flags/get_all \
  -H "Authorization: Bearer $INFRAI_API_KEY"

python

import os, requests

resp = requests.get(
    "https://api.infrai.cc/v1/flags/get_all",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/flags/get_all",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/flags/get_all",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

flags.toggle

POST /v1/flags/toggle/{key}

启用或禁用功能开关

Parameters

Name	Type	Required	Description
`key`	`string`	Required	功能开关键
`enabled`	`boolean`	Required	目标启用状态
`version`	`number`	Required	版本号，用于乐观并发控制

Returns

Flag

Example

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at https://infrai.cc/login (Google/GitHub gives
# you $2 free credit; email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT, add
# funds at https://infrai.cc/billing (or POST /v1/account/topup and open the
# returned checkout_url).
export INFRAI_API_KEY="ifr_..."

bash

curl -X POST https://api.infrai.cc/v1/flags/toggle/KEY \
  -H "Authorization: Bearer $INFRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "...", "enabled": true, "version": 0}'

python

import os, requests

resp = requests.post(
    "https://api.infrai.cc/v1/flags/toggle/KEY",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
    json={'key': '...', 'enabled': True, 'version': 0},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/flags/toggle/KEY",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"key": "...", "enabled": true, "version": 0}),
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/flags/toggle/KEY",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"key": "...", "enabled": true, "version": 0}),
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

flags.rollout

POST /v1/flags/rollout/{key}

配置功能开关的灰度发布

Parameters

Name	Type	Required	Description
`key`	`string`	Required	功能开关键
`percentage`	`number`	Required	灰度百分比（0-100）
`salt`	`string`	Required	哈希分桶用的盐值
`sticky_unit`	`'user_id' \| 'session_id' \| 'device_id'`	Required	黏滞维度：user_id/session_id/device_id
`version`	`number`	Required	版本号，用于乐观并发控制
`variants`	`Variant[]`	Optional	多变体配置列表

Returns

Flag

Example

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at https://infrai.cc/login (Google/GitHub gives
# you $2 free credit; email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT, add
# funds at https://infrai.cc/billing (or POST /v1/account/topup and open the
# returned checkout_url).
export INFRAI_API_KEY="ifr_..."

bash

curl -X POST https://api.infrai.cc/v1/flags/rollout/KEY \
  -H "Authorization: Bearer $INFRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "new_checkout", "rollout": {"percentage": 25, "salt": "v1", "sticky_unit": "user_id"}}'

python

import os, requests

resp = requests.post(
    "https://api.infrai.cc/v1/flags/rollout/KEY",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
    json={'key': 'new_checkout', 'rollout': {'percentage': 25, 'salt': 'v1', 'sticky_unit': 'user_id'}},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/flags/rollout/KEY",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"key": "new_checkout", "rollout": {"percentage": 25, "salt": "v1", "sticky_unit": "user_id"}}),
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/flags/rollout/KEY",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"key": "new_checkout", "rollout": {"percentage": 25, "salt": "v1", "sticky_unit": "user_id"}}),
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

flags.delete

DELETE /v1/flags/delete/{key}

删除功能开关

Parameters

Name	Type	Required	Description
`key`	`string`	Required	功能开关键

Returns

DeleteResult

Example

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at https://infrai.cc/login (Google/GitHub gives
# you $2 free credit; email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT, add
# funds at https://infrai.cc/billing (or POST /v1/account/topup and open the
# returned checkout_url).
export INFRAI_API_KEY="ifr_..."

bash

curl -X DELETE https://api.infrai.cc/v1/flags/delete/KEY \
  -H "Authorization: Bearer $INFRAI_API_KEY"

python

import os, requests

resp = requests.delete(
    "https://api.infrai.cc/v1/flags/delete/KEY",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

javascript

const resp = await fetch(
  "https://api.infrai.cc/v1/flags/delete/KEY",
  {
    method: "DELETE",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

typescript

const resp = await fetch(
  "https://api.infrai.cc/v1/flags/delete/KEY",
  {
    method: "DELETE",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

All capabilities

Every routed capability in this module — the complete public REST contract. The methods above are the guided walkthrough; this index is the full reference.

Capability	Endpoint	Description
`flags.delete`	`DELETE /v1/flags/delete/{key}`	Delete a feature flag permanently.
`flags.get`	`GET /v1/flags/get/{key}`	Retrieve the full definition of a feature flag.
`flags.get_all`	`GET /v1/flags/get_all`	Evaluate all feature flags at once for a given evaluation context.
`flags.get_value`	`GET /v1/flags/get_value/{key}`	Evaluate a single feature flag's value for a given evaluation context.
`flags.is_enabled`	`GET /v1/flags/is_enabled/{key}`	Check whether a feature flag is enabled for the current evaluation context.
`flags.list`	`GET /v1/flags/list`	List feature flags with pagination, optionally including archived ones.
`flags.rollout`	`POST /v1/flags/rollout/{key}`	Configure a percentage-based gradual rollout for a feature flag.
`flags.set`	`POST /v1/flags/set`	Create or update a feature-flag definition.
`flags.toggle`	`POST /v1/flags/toggle/{key}`	Enable or disable a feature flag with optimistic version checking.

End-to-end example

A production-style walkthrough of this module: configure once, then run the flow. It exercises most of the module's APIs.

A copy-paste-runnable single-file Python program (stdlib only, no SDK): set your INFRAI_API_KEY, run it, and walk this module's core flow with REAL billed calls — later steps reuse real fields returned by earlier ones. The 12-line helper is the entire integration.

python

#!/usr/bin/env python3
"""Infrai · flags — runnable real-app example (single file, zero deps).

Copy this file, set your key, run it: every step is a REAL call to
api.infrai.cc, billed at the real (tiny) per-call price, printing the
live JSON response. Get a key at https://infrai.cc/login (Google/
GitHub sign-in grants $2 free credit); add funds at
https://infrai.cc/billing. No SDK — the 12-line helper below is the
entire integration."""
import json
import os
from urllib import error, request

KEY = os.environ.get("INFRAI_API_KEY") or "ifr_..."  # <- your key
BASE = "https://api.infrai.cc"


# Same raw HTTPS POST/GET as every per-method example on this page —
# wrapped once for reuse. There is nothing else to it: no SDK.
def infrai(method, path, body=None):
    req = request.Request(
        BASE + path, method=method,
        data=json.dumps(body).encode() if body is not None else None,
        headers={"Authorization": f"Bearer {KEY}",
                 "Content-Type": "application/json"})
    try:
        with request.urlopen(req, timeout=60) as r:
            return json.loads(r.read())
    except error.HTTPError as e:
        return json.loads(e.read())


def show(label, resp):
    print(f"\n== {label} ==")
    print(json.dumps(resp, indent=2, ensure_ascii=False))
    return resp


# 1) flags.set — POST /v1/flags/set · Create or update a feature-flag definition.
r1 = show("flags.set", infrai("POST", "/v1/flags/set", {"key":"new_checkout","type":"bool","default_value":False,"description":"new checkout UX"}))

# 2) flags.list — GET /v1/flags/list · List feature flags with pagination, optionally including archived ones.
r2 = show("flags.list", infrai("GET", "/v1/flags/list"))

一次性前置(每个范例都假定已完成):

bash

# No SDK to install — every call is a plain HTTPS request.
# Get a project key by signing in at https://infrai.cc/login (Google/GitHub gives
# you $2 free credit; email sign-in starts at $0). On 402 INSUFFICIENT_CREDIT, add
# funds at https://infrai.cc/billing (or POST /v1/account/topup and open the
# returned checkout_url).
export INFRAI_API_KEY="ifr_..."

bash

# 1) Auth: every call is a raw HTTPS request to the Infrai gateway carrying
#    only your project key. No SDK, no install.
#    Get your key: sign in with Google/GitHub at https://infrai.cc/login for a
#    project key + $2 free credit (email sign-in starts at $0). On 402
#    INSUFFICIENT_CREDIT, add funds at https://infrai.cc/billing (or POST
#    /v1/account/topup and open the returned checkout_url).
export INFRAI_API_KEY="ifr_..."   # from https://infrai.cc/login


# 2) flags.is_enabled
curl -X GET https://api.infrai.cc/v1/flags/is_enabled/KEY \
  -H "Authorization: Bearer $INFRAI_API_KEY"

# 3) flags.set
curl -X POST https://api.infrai.cc/v1/flags/set \
  -H "Authorization: Bearer $INFRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "new_checkout", "type": "bool", "default_value": false, "description": "new checkout UX"}'

# 4) flags.list
curl -X GET https://api.infrai.cc/v1/flags/list \
  -H "Authorization: Bearer $INFRAI_API_KEY"

# 5) flags.get
curl -X GET https://api.infrai.cc/v1/flags/get/KEY \
  -H "Authorization: Bearer $INFRAI_API_KEY"

# 6) flags.get_value
curl -X GET https://api.infrai.cc/v1/flags/get_value/KEY \
  -H "Authorization: Bearer $INFRAI_API_KEY"

# 7) flags.get_all
curl -X GET https://api.infrai.cc/v1/flags/get_all \
  -H "Authorization: Bearer $INFRAI_API_KEY"

# 8) flags.toggle
curl -X POST https://api.infrai.cc/v1/flags/toggle/KEY \
  -H "Authorization: Bearer $INFRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "...", "enabled": true, "version": 0}'

# 9) flags.rollout
curl -X POST https://api.infrai.cc/v1/flags/rollout/KEY \
  -H "Authorization: Bearer $INFRAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"key": "new_checkout", "rollout": {"percentage": 25, "salt": "v1", "sticky_unit": "user_id"}}'

python

# 1) Auth: every call is a raw HTTPS request carrying only your project key.
#    No SDK to install — just the `requests` library.
import os, requests

BASE = "https://api.infrai.cc"
HEADERS = {
    "Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}",
    "Content-Type": "application/json",
}


# 2) flags.is_enabled
import os, requests

resp = requests.get(
    "https://api.infrai.cc/v1/flags/is_enabled/KEY",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

# 3) flags.set
import os, requests

resp = requests.post(
    "https://api.infrai.cc/v1/flags/set",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
    json={'key': 'new_checkout', 'type': 'bool', 'default_value': False, 'description': 'new checkout UX'},
)
resp.raise_for_status()
print(resp.json())

# 4) flags.list
import os, requests

resp = requests.get(
    "https://api.infrai.cc/v1/flags/list",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

# 5) flags.get
import os, requests

resp = requests.get(
    "https://api.infrai.cc/v1/flags/get/KEY",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

# 6) flags.get_value
import os, requests

resp = requests.get(
    "https://api.infrai.cc/v1/flags/get_value/KEY",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

# 7) flags.get_all
import os, requests

resp = requests.get(
    "https://api.infrai.cc/v1/flags/get_all",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
)
resp.raise_for_status()
print(resp.json())

# 8) flags.toggle
import os, requests

resp = requests.post(
    "https://api.infrai.cc/v1/flags/toggle/KEY",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
    json={'key': '...', 'enabled': True, 'version': 0},
)
resp.raise_for_status()
print(resp.json())

# 9) flags.rollout
import os, requests

resp = requests.post(
    "https://api.infrai.cc/v1/flags/rollout/KEY",
    headers={"Authorization": f"Bearer {os.environ['INFRAI_API_KEY']}"},
    json={'key': 'new_checkout', 'rollout': {'percentage': 25, 'salt': 'v1', 'sticky_unit': 'user_id'}},
)
resp.raise_for_status()
print(resp.json())

javascript

// 1) Auth: every call is a raw HTTPS request carrying only your project key.
//    No SDK to install — just the built-in fetch().
const BASE = "https://api.infrai.cc";
const HEADERS = {
  "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
  "Content-Type": "application/json",
};


// 2) flags.is_enabled
const resp = await fetch(
  "https://api.infrai.cc/v1/flags/is_enabled/KEY",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

// 3) flags.set
const resp = await fetch(
  "https://api.infrai.cc/v1/flags/set",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"key": "new_checkout", "type": "bool", "default_value": false, "description": "new checkout UX"}),
  },
);
console.log(await resp.json());

// 4) flags.list
const resp = await fetch(
  "https://api.infrai.cc/v1/flags/list",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

// 5) flags.get
const resp = await fetch(
  "https://api.infrai.cc/v1/flags/get/KEY",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

// 6) flags.get_value
const resp = await fetch(
  "https://api.infrai.cc/v1/flags/get_value/KEY",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

// 7) flags.get_all
const resp = await fetch(
  "https://api.infrai.cc/v1/flags/get_all",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
console.log(await resp.json());

// 8) flags.toggle
const resp = await fetch(
  "https://api.infrai.cc/v1/flags/toggle/KEY",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"key": "...", "enabled": true, "version": 0}),
  },
);
console.log(await resp.json());

// 9) flags.rollout
const resp = await fetch(
  "https://api.infrai.cc/v1/flags/rollout/KEY",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"key": "new_checkout", "rollout": {"percentage": 25, "salt": "v1", "sticky_unit": "user_id"}}),
  },
);
console.log(await resp.json());

typescript

// 1) Auth: every call is a raw HTTPS request carrying only your project key.
//    No SDK to install — just the built-in fetch(), typed.
const BASE = "https://api.infrai.cc";
const HEADERS: Record<string, string> = {
  "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
  "Content-Type": "application/json",
};


// 2) flags.is_enabled
const resp = await fetch(
  "https://api.infrai.cc/v1/flags/is_enabled/KEY",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

// 3) flags.set
const resp = await fetch(
  "https://api.infrai.cc/v1/flags/set",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"key": "new_checkout", "type": "bool", "default_value": false, "description": "new checkout UX"}),
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

// 4) flags.list
const resp = await fetch(
  "https://api.infrai.cc/v1/flags/list",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

// 5) flags.get
const resp = await fetch(
  "https://api.infrai.cc/v1/flags/get/KEY",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

// 6) flags.get_value
const resp = await fetch(
  "https://api.infrai.cc/v1/flags/get_value/KEY",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

// 7) flags.get_all
const resp = await fetch(
  "https://api.infrai.cc/v1/flags/get_all",
  {
    method: "GET",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
    },
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

// 8) flags.toggle
const resp = await fetch(
  "https://api.infrai.cc/v1/flags/toggle/KEY",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"key": "...", "enabled": true, "version": 0}),
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);

// 9) flags.rollout
const resp = await fetch(
  "https://api.infrai.cc/v1/flags/rollout/KEY",
  {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.INFRAI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({"key": "new_checkout", "rollout": {"percentage": 25, "salt": "v1", "sticky_unit": "user_id"}}),
  },
);
if (!resp.ok) throw new Error(`infrai ${resp.status}`);
const data: unknown = await resp.json();
console.log(data);