API: 첫 요청 보내기

기본 주소

Obsidian용 SEED Publisher도 이 API를 그대로 사용합니다. Obsidian은 별도 서비스가 아니라 API 클라이언트입니다.

1. 키 만들기

   설정 → API 키를 여세요. 이름을 적고 필요한 권한만 고른 뒤 유효 기간을 30일·90일·365일 중 선택하세요. 처음에는 초안 읽기 권한으로 시작하세요. 계정마다 활성 키를 최대 10개까지 만들 수 있습니다.

   API 키 설정 열기

2. 한 번만 표시되는 키 보관하기

   키 전체 값은 만들었을 때만 보여줍니다. 안전한 비밀값 저장소에 보관하세요. 소스 코드, 공유 노트, URL, 브라우저 JavaScript에 넣지 마세요. 잃어버렸다면 해당 키를 폐기하고 새로 만드세요.

3. 연결 확인하기

   Bash에서 아래 코드를 실행하고 숨김 입력에 키를 붙여 넣은 뒤 Enter를 누르세요. 키는 명령 인자 대신 표준 입력으로 curl에 전달합니다. 다른 주소로 자동 이동하지 않습니다.

read -r -s SEED_API_KEY
printf '\n'
printf 'Authorization: Bearer %s\n' "$SEED_API_KEY" |
  curl --silent --show-error --fail-with-body \
    --header @- \
    https://withseed.app/api/v1/me
unset SEED_API_KEY

성공한 응답에는 user.scopes, api-key로 표시되는 auth.kind, 만료 시각인 auth.expiresAt이 들어 있습니다. 콘텐츠를 만들거나 발행하지 않고 키를 확인하는 요청입니다.

초안 목록은 drafts:read 권한으로 GET /drafts를 호출하세요. 모든 요청에 Authorization: Bearer를 보내야 합니다. API 키로 다른 API 키를 만들거나 관리할 수는 없습니다.

서버, 네이티브 앱, 터미널에서 호출하세요. 브라우저의 fetch 호출은 지원하지 않습니다. Cookie나 Origin 헤더가 있으면 요청을 거부합니다.

자동화를 멈추려면 설정에서 해당 키를 폐기하세요. 다음 인증 요청부터 거부됩니다. 스크립트 실행이 끝나는 것만으로 키가 폐기되지는 않습니다.