- GoogleAppEngine上で動作する画像アップロードサーバーです。
- オリジナル画像の保存、サムネイルの生成を行います。
- Google製のPaaSです。
- この画像サーバーはAppEngineの
BlobStore、Images Serviceを利用しています。- BlobStore: https://cloud.google.com/appengine/docs/go/blobstore/
- CloudStorageへのファイルアップロード機能を簡単に実装できます
- ファイルへのアクセスにはアップロード時に発行される
BlobKeyを使用します。
- Images: https://cloud.google.com/appengine/docs/go/images/
BlobStoreにアップロードされた画像ファイルのサムネイルを作成します。- 0～1600pxの間で自由なサイズのサムネイルを動的に取得できます。
- BlobStore: https://cloud.google.com/appengine/docs/go/blobstore/
- BlobStoreに画像アップロードするためのURLを取得します。
- 署名によるクライアント認証を行います。
- accessKey: アクセスキー
- signature: 署名
- expires: 署名の有効期限
/upload?accessKey=eKWuZo6wDXJyuciVQkHMu6Bd5eZLLukh&expires=1414857216&signature=PtemPdruhb3d%2Bq5AoiAQRIBDR9oO5BzukmQ4D5GcINo%3D
署名の情報をリクエストヘッダーに含めることもできます。
- X-Imageserver-Access-Key: アクセスキー
- X-Imageserver-Signature: 署名
- X-Imageserver-Expires: 署名の有効期限
- status: ステータスコード（HTTPレスポンスと同じ)
- message: エラーメッセージ
- result
- upload_url: アップロード用URL
{
"status": 200,
"message": "OK",
"result": {
"upload_url": "http://example.appspot.com/_ah/upload/?accessKey=eKWuZo6wDXJyuciVQkHMu6Bd5eZLLukh&expires=1414857216&signature=PtemPdruhb3d%2Bq5AoiAQRIBDR9oO5BzukmQ4D5GcINo%3D/AMmfu6bjD2nDqtT1nX8nws4-ImEPQluohIFjqSAnsEQOrglUu-Ma63R_gH4Hs0CZ5DqsGe6typbyc5ZmHhE2bzcHBcukhbBSAWTrMtz0PFH0vEPd7To955VeZWYB-FBt50umy6yQthFg/ALBNUaYAAAAAVFT8OVElO0ebF3GPOVWRDbhAcf7Fc85o/"
}
}
- accessKeyとexpiresの間に"&"を入れた文字列(message)を作ります。
- secretKeyをキーにし、messageのHMAC-SHA256のハッシュ値を求めます。
- ハッシュ値をさらにbase64エンコードします。
- さらにURLエンコードしてクエリパラメータに設定します。
message = accessKey + "&" + expires
urlencode(base64(hmac-sha256(message, secretKey)))
サーバー側の時刻と比較し、期限が切れていた場合はエラーを返します。
- index.yaml を参考にしてDataStoreに
accessKeyとsecretKeyをDeveloper Consoleから直接入力してエンティティを作成してください。 accessKeyにはインデックスを設定してください。secretKeyには不要です。
GET /uploadで取得できたURLに画像ファイルをPOSTします。- AppEngineにより長いURLが発行されるため、認証は行っていません。
multipart/form-data 形式。
- file: 画像ファイル
- status: ステータスコード（HTTPレスポンスと同じ)
- message: エラーメッセージ
- result
- origin_url: オリジナル画像のURL
- origin_size: アップロードした画像のファイルサイズ
- filename: アップロードした画像のファイル名
- content_type: アップロードした画像のMIMEタイプ
- thumb_url: サムネイルのURL
{
"status": 200,
"message": "OK",
"result": {
"origin_url": "https://example.appspot.com/image?blobKey=AMIfv96V2rPci4U9WoK-HmfAaFbcdSTPwcQot-yfq0Op9Auz3QSkNp4mzvQXGrl8-kgRkKTDtPYVChvq9ALIrhebrC0vAjyiym7LSXIQsk2ipcT00fur7aa1Y-bUALqI78FDqG-KkqskKVxzkjmXkw4iwyE_Kje15ygtf9BhfJXWb3jxe7XKy6A",
"origin_size": 583122,
"filename": "G0017228.JPG",
"content_type": "image/jpeg",
"thumb_url": "https://lh5.ggpht.com/hmCTZkntu1SO929RgUZJbrJd5B1QgSe57Cw3fTD4u-MA10SexhV4CAlz1r6bMROkiAGhl_nqu940fwpomEArDeG5HB0SWQ"
}
}
- BlobStoreからオリジナル画像を取り出します。
- AppEngineにより長いオブジェクトキーが発行されるため、認証は行っていません。
- blobKey: BlobStoreのKey
/image?blobKey=AMIfv97ZUCKTJf1-AdenPtrCbXCJkfyxzw0LVjJxY-4KLEWGHu67aZRZKwkW3Itkda9esI3Wt1jKvJ2Usr0E5h4NfFCYV7-J5VJJC_deaJFqLlfPAQYWqatZaWtcM_JLOq6drJ6__8CTTQAb5gRTyUZJYA0ZeSa2XDGyR98UfswpNWhnVX_m4bo
- BlobStoreからオリジナル画像を削除します。
- 署名によるクライアント認証を行います。
- blobKey: BlobStoreのKey
/image?blobKey=AMIfv97ZUCKTJf1-AdenPtrCbXCJkfyxzw0LVjJxY-4KLEWGHu67aZRZKwkW3Itkda9esI3Wt1jKvJ2Usr0E5h4NfFCYV7-J5VJJC_deaJFqLlfPAQYWqatZaWtcM_JLOq6drJ6__8CTTQAb5gRTyUZJYA0ZeSa2XDGyR98UfswpNWhnVX_m4bo
0〜1600ピクセルの間で画像サイズを指定できます。GoogleAppEngineのドキュメントを参照してください。 https://cloud.google.com/appengine/docs/go/images/#Go_Serving_and_re-sizing_images_from_the_Blobstore
URLは以下の様になります。オリジナル画像をアップロードしたAppEngineとは別インスタンス（おそらくPicasa）になります。
http://your_app_id.appspot.com/randomStringImageId
URLの末尾に=sxxxもしくは=sxxx-cを加えることでサムネイル画像のサイズを自由に指定できます。
// Resize the image to 32 pixels (aspect-ratio preserved)
http://your_app_id.appspot.com/randomStringImageId=s32
// Crop the image to 32 pixels
http://your_app_id.appspot.com/randomStringImageId=s32-c
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent