PhotoUploads Developer API

API call

Request method

PhotoUploads API  calls can be done using the POST or GET request methods but since GET request are limited by the maximum allowed length of an URL you should prefer the POST request method.

Request URL

http://photouploads.com/api/1/<action>/

Parameters

  • key The API key, can be requested from our Cotact Form. Just request the key and let us know how you plan on using it.
  • action What you want to do [values: upload].
  • source Either a image URL or a base64 encoded image string. You can also use FILES["source"] in your request.
  • format Sets the return format [values: json (default), redirect, txt].

Example call

GET http://photouploads.com/api/1/upload/?key=12345&source=http://somewebsite/someimage.jpg&format=json

Note: Always use POST when uploading local files. Url encoding may alter the base64 source due to encoded characters or just by URL request length limit due to GET request.

API response

PhotoUploads API responses will vary depending on the format parameter:

  • json Display all the image uploaded information in JSON format. [default]
  • txt Returns the image direct URL in text/plain format.
  • redirect Redirects to the image viewer URL.

When using JSON the response will have headers status codes to allow you to easily notice if the request was OK or not. It will also output the status_txt and status_code properties.

Example response (JSON)

{
		"status_code": 200,
		"success": {
			"message": "image uploaded",
			"code": 200
		},
		"image": {
			"name": "example",
			"extension": "png",
			"size": 53237,
			"width": 1151,
			"height": 898,
			"date": "2014-06-04 15:32:33",
			"date_gmt": "2014-06-04 19:32:33",
			"storage_id": null,
			"description": null,
			"nsfw": "0",
			"md5": "c684350d722c956c362ab70299735830",
			"storage": "datefolder",
			"original_filename": "example.png",
			"original_exifdata": null,
			"views": "0",
			"id_encoded": "L",
			"filename": "example.png",
			"ratio": 1.2817371937639,
			"size_formatted": "52 KB",
			"mime": "image/png",
			"bits": 8,
			"channels": null,
			"url": "http://127.0.0.1/images/2014/06/04/example.png",
			"url_viewer": "http://127.0.0.1/image/L",
			"thumb": {
				"filename": "example.th.png",
				"name": "example.th",
				"width": 160,
				"height": 160,
				"ratio": 1,
				"size": 17848,
				"size_formatted": "17.4 KB",
				"mime": "image/png",
				"extension": "png",
				"bits": 8,
				"channels": null,
				"url": "http://127.0.0.1/images/2014/06/04/example.th.png"
			},
			"medium": {
				"filename": "example.md.png",
				"name": "example.md",
				"width": 500,
				"height": 390,
				"ratio": 1.2820512820513,
				"size": 104448,
				"size_formatted": "102 KB",
				"mime": "image/png",
				"extension": "png",
				"bits": 8,
				"channels": null,
				"url": "http://127.0.0.1/images/2014/06/04/example.md.png"
			},
			"views_label": "views",
			"display_url": "http://127.0.0.1/images/2014/06/04/example.md.png",
			"how_long_ago": "moments ago"
		},
		"status_txt": "OK"
	}

Example response (txt)

http://127.0.0.1/images/2014/06/04/example.png

API user upload workaround

PhotoUploads API one doesn't have a way to upload images associated with a given user but PhotoUploads will ba able to do this on a case by case basis Cotact Us with details how you plan on implimenting this.

編輯或通過點擊圖像預覽調整圖像大小
通過點擊圖像預覽來調整任意圖像
您可以從 你的電腦加入圖片連結 添加更多圖像.
您可以從 你的裝置, 截圖加入圖片連結添加更多圖像.
上傳中 0 圖片 (0% 完成)
佇列上傳中. 需要一點時間來完成
上傳完成
上傳的內容已經添加到 您已經可以使用剛剛上傳的建立新相簿
上傳的內容已經添加到
您已經可以使用剛剛上傳的建立新相簿 You must 建立新帳號 or 登入 to save this content into your account.
沒有圖片已經上傳
發生錯誤, 系統無法處理您的請求.
    取消取消剩下的
    注意: 部分圖片無法上傳. 了解更多
    檢查 錯誤報告 來了解更多訊息.
    JPG PNG BMP GIF 100 MB