500px APIの使い方まとめ (サンプルコード付き)

JSON

{"current_page":1,"total_pages":4,"total_items":8,"photos":[{"id":63974851,"user_id":7138035,"name":"GURDIAN DOG","description":"Gurdian dogs is in Japanese Temple.\nJapanese gods live in the temple.\n\nDogs protect them.\n\nSo They are cool and dignity...\n\nI love them","camera":"Canon EOS 5D Mark II","lens":null,"focal_length":"50","iso":"100","shutter_speed":"1/640","aperture":"5.6","times_viewed":79,"rating":37.9,"status":1,"created_at":"2014-03-16T10:59:18-04:00","category":11,"location":null,"latitude":35.7700541972717,"longitude":139.799137115479,"taken_at":"2014-03-16T15:07:06-04:00","hi_res_uploaded":2,"for_sale":true,"width":5616,"height":3744,"votes_count":12,"favorites_count":5,"comments_count":2,"nsfw":false,"sales_count":0,"for_sale_date":null,"highest_rating":60.3,"highest_rating_date":"2014-03-22T22:48:36-04:00","license_type":0,"converted":31,"collections_count":0,"crop_version":0,"privacy":false,"image_url":"https://drscdn.500px.org/photo/63974851/w%3D70_h%3D70/b1f4363d1b0ed5a851219c075d347dea?v=0","images":[{"size":1,"url":"https://drscdn.500px.org/photo/63974851/w%3D70_h%3D70/b1f4363d1b0ed5a851219c075d347dea?v=0","https_url":"https://drscdn.500px.org/photo/63974851/w%3D70_h%3D70/b1f4363d1b0ed5a851219c075d347dea?v=0","format":"jpeg"}],"url":"/photo/63974851/gurdian-dog-by-arata-kita","positive_votes_count":12,"converted_bits":31,"share_counts":{"pinterest":0,"facebook":0,"twitter":0},"location_details":{"country":["Japan"],"county":["北葛飾郡"],"state":[],"city":["Adachi"],"attraction":[]},"watermark":false,"image_format":"jpeg","licensing_requested":false,"user":{"id":7138035,"username":"aratakita","firstname":"Arata","lastname":"Kita","city":"","country":"Japan","usertype":0,"fullname":"Arata Kita","userpic_url":"https://pacdn.500px.org/7138035/484f23a3649b615f1025e283574da42b54e39518/1.jpg?1","userpic_https_url":"https://pacdn.500px.org/7138035/484f23a3649b615f1025e283574da42b54e39518/1.jpg?1","cover_url":"https://pacdn.500px.org/7138035/484f23a3649b615f1025e283574da42b54e39518/cover_2048.jpg?2","upgrade_status":0,"store_on":true,"affection":458,"avatars":{"default":{"https":"https://pacdn.500px.org/7138035/484f23a3649b615f1025e283574da42b54e39518/1.jpg?1"},"large":{"https":"https://pacdn.500px.org/7138035/484f23a3649b615f1025e283574da42b54e39518/2.jpg?1"},"small":{"https":"https://pacdn.500px.org/7138035/484f23a3649b615f1025e283574da42b54e39518/3.jpg?1"},"tiny":{"https":"https://pacdn.500px.org/7138035/484f23a3649b615f1025e283574da42b54e39518/4.jpg?1"}},"followers_count":20}},{"id":63972869,"user_id":7138035,"name":"SUNSET","description":"Japan has many amazing views.\r\nEspecially i love Sunset.\r\nU must see the AWESOME sunset in japan if u have never seen it...","camera":"Canon EOS 5D Mark II","lens":"","focal_length":"50","iso":"100","shutter_speed":"1/100","aperture":"22","times_viewed":71,"rating":31.5,"status":1,"created_at":"2014-03-16T10:42:23-04:00","category":18,"location":null,"latitude":35.775485962768,"longitude":139.809265136719,"taken_at":"2014-03-16T17:12:27-04:00","hi_res_uploaded":2,"for_sale":true,"width":5616,"height":3744,"votes_count":9,"favorites_count":1,"comments_count":0,"nsfw":false,"sales_count":0,"for_sale_date":null,"highest_rating":48.7,"highest_rating_date":"2014-03-23T01:30:32-04:00","license_type":0,"converted":31,"collections_count":0,"crop_version":0,"privacy":false,"image_url":"https://drscdn.500px.org/photo/63972869/w%3D70_h%3D70/ee5d98d1afce6489a36214b91f9a265a?v=0","images":[{"size":1,"url":"https://drscdn.500px.org/photo/63972869/w%3D70_h%3D70/ee5d98d1afce6489a36214b91f9a265a?v=0","https_url":"https://drscdn.500px.org/photo/63972869/w%3D70_h%3D70/ee5d98d1afce6489a36214b91f9a265a?v=0","format":"jpeg"}],"url":"/photo/63972869/sunset-by-arata-kita","positive_votes_count":9,"converted_bits":31,"share_counts":{},"location_details":{"country":[],"county":[],"state":[],"city":[],"attraction":[]},"watermark":false,"image_format":"jpeg","licensing_requested":false,"user":{"id":7138035,"username":"aratakita","firstname":"Arata","lastname":"Kita","city":"","country":"Japan","usertype":0,"fullname":"Arata Kita","userpic_url":"https://pacdn.500px.org/7138035/484f23a3649b615f1025e283574da42b54e39518/1.jpg?1","userpic_https_url":"https://pacdn.500px.org/7138035/484f23a3649b615f1025e283574da42b54e39518/1.jpg?1","cover_url":"https://pacdn.500px.org/7138035/484f23a3649b615f1025e283574da42b54e39518/cover_2048.jpg?2","upgrade_status":0,"store_on":true,"affection":458,"avatars":{"default":{"https":"https://pacdn.500px.org/7138035/484f23a3649b615f1025e283574da42b54e39518/1.jpg?1"},"large":{"https":"https://pacdn.500px.org/7138035/484f23a3649b615f1025e283574da42b54e39518/2.jpg?1"},"small":{"https":"https://pacdn.500px.org/7138035/484f23a3649b615f1025e283574da42b54e39518/3.jpg?1"},"tiny":{"https":"https://pacdn.500px.org/7138035/484f23a3649b615f1025e283574da42b54e39518/4.jpg?1"}},"followers_count":20}}]}

