prefs

Sentivex Evolution Engine API

GET/prefs/{ns}

List Prefs

ns 의 pref 목록(prefix 로 owner 스코프). value 미포함(키·메타만 — 대량 전송 방지). @param ns 화이트리스트 네임스페이스. @param prefix 보통 "{owner}/" — 그 owner 것만. @returns [{ns, key, updatedAt}] (최근순, 최대 500) @sideeffect sxe SELECT(읽기).

Path parameters

nsstringrequired

Query parameters

prefixstring

Responses

200 Successful Response422 Validation Error
any
cURL
curl -X GET https://see.in-bridge.com/prefs/{ns}?prefix=string
JavaScript
const res = await fetch("https://see.in-bridge.com/prefs/{ns}", {
  method: "GET"
});
const data = await res.json();
GET/prefs/{ns}/{key}

Get Pref

한 pref 값 조회. 없으면 404(정직 — 빈 값 위조 금지). @param ns 화이트리스트 네임스페이스. @param key {owner}/{item}. @returns {ns, key, value, updatedAt} @sideeffect sxe SELECT(읽기).

Path parameters

nsstringrequired
keystringrequired

Responses

200 Successful Response422 Validation Error
any
cURL
curl -X GET https://see.in-bridge.com/prefs/{ns}/{key}
JavaScript
const res = await fetch("https://see.in-bridge.com/prefs/{ns}/{key}", {
  method: "GET"
});
const data = await res.json();
PUT/prefs/{ns}/{key}

Put Pref

한 pref 값 upsert. body = {value:<opaque JSON>} 또는 value 를 직접 body 로. @param ns 화이트리스트 네임스페이스. @param key {owner}/{item}. @returns {ns, key, ok} @sideeffect sxe.prefs upsert(쓰기, `with conn` 트랜잭션 커밋). value >64KB=413, 비직렬화=400.

Path parameters

nsstringrequired
keystringrequired

Responses

200 Successful Response422 Validation Error
any
cURL
curl -X PUT https://see.in-bridge.com/prefs/{ns}/{key}
JavaScript
const res = await fetch("https://see.in-bridge.com/prefs/{ns}/{key}", {
  method: "PUT"
});
const data = await res.json();
DELETE/prefs/{ns}/{key}

Delete Pref

한 pref 삭제(멱등 — 없어도 200). @param ns 화이트리스트 네임스페이스. @param key {owner}/{item}. @returns {ns, key, deleted:<행수>} @sideeffect sxe.prefs DELETE(쓰기).

Path parameters

nsstringrequired
keystringrequired

Responses

200 Successful Response422 Validation Error
any
cURL
curl -X DELETE https://see.in-bridge.com/prefs/{ns}/{key}
JavaScript
const res = await fetch("https://see.in-bridge.com/prefs/{ns}/{key}", {
  method: "DELETE"
});
const data = await res.json();