画像共有サービス「imgx」の機能を外部アプリケーションから利用するためのAPIドキュメントです。
CORSに対応しており、JavaScript (Fetch API) から直接呼び出すことが可能です。
画像アップロード
POST /api/upload.php
画像をアップロードします。複数ファイルの同時アップロードに対応しています。
リクエストパラメータ
| パラメータ | 必須 | 説明 |
|---|---|---|
files[] | Yes | 画像ファイルデータ（multipart/form-data）。fileでも可。 |
api_key | Optional | APIキー。未指定の場合はゲスト投稿となります。 |
visibility | Optional | public (全体公開) または unlisted (限定公開)。デフォルトは unlisted。 |
使用例 (curl)
curl -X POST https://imgx.site/api/upload.php \ -H "X-API-KEY: your_api_key_here" \ -F "files[]=@/path/to/image1.jpg" \ -F "files[]=@/path/to/image2.png"
使用例 (JavaScript / Fetch)
const formData = new FormData();
formData.append('file', fileInput.files[0]);
formData.append('visibility', 'public');
fetch('https://imgx.site/api/upload.php', {
method: 'POST',
headers: { 'X-API-Key': 'YOUR_API_KEY' }, // ヘッダーまたはPOST値で送信
body: formData
})
.then(response => response.json())
.then(data => console.log(data));
レスポンス例
{
"success": true,
"results": [
{
"success": true,
"id": "a1b2c3d4",
"url": "https://imgx.site/i/a1b2c3d4.jpg",
"page_url": "https://imgx.site/p/a1b2c3d4",
"delete_url": "https://imgx.site/delete/a1b2c3d4/token...",
"mime": "image/jpeg"
}
]
}
画像情報の取得
GET /api/info.php
画像のメタデータ（サイズ、作成日、閲覧数など）を取得します。
GET /api/info.php?id={image_id}
エラーハンドリング
APIはHTTPステータスコードを返します。
200 OK: 成功400 Bad Request: パラメータ不足、ファイルなし401 Unauthorized: APIキーが無効405 Method Not Allowed: 許可されていないメソッド (GET/POST間違いなど)500 Internal Server Error: サーバーエラー
