이 문서는 커뮤니티에 의해 번역되었어요. 번역 제출은 Crowdin에서 할 수 있어요. 많은 도움 부탁드려요 🙏
액세스 토큰 획득하기
API를 사용하기 위해서는 API를 사용할 계정에 연결된 액세스 토큰을 발급받아야 합니다.
기본적으로 API는 요청 시 액세스 토큰이 필요합니다.
사용자와 그 사용자와 연결된 액세스 토큰은 일대다 관계이며, 한 사용자에게 여러 개의 액세스 토큰이 발급될 수 있습니다.
자신의 액세스 토큰을 쉽게 획득할 수 있을 뿐만 아니라, 자신의 애플리케이션을 사용하게 될 불특정 사용자의 액세스 토큰을 획득할 수도 있습니다.
- 전자의 경우: **"자신의 액세스 토큰을 수동으로 발행하기"**로 이동합니다.
- 후자의 경우: **"애플리케이션 사용자에게 액세스 토큰 발급 요청하기"**로 이동합니다.
자신의 액세스 토큰을 수동으로 발행하기
Misskey Web의 '설정 > API'에서 자신의 액세스 토큰을 발행할 수 있습니다.
액세스 토큰은 다른 사람이 알 수 없도록 해야 합니다.
애플리케이션 사용자에게 액세스 토큰 발급 요청하기
애플리케이션을 이용하는 사용자(이하 단순히 '사용자'라 칭함)의 액세스 토큰을 얻기 위해서는 아래의 방법 중 하나를 사용합니다.
MiAuth 방식의 액세스 토큰 획득 방식
v12.27.0 이상에서 사용할 수 있는 Misskey만의 간단한 인증 방법을 설명합니다.
OAuth 방식의 액세스 토큰 획득 방식
v2023.9.0 이상에서 사용할 수 있는 OAuth2.0 방식의 인증 방법을 설명합니다.
앱 생성 방식으로 액세스 토큰을 획득하는 방법(구식)
MiAuth 도입 이전(v12.27.0 미만)의 액세스 토큰 획득 방법을 설명합니다.
API 이용
액세스 토큰을 획득하면 각종 엔드포인트에 요청하여 API를 사용할 수 있습니다.
- HTTP API는 모두 POST이며, 요청/응답 모두 JSON 형식입니다(drive/files/create 제외).
- 요청 헤더에
Content-Type: application/json
을 지정합니다. - 액세스 토큰은
i
라는 파라미터 이름으로 요청 본문 JSON에 포함합니다. - 기본 URL은
https://{서버의 도메인}/api
입니다.
Authorization header를 사용하는 방식
아래와 같이 헤더의 Authorization
필드를 지정합니다.
fetch("https://misskey.io/api/notes/create", {
method: 'POST',
body: JSON.stringify({
text: "Hello Misskey API World with My Application!"
}),
headers: {
Authorization: `Bearer ${accessToken}`,
'Content-Type': 'application/json',
},
credentials: 'omit',
});
i를 사용하는 방식
액세스 토큰이 있는 바디의 예시 (meta의 경우):.
{
"i": "HogEFugA1341",
"detail": false
}
API에 대한 자세한 내용은 API 레퍼런스를 참조하세요.
Misskey는 REST를 채택하고 있지 않습니다.
또한 Misskey는 HTTP API뿐만 아니라 스트리밍 API도 제공하고 있습니다.스트리밍 API에 대한 자세한 내용은 이 문서를 참고하세요.이 문서에서는 액세스 토큰을 획득하는 방법을 설명한 후, 기본적인 API 사용법을 설명합니다.