NILTO

ヘルプセンター

メディアをアップロードする（POST /media）

基本情報

ベータ版機能について

この機能はベータ版での提供となっており、動作が不安定な場合があります。
また、今後互換性を保たない変更が加わる可能性があります。

あらかじめご了承いただいた上でのご利用をお願いいたします。

メディアファイルを1件アップロードします。

POST/v1/media

https://cms-api.nilto.com/v1/media

リクエスト

リクエストパラメータ

X-NILTO-API-KEY

X-NILTO-API-KEY

NILTO APIキー。

スペース設定のAPIキー画面で取得することができます。

alt

string

alt属性の入力値を指定します。

file必須

string <binary>
アップロードするメディアファイル。
最大サイズ: 32MB

リクエスト例

curl
curl -X POST "https://cms-api.nilto.com/v1/media?alt=画像の説明文" \
     -H "X-NILTO-API-KEY: 0000000000000000000000" \
     -F "file=@/path/to/your/image.jpg"

レスポンス

200 OK

id

integer

コンテンツID

url

string

メディアのURL

400 Bad Request

status

string
Value: "400"
HTTPステータスコード

code

string
Value: "BadRequest"
エラーを識別するためのコード

401 Unauthorized

status

string
Value: "401"
HTTPステータスコード

code

string
Value: "Unauthorized"
エラーを識別するためのコード

402 Payment Required

status

string
Value: "402"
HTTPステータスコード

code

string
Value: "Payment Required"
エラーを識別するためのコード

403 Forbidden

status

string
Value: "403"
HTTPステータスコード

code

string
Value: "Forbidden"
エラーを識別するためのコード

404 Not Found

status

string
Value: "404"
HTTPステータスコード

code

string
Value: "Not Found"
エラーを識別するためのコード

429 Too Many Requests

status

string
Value: "429"
HTTPステータスコード

code

string
Value: "Too Many Requests"
エラーを識別するためのコード

message

string
次のリクエストが可能になるまでの残り秒数を含むメッセージ。 秒数そのものはretry-afterヘッダーで返されます。

500 Internal Server Error

status

string
Value: "500"
HTTPステータスコード

code

string
Value: "Internal Server Error"
エラーを識別するためのコード

レスポンス例

200
{
   "id": 1234567890,
   "url": "https://cms-assets.nilto.com/spaces/1234567890/media/2345678901/_/abc.png"
}
400
{
   "status": "400",
   "code": "BadRequest"
}
401
{
   "status": "401",
   "code": "Unauthorized"
}
402
{
   "status": "402",
   "code": "Payment Required"
}
403
{
  "status": "403",
  "code": "Forbidden"
}
404
{
  "status": "404",
  "code": "Not Found"
}
429
{
  "status": "429",
  "code": "Too Many Requests",
  "message": "Expected available in 58 seconds."
}
500
{
  "status": "500",
  "code": "Internal Server Error"
}

お困りごとは解決しましたか？

解決しない場合は、サポートへお問い合わせください。

サポートに問い合わせる

目次