PHP

<?php

	// 設定項目
	$consumer_key = '' ;		// クライアントキー

	// パラメータ
	$params = array(
		'consumer_key' => $consumer_key ,
		'image_size' => '600' ,
		'rpp' => '20' ,
		'geo' => '35.681382,139.766084,500km' ,
	) ;

	// GETメソッドで指定がある場合
	foreach( array( 'only' , 'term' , 'geo' , 'rpp' , 'license_type' , 'sort' ) as $val )
	{
		if( isset( $_GET[ $val ] ) && $_GET[ $val ] != '' )
		{
			$params[ $val ] = $_GET[ $val ] ;
		}
	}

	// リクエストURL
	$request_url = 'https://api.500px.com/v1/photos/search' . '?' . http_build_query( $params ) ;		// リクエストURL

	// アイテムデータをJSON形式で取得する (CURLを使用)
	$curl = curl_init() ;

	// オプションのセット
	curl_setopt( $curl , CURLOPT_URL , $request_url ) ;
	curl_setopt( $curl , CURLOPT_HEADER, 1 ) ; 
	curl_setopt( $curl , CURLOPT_SSL_VERIFYPEER , false ) ;								// 証明書の検証を行わない
	curl_setopt( $curl , CURLOPT_RETURNTRANSFER , true ) ;								// curl_execの結果を文字列で返す
	curl_setopt( $curl , CURLOPT_TIMEOUT , 5 ) ;										// タイムアウトの秒数

	// 実行
	$res1 = curl_exec( $curl ) ;
	$res2 = curl_getinfo( $curl ) ;

	// 終了
	curl_close( $curl ) ;

	// 取得したデータ
	$json = substr( $res1, $res2['header_size'] ) ;										// 取得したデータ(JSONなど)
	$header = substr( $res1, 0, $res2['header_size'] ) ;								// レスポンスヘッダー (検証に利用したい場合にどうぞ)

	// HTML用
	$html = '' ;

	// JSONデータをオブジェクト形式に変換する
	$obj = json_decode( $json ) ;

	// 条件指定用フォーム
	$html .= '<h2>条件を指定する</h2>' ;
	$html .= '<p>条件を指定して、写真を検索してみて下さい。</p>' ;
	$html .= '<form>' ;
	$html .= 	'<p style="font-size:.9em; font-weight:700;"><label for="term">検索キーワード (term)</label></p>' ;
	$html .= 		'<p style="margin:0 0 1em;"><input id="term" name="term" placeholder="花火"></p>' ;
	$html .= 	'<p style="font-size:.9em; font-weight:700;"><label for="geo">位置座標 (geo)</label></p>' ;
	$html .= 		'<p style="margin:0 0 1em;"><input id="geo" name="geo" placeholder="35.681382,139.766084,500km"></p>' ;
	$html .= 	'<p style="font-size:.9em; font-weight:700;"><label for="rpp">取得件数 (rpp)</label></p>' ;
	$html .= 		'<p style="margin:0 0 1em;"><input id="rpp" name="rpp" value="20" placeholder="20"></p>' ;
	$html .= 	'<p style="font-size:.9em; font-weight:700;"><label for="only">カテゴリ名 (only)</label></p>' ;
	$html .= 		'<p style="margin:0 0 1em;"><input id="only" name="only" value="" placeholder="Animals"></p>' ;
	$html .= 	'<p style="font-size:.9em; font-weight:700;"><label for="license_type">ライセンス (license_type)</label></p>' ;
	$html .= 		'<p style="margin:0 0 1em;"><input id="license_type" name="license_type" value="" placeholder="1"></p>' ;
	$html .= 	'<p style="font-size:.9em; font-weight:700;"><label for="sort">ソート (sort)</label></p>' ;
	$html .= 		'<p style="margin:0 0 1em;"><input id="sort" name="sort" value="_score" placeholder="_score"></p>' ;
	$html .= 	'<p><button>検索する</button></p>' ;
	$html .= '</form>' ;

	// HTMLを作成
	$html .= '<h2>実行結果</h2>' ;

	// エラー判定
	if( !$obj || !isset($obj->photos) )
	{
		$html .= '<p>データを取得できませんでした…。設定を再確認して下さい。</p>' ;
	}
	else
	{
		foreach( $obj->photos as $item )
		{
			// 成人コンテンツをスキップ
			if( isset( $item->nsfw ) && $item->nsfw )
			{
				continue ;
			}

			// 各データ
			$id = $item->id ;		// メディアID
			$name = ( isset($item->name) ) ? $item->name : '' ;		// 写真のタイトル
			$description = ( isset($item->description) ) ? $item->description : '' ;		// 写真の説明
			$image_url = $item->image_url ;		// 写真のURL
			$created_at = $item->created_at ;		// 投稿日時

			// ユーザー情報
			$user_id = $item->user_id ;		// 投稿者ID
			$user_username = $item->user->username ;		// ユーザーネーム
			$user_avatars = ( isset($item->user->avatars->default->https) ) ? $item->user->avatars->default->https : '' ;		// アバター画像

			// 場所情報
			$country = ( isset($item->location_details->country[0]) ) ? $item->location_details->country[0] : '' ;		// 国名
			$latitude = ( isset($item->latitude) ) ? $item->latitude : '' ;		// 緯度
			$longitude = ( isset($item->longitude) ) ? $item->longitude : '' ;		// 緯度

			// 日付の整形
			$created_at = date( 'Y/m/d H:i' , strtotime( $created_at ) ) ;

			// ブラウザに出力
			$html .= '<dl>' ;
			$html .= 	'<dt>投稿者のID</dt>' ;
			$html .= 		'<dd>' . $user_id . '</dd>' ;
			$html .= 	'<dt>投稿者のユーザーネーム</dt>' ;
			$html .= 		'<dd><a href="https://500px.com/' . $user_username . '" target="_blank">' . $user_username . '</a></dd>' ;

			// アイコン画像がある場合
			if( $user_avatars )
			{
				$html .= 	'<dt>投稿者のアイコン</dt>' ;
				$html .= 		'<dd><img class="_img" src="' . $user_avatars . '" width="auto" height="75"></dd>' ;
			}

			$html .= 	'<dt>写真</dt>' ;
			$html .= 		'<dd><img class="_img" src="' . $image_url . '"></dd>' ;

			// 写真のタイトル
			if( $name )
			{
				$html .= 	'<dt>写真のタイトル</dt>' ;
				$html .= 		'<dd>' . $name . '</dd>' ;
			}

			// 写真の説明
			if( $description )
			{
				$html .= 	'<dt>写真の説明</dt>' ;
				$html .= 		'<dd>' . $description . '</dd>' ;
			}

			// 場所名がある場合
			if( $country )
			{
				$html .= 	'<dt>国名</dt>' ;
				$html .= 		'<dd>' . $country . '</dd>' ;
			}

			// 緯度、経度がある場合
			if( $latitude && $longitude )
			{
				$html .= 	'<dt>地図</dt>' ;
				$html .= 		'<dd><a href="https://www.google.co.jp/maps/@' . $latitude . ',' . $longitude . ',15z" target="_blank">Google Mapsで位置を確認する</a></dd>' ;
			}

			$html .= 	'<dt>投稿日時</dt>' ;
			$html .= 		'<dd>' . $created_at . '</dd>' ;

			$html .= '</dl>' ;
		}
	}

	// 取得したデータ
	$html .= '<h2>取得したデータ</h2>' ;
	$html .= '<p>下記のデータを取得できました。</p>' ;
	$html .= 	'<h3>JSON</h3>' ;
	$html .= 	'<p><textarea rows="8">' . $json . '</textarea></p>' ;
	$html .= 	'<h3>レスポンスヘッダー</h3>' ;
	$html .= 	'<p><textarea rows="8">' . $header . '</textarea></p>' ;

?>

<?php
	// ブラウザに[$html]を出力 (HTMLのヘッダーとフッターを付けましょう)
	echo $html ;
?>