フォトストックに投稿する画像ファイルをアップロードします。
アップロードした画像はフォトストックの投稿および投稿更新で利用します。
呼び出しURL
{your-domain} の部分をご利用の環境にあわせて変更してください。
https://{your-domain}/h2/STRPhotoStockManipurator.doリクエスト
| パラメータ | 意味 | 必須 | 制約 |
|---|---|---|---|
func | 動作モード | 〇 | upload を指定します。 |
key | WebAPIキー | 〇 | フォトストック操作が可能なWebAPIキーを指定します。 |
data | アップロードデータ | 〇 | アップロードする画像を指定します。 |
補足事項
- ファイルのアップロードが必要なため、フォームデータのPOST時には必ず multipart/form-data形式 で送信する必要があります。
- アップロードした画像は、フォトストックの投稿APIで投稿しない場合、2時間経過した時点で自動削除されます。
レスポンス
APIの呼び出し結果は JSON形式 で返されます。
{
"sha256": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
"length": "99999",
"mediaId": "UUID of the photo",
"contentType": "image/jpeg",
"timestamp": "yyyy-MM-dd HH:mm:ss"
}| 要素 | 意味 | 備考 |
|---|---|---|
sha256 | ハッシュ値 | |
length | 画像サイズ | |
mediaId | アップロード画像のID | フォトストックの投稿APIでは、このIDを指定して投稿します。 |
contentType | 画像ファイル形式 | |
timestamp | 登録日時 | 日付/時刻は yyyy-MM-dd HH:mm:ss 形式のUTC時刻で返されます。 |
成功時のレスポンス例
{
"sha256": "0239b6e710d94e2443f267175015a8222aefbadac37ab08956e46a4611ae9891",
"length": 194707,
"mediaId": "5e8710ea-ccda-437b-b98b-f471d5ea6df4",
"contentType": "image/jpeg",
"timestamp": "2020-11-25 23:09:45"
}