BlogController API

Authentication

このAPIはAPIキー認証に対応しています。APIキーはユーザーアカウントに紐づいており、サーバーはキーを用いてユーザーを識別し、権限を確認します。
API機能は有料プランで提供されます。APIキーはブログ設定メニューから発行できます。

Endpoints

セキュリティ上の理由により、Mikihands APIサーバーはユーザーが指定した外部URLへ直接アクセス（ダウンロード）しません。 画像を含めて投稿する場合は、まずアップロードAPIで画像を安全に登録し、レスポンスで受け取ったimage_url / image_idをご利用ください。

curl -sS -X POST \
  "https://api.mikihands.com/api/blogcontroller/image-upload/" \
  -H "X-API-KEY: <your_api_key>" \
  -F "file=@/path/to/image.webp"

{
  "success": true,
  "image_url": "/media/<username>/blog_img/<image_id>.webp",
  "image_id": "<image_id>"
}

![cover](/media/<username>/blog_img/<image_id>.webp)

ここに本文を続けて書きます...

{
  "image_ids": ["<image_id>", "<image_id2>"]
}

Payload Examples

POST /api/blogcontroller/posts/

{
  "title": "My first post",
  "slug": "my-first-post",
  "status": "PB",
  "categories": "Technology, AI",
  "tags": "mikihands, automation",
  "meta_description": "A concise meta description...",
  "body": "# Hello\\nThis is markdown."
}

PATCH /api/blogcontroller/{slug}/

{
  "lang_code": "ja",
  "primary_language": "en",
  "translation_languages": ["ja","fr","de","ko"],
  "title": "Updated title",
  "status": "PB",
  "categories": "Tech, AI",
  "tags": "django, automation",
  "meta_description": "Updated meta...",
  "body": "# Updated\nNew markdown content",
  "image_ids": ["0e809...", "0e884..."]
}

DELETE /api/blogcontroller/posts/{slug}/

Common Errors

Processing Notes

Mikihands Blogの一部機能は、処理に数秒〜数十秒かかる場合があります。これはAIが実際に計算処理を行い、その結果を反映する工程が含まれるためで、異常ではありません。

• • 反映が遅れることがあります: 保存/修正後、画面にすぐ表示されない場合があります。少し待ってから更新（再読み込み）すると反映されます。
• • 翻訳は順次処理されます: 複数の言語を選択した場合、言語ごとに生成されるため、全体の完了までに時間がかかることがあります。
• • AIの結果はレビュー推奨: AIは文脈を誤解したり、表現が不自然になることがあります。発行前のプレビューで最終確認を推奨します。
• • 画像/メタ情報: 自動生成された要素は、コンテンツに合わせていつでも修正できます。