diff options
Diffstat (limited to 'src/docs/fr-FR/api.md')
| -rw-r--r-- | src/docs/fr-FR/api.md | 80 |
1 files changed, 40 insertions, 40 deletions
diff --git a/src/docs/fr-FR/api.md b/src/docs/fr-FR/api.md index 76019b6145..0147f95bac 100644 --- a/src/docs/fr-FR/api.md +++ b/src/docs/fr-FR/api.md @@ -1,58 +1,58 @@ -# Misskey API +# API de Misskey -MisskeyAPIを使ってMisskeyクライアント、Misskey連携Webサービス、Bot等(以下「アプリケーション」と呼びます)を開発できます。 ストリーミングAPIもあるので、リアルタイム性のあるアプリケーションを作ることも可能です。 +Vous pouvez utiliser l'API de Misskey pour développer des clients Misskey, des services web s'intégrant à Misskey, des Bots (que nous appellerons plus loin "Applications"), etc. Comme l'API streaming est aussi implémenté, vous avez la possibilité de créer des applications de temps réel. -APIを使い始めるには、まずアクセストークンを取得する必要があります。 このドキュメントでは、アクセストークンを取得する手順を説明した後、基本的なAPIの使い方を説明します。 +Pour pouvoir vous servir de l'API, il vous faudra d'abord obtenir un jeton d'accès. Ce guide a été conçu pour vous accompagner dans le processus d'obtention du jeton d'accès, puis donner des instructions de base sur l'utilisation de l'API. -## アクセストークンの取得 -基本的に、APIはリクエストにはアクセストークンが必要となります。 APIにリクエストするのが自分自身なのか、不特定の利用者に使ってもらうアプリケーションなのかによって取得手順は異なります。 +## Obtenir le jeton d'accès +Une requête d'API, par essence, nécessite un jeton d'accès. La procédure d'acquisition du jeton diffère selon que vous effectuez la requête vous-même, ou qu'elle est envoyée via une application par un utilisateur final non défini. -* 前者の場合: [「自分自身のアクセストークンを手動発行する」](#自分自身のアクセストークンを手動発行する)に進む -* 後者の場合: [「アプリケーション利用者にアクセストークンの発行をリクエストする」](#アプリケーション利用者にアクセストークンの発行をリクエストする)に進む +* Dans le premier cas : allez à [« Générer manuellement un jeton d'accès pour son propre compte »](#自分自身のアクセストークンを手動発行する). +* Dans le second cas : allez à [« Demander la génération du jeton d'accès via un utilisateur d'application »](#アプリケーション利用者にアクセストークンの発行をリクエストする). -### 自分自身のアクセストークンを手動発行する -「設定 > API」で、自分のアクセストークンを発行できます。 +### Générer manuellement un jeton d'accès pour son propre compte +Vous pouvez générer votre propre jeton d'accès en allant dans { Paramètres > API }. -[「APIの使い方」へ進む](#APIの使い方) +[Continuer avec « Utiliser l'API ».](#APIの使い方) -### アプリケーション利用者にアクセストークンの発行をリクエストする -アプリケーション利用者のアクセストークンを取得するには、以下の手順で発行をリクエストします。 +### Demander la génération du jeton d'accès via un utilisateur d'application +Pour obtenir un jeton d'accès pour le compte utilisateur final de votre application, suivez la procédure de génération ci-dessous. -#### Step 1 +#### Étape 1 -UUIDを生成する。以後これをセッションIDと呼びます。 +Générez un UUID. Nous l'appellerons « ID de session » dans la suite de ce guide. -> このセッションIDは毎回生成し、使いまわさないようにしてください。 +> Un même ID de session ne devrait pas être utilisé plusieurs fois ; veillez à en générer un nouveau pour chaque jeton d'accès. -#### Step 2 +#### Étape 2 -`{_URL_}/miauth/{session}`をユーザーのブラウザで表示させる。`{session}`の部分は、セッションIDに置き換えてください。 -> 例: `{_URL_}/miauth/c1f6d42b-468b-4fd2-8274-e58abdedef6f` +Ouvrez l'adresse `{_URL_}/miauth/{session}` dans le navigateur de l'utilisateur. Remplacez alors la partie `{session}` de l'URL par l'ID de session que vous venez de générer. +> Par ex. : `{_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)で確認できます +En ouvrant cette URL, vous pourrez configurer un certain nombre d'options pour les paramètres de requête : +* `name` : nom de l'application + * > Ex. : `MissDeck` +* `icon` : URL de l'icône de l'application + * > Ex. : `https://missdeck.example.com/icon.png` +* `callback` : URL de redirection après l'authentification + * > Ex. : `https://missdeck.example.com/callback` + * Lors de la redirection, un paramètre de requête `session` contenant l'ID de session sera joint. +* `permission` : permissions requises par l'application + * > Ex. : `write:notes,write:following,read:drive` + * Listez les permissions requises en utilisant une `,` pour les séparer. + * Vous pouvez vérifier quelles sont les permissions disponibles sur [les références API de Misskey](/api-doc). -#### Step 3 -ユーザーが発行を許可した後、`{_URL_}/api/miauth/{session}/check`にPOSTリクエストすると、レスポンスとしてアクセストークンを含むJSONが返ります。 +#### Étape 3 +Si vous envoyez une requête POST à `{_URL_}/api/miauth/{session}/check` une fois que l'utilisateur a validé le jeton d'accès, la réponse arrivera sous forme de fichier JSON contenant ce jeton. -レスポンスに含まれるプロパティ: -* `token` ... ユーザーのアクセストークン -* `user` ... ユーザーの情報 +Propriétés incluses dans la réponse : +* `token` : jeton d'accès de l'utilisateur +* `user` : données de l'utilisateur -[「APIの使い方」へ進む](#APIの使い方) +[Continuer avec « Utiliser l'API ».](#APIの使い方) -## APIの使い方 -**APIはすべてPOSTで、リクエスト/レスポンスともにJSON形式です。RESTではありません。** アクセストークンは、`i`というパラメータ名でリクエストに含めます。 +## Utiliser l'API +**L'API utilise seulement la méthode POST, et toutes les requêtes / réponses sont au format JSON. REST n'est pas pris en charge. ** Le jeton d'accès s'insère dans le paramètre de requête nommé `i`. -* [APIリファレンス](/api-doc) -* [ストリーミングAPI](./stream) +* [Références API de Misskey](/api-doc) +* [API streaming](./stream) |