リクエスト

GET https://path/to/mt-data-api.cgi/v7/authorization?clientId=<YOUR-CLIENT-ID>&redirectUrl=<REDIRECT-TO-URL>

リクエスト パラメータ

clientId（必須）

アプリケーション固有の任意のキーを指定します。アルファベット、(_)アンダースコア、(-)ダッシュ、で構成された任意の文字列を指定できます。

redirectUrl（必須）

サインインに成功したとき、遷移するリダイレクト先のURLを指定します。

レスポンス

サインイン画面が表示され、サインインに成功すると redirectUrl で指定された URL にリダイレクトされます。

リクエスト

POST https://path/to/mt-data-api.cgi/v7/authentication

リクエスト パラメータ

パラメータは、リクエストのボディとして送信します。従って、application/x-www-form-urlencodedまたは、multipart/form-data 形式である必要があります。

username（必須）

サインインするユーザーのユーザー名を指定します。

password（必須）

サインインするユーザーのパスワードを指定します。v3 からは、CMS のログインパスワードではなく、Web サービス パスワードを指定します。

remember

1 を指定すると、ユーザーのログインセッションは、サインアウトするまで有効になります。

clientId（必須）

アプリケーション固有の任意のキーを指定します。アルファベット、(_)アンダースコア、(-)ダッシュ、で構成された任意の文字列を指定できます。

mtDataApiLoginMagicToken

Web ブラウザから認証するときに指定します。有効な値を指定すると、セッション ID をレスポンスに含めず、httponly の Cookie に保存します。Web ブラウザ以外から認証する場合は、指定する必要はありません。

レスポンス

username と password の組み合わせが正しい場合、sessionId, accessToken が取得できます。

{
  "accessToken": "0t60z2zrz89WSfi8euUl21VZ3LOG4tc1pYWhzZLj",
  "sessionId": "ThRsb2XwYvFs93gvmbUeF3nu3JDIEIYP8polopI6",
  "expiresIn": 3600,
  "remember": false
}

サンプルコード (JavaScript)

ここでは、fetch を利用した JavaScript のサンプルコードを紹介します。

const res = await fetch("https://example.com/mt/mt-data-api.cgi/v7/authentication", {
    method: "POST",
    body: new URLSearchParams({
        username: "your-username",
        password: "your-web-service-password",
        clientId: "test",
    }),
});
const data = await res.json();
console.log(data.accessToken);

リクエスト

POST https://path/to/mt-data-api.cgi/v7/token

リクエスト パラメータ

パラメータは、リクエストのボディとして送信します。従って、application/x-www-form-urlencodedまたは、multipart/form-data 形式である必要があります。

clientId（必須）

サインインの際に使用した clientId と同じ値を指定します。X-MT-AuthorizationにsessionIdを指定する場合は、clientId を指定する必要はありません。

レスポンス

有効なセッションである場合、新しいアクセストークンを取得できます。

{
  "accessToken": "UQddkGoFAR0PlqLiaatJGe22HkqxA3pTrNpT2DjI",
  "expiresIn": 3600
}

サンプルコード (JavaScript)

ここでは、fetch を利用した JavaScript のサンプルコードを紹介します。

const sessionId = "MTAuth sessionId=BKuU8Pc25oZRCuaNDijoO8RFS1itBmPaVM7LgELH";
const res = await fetch("https://example.com/mt/mt-data-api.cgi/v7/token", {
    method: "POST",
    headers: {
        "X-MT-Authorization": sessionId,
    },
});
const data = await res.json();
console.log(data.accessToken);

サンプルコード (JavaScript)

ここでは、fetch を利用した JavaScript のサンプルコードを紹介します。

// sessionId をもとに新しいアクセストークンを取得します。
const sessionId = "MTAuth sessionId=BKuU8Pc25oZRCuaNDijoO8RFS1itBmPaVM7LgELH";
const tokenRes = await fetch("https://example.com/mt/mt-data-api.cgi/v7/token", {
    method: "POST",
    headers: {
        "X-MT-Authorization": sessionId,
    },
});
const data = await tokenRes.json();

// アクセストークンをヘッダーに付加して、非公開の記事を取得します。
const accessToken = "MTAuth accessToken=" + data.accessToken;
const entryRes = await fetch("https://example.com/mt/mt-data-api.cgi/v7/sites/1/entries/1", {
    method: "GET",
    headers: {
        "X-MT-Authorization": accessToken,
    },
});
const entry = await entryRes.json();
console.log(entry.title);