GET/prefs/{ns}
List Prefs
ns 의 pref 목록(prefix 로 owner 스코프). value 미포함(키·메타만 — 대량 전송 방지).
@param ns 화이트리스트 네임스페이스. @param prefix 보통 "{owner}/" — 그 owner 것만.
@returns [{ns, key, updatedAt}] (최근순, 최대 500)
@sideeffect sxe SELECT(읽기).
Responses
200 Successful Response422 Validation Error
any
cURLcurl -X GET https://see.in-bridge.com/prefs/{ns}?prefix=string
JavaScriptconst 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(읽기).
Responses
200 Successful Response422 Validation Error
any
cURLcurl -X GET https://see.in-bridge.com/prefs/{ns}/{key}
JavaScriptconst 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.
Responses
200 Successful Response422 Validation Error
any
cURLcurl -X PUT https://see.in-bridge.com/prefs/{ns}/{key}
JavaScriptconst 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(쓰기).
Responses
200 Successful Response422 Validation Error
any
cURLcurl -X DELETE https://see.in-bridge.com/prefs/{ns}/{key}
JavaScriptconst res = await fetch("https://see.in-bridge.com/prefs/{ns}/{key}", {
method: "DELETE"
});
const data = await res.json();