diff options
| author | syuilo <Syuilotan@yahoo.co.jp> | 2021-04-18 00:23:38 +0900 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-04-18 00:23:38 +0900 |
| commit | 7c26fbbb2ea1d35b94dde809c2a2a3ae272163d9 (patch) | |
| tree | 41fb3b76789553b0a1ab91d4bca6b36694333ba8 /src/docs/ko-KR/api.md | |
| parent | 12.77.0 (diff) | |
| download | misskey-7c26fbbb2ea1d35b94dde809c2a2a3ae272163d9.tar.gz misskey-7c26fbbb2ea1d35b94dde809c2a2a3ae272163d9.tar.bz2 misskey-7c26fbbb2ea1d35b94dde809c2a2a3ae272163d9.zip | |
New Crowdin updates (#7451)
* New translations ja-JP.yml (English)
* New translations theme.md (English)
* New translations ja-JP.yml (Ukrainian)
* New translations ja-JP.yml (Chinese Traditional)
* New translations theme.md (Chinese Simplified)
* New translations ja-JP.yml (Chinese Simplified)
* New translations ja-JP.yml (Japanese, Kansai)
* New translations mfm.md (Czech)
* New translations timelines.md (Czech)
* New translations theme.md (Czech)
* New translations reaction.md (Czech)
* New translations pages.md (Czech)
* New translations mute.md (Czech)
* New translations follow.md (Czech)
* New translations ja-JP.yml (Italian)
* New translations theme.md (German)
* New translations ja-JP.yml (German)
* New translations keyboard-shortcut.md (Czech)
* New translations custom-emoji.md (Czech)
* New translations ja-JP.yml (Spanish)
* New translations theme.md (French)
* New translations stream.md (French)
* New translations reversi-bot.md (French)
* New translations create-plugin.md (Czech)
* New translations aiscript.md (Czech)
* New translations ja-JP.yml (Czech)
* New translations ja-JP.yml (Arabic)
* New translations ja-JP.yml (Polish)
* New translations ja-JP.yml (Russian)
* New translations mute.md (Korean)
* New translations keyboard-shortcut.md (Korean)
* New translations follow.md (Korean)
* New translations custom-emoji.md (Korean)
* New translations create-plugin.md (Korean)
* New translations api.md (Korean)
* New translations ja-JP.yml (Korean)
* New translations reaction.md (Korean)
* New translations pages.md (Korean)
* New translations reversi-bot.md (Korean)
* New translations stream.md (Korean)
* New translations deck.md (Korean)
* New translations timelines.md (Korean)
* New translations theme.md (Korean)
Diffstat (limited to 'src/docs/ko-KR/api.md')
| -rw-r--r-- | src/docs/ko-KR/api.md | 78 |
1 files changed, 39 insertions, 39 deletions
diff --git a/src/docs/ko-KR/api.md b/src/docs/ko-KR/api.md index 76019b6145..057749ca6d 100644 --- a/src/docs/ko-KR/api.md +++ b/src/docs/ko-KR/api.md @@ -1,58 +1,58 @@ # Misskey API -MisskeyAPIを使ってMisskeyクライアント、Misskey連携Webサービス、Bot等(以下「アプリケーション」と呼びます)を開発できます。 ストリーミングAPIもあるので、リアルタイム性のあるアプリケーションを作ることも可能です。 +Misskey API를 사용하여 Misskey 클라이언트, Misskey 연계 웹 서비스, 봇 등(이하 "애플리케이션"이라고 부릅니다)을 개발할 수 있습니다. 스트리밍 API도 있기 때문에 실시간 애플리케이션을 만들 수도 있습니다. -APIを使い始めるには、まずアクセストークンを取得する必要があります。 このドキュメントでは、アクセストークンを取得する手順を説明した後、基本的なAPIの使い方を説明します。 +API를 사용하려면 먼저 액세스 토큰을 취득해야 합니다. 이 문서에서는 액세스 토큰을 취득하는 절차를 설명한 후 기본적인 API 사용법을 설명합니다. -## アクセストークンの取得 -基本的に、APIはリクエストにはアクセストークンが必要となります。 APIにリクエストするのが自分自身なのか、不特定の利用者に使ってもらうアプリケーションなのかによって取得手順は異なります。 +## 액세스 토큰 가져오기 +기본적으로 API는 요청 시에 액세스 토큰이 필요합니다. API에 요청하는 것이 자기 자신인지, 불특정한 유저에게 사용하는 애플리케이션인지에 따라 취득 절차가 달라집니다. -* 前者の場合: [「自分自身のアクセストークンを手動発行する」](#自分自身のアクセストークンを手動発行する)に進む -* 後者の場合: [「アプリケーション利用者にアクセストークンの発行をリクエストする」](#アプリケーション利用者にアクセストークンの発行をリクエストする)に進む +* 전자의 경우: [ 「자기 자신의 액세스 토큰을 수동으로 발급하기」](#自分自身のアクセストークンを手動発行する)로 진행 +* 후자의 경우: [「애플리케이션 사용자에게 액세스 토큰 발급을 요청하기」](#アプリケーション利用者にアクセストークンの発行をリクエストする)로 진행 -### 自分自身のアクセストークンを手動発行する -「設定 > API」で、自分のアクセストークンを発行できます。 +### 자기 자신의 액세스 토큰을 수동으로 발급하기 +「설정 > API」에서 자신의 액세스 토큰을 발급할 수 있습니다. -[「APIの使い方」へ進む](#APIの使い方) +[「API 사용 방법」으로 이동](#APIの使い方) -### アプリケーション利用者にアクセストークンの発行をリクエストする -アプリケーション利用者のアクセストークンを取得するには、以下の手順で発行をリクエストします。 +### 애플리케이션 사용자에게 액세스 토큰 발급을 요청하기 +애플리케이션 사용자의 액세스 토큰을 취득하려면, 다음 순서로 발급을 요청합니다. -#### Step 1 +#### 1 단계 -UUIDを生成する。以後これをセッションIDと呼びます。 +UUID를 생성합니다. 이것을 세션 ID라고 부릅니다. -> このセッションIDは毎回生成し、使いまわさないようにしてください。 +> 이 세션 ID는 매번 새로 생성하는 것이 아닙니다. -#### Step 2 +#### 2 단계 -`{_URL_}/miauth/{session}`をユーザーのブラウザで表示させる。`{session}`の部分は、セッションIDに置き換えてください。 -> 例: `{_URL_}/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f` +`{_URL_}/miauth/{session}`을 사용자의 브라우저에 입력합니다. `{session}` 부분은 세션 ID로 대체해서 입력합니다. +> 예: `{_URL_}/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f` -表示する際、URLにクエリパラメータとしていくつかのオプションを設定できます: -* `name` ... アプリケーション名 - * > 例: `MissDeck` -* `icon` ... アプリケーションのアイコン画像URL - * > 例: `https://missdeck.example.com/icon.png` -* `callback` ... 認証が終わった後にリダイレクトするURL - * > 例: `https://missdeck.example.com/callback` - * リダイレクト時には、`session`というクエリパラメータでセッションIDが付きます -* `permission` ... アプリケーションが要求する権限 - * > 例: `write:notes,write:following,read:drive` - * 要求する権限を`,`で区切って列挙します - * どのような権限があるかは[APIリファレンス](/api-doc)で確認できます +표시할 때 URL에 쿼리 매개변수로 몇 가지 옵션을 설정할 수 있습니다: +* `name` ... 애플리케이션 이름 + * > 예: `MissDeck` +* `icon` ... 애플리케이션 아이콘의 이미지 URL + * > 예: `https://missdeck.example.com/icon.png` +* `callback` ... 인증이 끝난 후 리디렉션되는 URL + * > 예: `https://missdeck.example.com/callback` + * 리디렉션 할 시, `session`이라는 쿼리 매개변수로 세션 ID가 붙습니다. +* `permission` ... 애플리케이션이 요구하는 권한 + * > 예: `write:notes,write:following,read:drive` + * 요구하는 권한을 `,`으로 구분해서 작성합니다. + * 권한의 종류에 대해서는 [API 레퍼런스](/api-doc)에서 확인할 수 있습니다. -#### Step 3 -ユーザーが発行を許可した後、`{_URL_}/api/miauth/{session}/check`にPOSTリクエストすると、レスポンスとしてアクセストークンを含むJSONが返ります。 +#### 3 단계 +사용자가 발급을 허용한 후, `{_URL_}/api/miauth/{session}/check`에 POST 요청을 하면 응답으로 액세스 토큰을 포함한 JSON이 반환됩니다. -レスポンスに含まれるプロパティ: -* `token` ... ユーザーのアクセストークン -* `user` ... ユーザーの情報 +응답에 포함되는 속성: +* `token` ... 유저의 액세스 토큰 +* `user` ... 유저 정보 -[「APIの使い方」へ進む](#APIの使い方) +[「API 사용 방법」으로 이동](#APIの使い方) -## APIの使い方 -**APIはすべてPOSTで、リクエスト/レスポンスともにJSON形式です。RESTではありません。** アクセストークンは、`i`というパラメータ名でリクエストに含めます。 +## API 사용 방법 +**API는 모두 POST 방식이며, 요청/응답 모두 JSON 형식입니다. REST가 아닙니다.** 액세스 토큰은 `i`라는 매개변수로 요청에 포함됩니다. -* [APIリファレンス](/api-doc) -* [ストリーミングAPI](./stream) +* [API 레퍼런스](/api-doc) +* [스트리밍 API](./stream) |