| r27 vs r28 | ||
|---|---|---|
| ... | ... | |
| 3 | 3 | [목차] |
| 4 | 4 | == 개요 == |
| 5 | 5 | [[the seed]] 엔진에서 존재하는 권한 중 하나이다. |
| 6 | 기존 방식의 자동 편집이 불가능해지고 api를 통해 자동 편집할 수 있게 되었는데 이때 api를 사용하기 위해서 필수적으로 필요한 권한이 api_access이다. | |
| 7 | 6 | |
| 8 | ||
| 7 | == 용도 == | |
| 8 | 더시드엔진은 공개 API를 통한 외부 접속 기능을 지원한다. 단, API는 계정 사용자에 한해서 지원되며 API로 접속하려면 계정의 로그인 정보 대신 API Token이라는 256자리의 무작위 숫자+알파벳으로 구성된 개인 식별키가 필요하다.[* API Token은 로그인 후 '우측 상단 프로필 메뉴>내 정보' 페이지에서 최하단에 있는 API Token 항목의 발급 버튼을 누르고 계정의 비밀번호를 입력해서 발급받을 수 있다. 참고로 한번 발급받은 API Token키는 반영구적으로 유지되지만, '''최초 발급 때를 제외하고 재확인할 방법이 아예 없어서 따로 저장을 해두어야 한다.''' 토큰값을 잊어버려서 재발급하려면 그냥 최초 발급이랑 똑같이 발급받으면 되는데 이 경우 기존 토큰은 만료되고 새 토큰값이 발급되는 식이다.] 이를 이용해 웹브라우저가 아닌 봇, 터미널 프로그램등을 이용하여 엔진에 직접 접근하여 자동 편집 등의 위키 작업이 가능하다. 이 때 API를 사용하기 위해서 필요한 권한이 바로 이 권한이다. | |
| 9 | 9 | |
| 10 | 더시드엔진에서 API는 기본적으로 보호 처리가 되어 있어서 이 권한이 없으면 API Token이 있어도 엔진 상에서 API 접근이 차단된다.[* 이 권한이 없는 상태에서 API 접속 시도 시 어떤 작업을 하더라도 접근 권한이 없다는 '403(Forbidden)' 에러를 반환한다.] 따라서 API를 이용한 봇을 운용하려면 반드시 이 권한이 필요하다. | |
| 11 | ||
| 12 | [[https://doc.theseed.io]]에서 API의 사용 방법을 확인할 수 있다. | |
| 13 | ||
| 10 | 14 | == API 사용 방법 == |
| 11 | 15 | 1. 사용자가 요청하면 JSON으로 반환하게 된다. |
| 12 | 16 | 2. API_TOKEN[* 'Authorization': 'Bearer API_TOKEN'의 API_TOKEN[br] 이때, Bearer는 제거하면 안 된다.]에는 [[https://theseed.io/member/mypage|내 정보]]의 API Token[* 유출되지 않도록 유의해야한다.] 발급 버튼을 눌러 자신의 계정 비밀번호를 입력한 뒤 나오는 token값을 적으면 된다. |
| ... | ... |