인증

키 만들기

Settings를 열고 API keys로 가세요. 키에 어디에 쓸지 알 수 있는 이름을 붙여서 만드세요.

키는 한 번만 표시돼요. 바로 복사해서 서버의 환경 변수처럼 안전한 곳에 보관하세요. Setherion은 키의 핑거프린트만 저장하므로, 우리를 포함해 아무도 그 키를 다시 보여 줄 수 없어요. 키를 잃어버렸다면 그 키를 폐기하고 새로 만드세요.

키는 sth_로 시작하고, 그 뒤에 무작위 영문자, 숫자, -, _ 43개가 이어지며, 전부 47자예요. 이름은 최대 60자까지 쓸 수 있고, 더 긴 이름은 잘려요.

모든 요청에 보내기

키를 Authorization 헤더에 넣으세요:

curl https://www.setherion.com/api/v1/projects \
  -H "Authorization: Bearer $SETHERION_API_KEY"

const res = await fetch('https://www.setherion.com/api/v1/projects', {
  headers: { Authorization: `Bearer ${process.env.SETHERION_API_KEY}` },
})
const data = await res.json()

Bearer 방식만 읽어요. 유효한 키가 없는 요청은 401을 받아요:

{
  "ok": false,
  "error": "A valid API key is required. Make one on your Setherion account page and send it as \"Authorization: Bearer sth_...\"."
}

헤더가 없는 경우, 철자가 틀린 키, 존재하지 않는 키, 폐기된 키는 모두 똑같은 응답을 받아요. 그래서 그중 어느 경우였는지는 절대 알려 주지 않아요.

키로 할 수 있는 일

키는 나로서 동작해요. Setherion에서 내가 할 수 있는 일은 키로도 할 수 있어요:

• 대시보드에 있는 앱을 볼 수 있어요. 내 앱과 나에게 공유된 앱 모두예요.
• 열 수 있는 모든 앱의 스토어 준비 가이드와 개인정보 답변을 읽을 수 있어요.
• 수정할 수 있는 앱을 바꿀 수 있어요. 에디터에서 수정할 때처럼 크레딧을 써요.
• 수정할 수 있는 앱을 게시하고, 그 스토어 페이지를 쓸 수 있어요.

나머지는 각 앱에서의 내 역할이 정해요. 읽는 호출에는 viewer 이상이, 앱을 바꾸거나 크레딧을 쓰는 호출에는 editor 이상이 필요해요. 어떤 호출에 무엇이 필요한지는 소개를 참고하세요.

키로는 내 계정, 요금제, 결제를 바꿀 수 없고, 키를 만들거나 폐기할 수도 없어요. 그것은 내가 직접 Setherion에 로그인했을 때만 할 수 있어서, 키 하나가 유출되어도 다른 키가 만들어지는 일은 없어요.

키 폐기하기

API keys에서 키 옆의 Revoke를 누르세요. 키는 즉시 작동을 멈춰요. 폐기된 키는 목록에 남아서 마지막으로 쓰인 때를 볼 수 있어요.

활성 키는 한 번에 최대 10개까지 가질 수 있어요. 11번째 키를 요청하면 You have 10 active keys. Revoke one you no longer use to make another.라는 메시지와 함께 거부돼요. 목록에는 각 키가 마지막으로 쓰인 때가 표시되고, 갱신은 최대 1분에 한 번이에요.

키 없이 로그인하기

AI 어시스턴트는 키 대신 로그인 페이지와 Allow 버튼으로 연결해요. MCP: AI 어시스턴트 연결하기를 참고하세요.

그 로그인으로 만들어지는 토큰은 어시스턴트용 주소(/api/mcp)에서만 작동해요. 이 레퍼런스의 엔드포인트는 API 키만 받아요.