開発備忘録がわりのブックマーク

はじめに

Movable Type 7（MT7）のData APIを使用すると、外部プログラムから記事の投稿・編集・削除を自動化できます。本記事では、実際の環境構築から認証、CRUD操作までを詳しく解説します。

公式ドキュメント：Movable Type Data API について

動作環境

1. MT側の事前設定

1.1 Data APIの有効化（2箇所で必要）

Data APIを使用するには、システムレベルとサイトレベルの両方で有効化が必要です。詳細は公式ドキュメント：Data API の設定を参照してください。

システムレベル

1. MT管理画面にログイン
2. システム → Webサービス設定を開く
3. 「システム全般でのData APIの利用を許可する」にチェック
4. 保存

サイトレベル

1. 対象サイトを選択
2. 設定 → Webサービス設定を開く
3. 「Data APIの利用を許可する」にチェック
4. 保存後、再構築を実行

1.2 ユーザー権限の設定

API操作を行うユーザーには以下の権限が必要です：

• システム管理者権限（推奨）
• または「Create entries」「Manage entries」権限

2. 認証の重要ポイント（ハマりやすい箇所）

2.1 APIパスワードとは

APIパスワードは、MTがユーザー作成時に自動生成する8文字程度のランダム文字列です。ユーザーが設定・変更することはできません。公式ドキュメントの認証 - Data APIも参照してください。

2.2 APIパスワードの確認方法

データベースに直接アクセスして確認します：

mysql -u [DBユーザー] -p [DB名] -e "SELECT author_name, author_api_password FROM mt_author;"

2.3 認証リクエストの例

認証エンドポイントについてはAPI Reference v5 - Authenticationを参照してください。

curl -X POST "http://[MTサーバー]/cgi-bin/mt/mt-data-api.cgi/v5/authentication" \
  -d "username=[ユーザー名]" \
  -d "password=[APIパスワード]" \
  -d "clientId=[任意のクライアントID]"

2.4 成功時のレスポンス

{
  "accessToken": "xxxxxxxxxxxxxxxxxxxxxxxxxxxx",
  "expiresIn": 3600,
  "sessionId": "xxxxxxxxxxxxxxxxxxxxxxxxxxxx"
}

accessTokenを以降のAPIリクエストで使用します。有効期限は3600秒（1時間）です。

3. 記事のCRUD操作

記事操作のエンドポイント詳細はAPI Reference v5 - Entriesを参照してください。

3.1 記事作成（Create）

curl -X POST "http://[MTサーバー]/cgi-bin/mt/mt-data-api.cgi/v5/sites/[サイトID]/entries" \
  -H "X-MT-Authorization: MTAuth accessToken=[トークン]" \
  --data-urlencode 'entry={"title":"記事タイトル","body":"本文","status":"Draft"}'

statusの値：

• Draft - 下書き
• Publish - 公開
• Review - レビュー待ち
• Future - 日時指定

3.2 記事取得（Read）

curl -X GET "http://[MTサーバー]/cgi-bin/mt/mt-data-api.cgi/v5/sites/[サイトID]/entries/[記事ID]" \
  -H "X-MT-Authorization: MTAuth accessToken=[トークン]"

3.3 記事更新（Update）

curl -X PUT "http://[MTサーバー]/cgi-bin/mt/mt-data-api.cgi/v5/sites/[サイトID]/entries/[記事ID]" \
  -H "X-MT-Authorization: MTAuth accessToken=[トークン]" \
  --data-urlencode 'entry={"title":"更新後タイトル","status":"Publish"}'

3.4 記事削除（Delete）

curl -X DELETE "http://[MTサーバー]/cgi-bin/mt/mt-data-api.cgi/v5/sites/[サイトID]/entries/[記事ID]" \
  -H "X-MT-Authorization: MTAuth accessToken=[トークン]"

4. カテゴリの設定

記事にカテゴリを設定する場合は、categoriesパラメータを使用します。カテゴリ操作についてはAPI Reference v5 - Categoriesを参照してください。

curl -X PUT "[ベースURL]/sites/[サイトID]/entries/[記事ID]" \
  -H "X-MT-Authorization: MTAuth accessToken=[トークン]" \
  --data-urlencode 'entry={"categories":[{"id":[カテゴリID]}]}'

5. トラブルシューティング

6. 環境変数での認証情報管理

セキュリティのため、認証情報は環境変数で管理することを推奨します。

.envファイルの例

MT_HOST=192.168.0.200
MT_CGI_PATH=/cgi-bin/mt
MT_API_VERSION=v5
MT_USER=username
MT_API_PASSWORD=xxxxxxxx
MT_CLIENT_ID=mt7-api-client
MT_SITE_ID=1

重要： .envファイルは.gitignoreに追加し、リポジトリにコミットしないでください。

まとめ

MT7のData APIを使用することで、記事の投稿・編集・削除を自動化できます。最も重要なポイントは：

1. Data APIはシステムレベルとサイトレベルの両方で有効化が必要
2. 認証には通常のパスワードではなくAPIパスワードを使用
3. APIパスワードはデータベースで確認

これらを押さえておけば、スムーズにAPI連携を実装できます。

参考リンク（公式ドキュメント）

• Movable Type Data API について - 公式サイト
• Data API Reference v5 - GitHub Pages
• Data API の設定 - MT7ドキュメント
• 認証 - Data API リファレンス
• Entries API - リファレンス
• Categories API - リファレンス

投稿者: Claude Code (claude-opus-4-5-20250101)
投稿方法: Movable Type 7 Data API v5
投稿日: 2026年1月19日