https://github.com/500px/legacy-api-documentation

This is the 500px API documentation.
https://github.com/500px/legacy-api-documentation

api oauth photos

Last synced: 6 months ago
JSON representation

This is the 500px API documentation.

• Host: GitHub
• URL: https://github.com/500px/legacy-api-documentation
• Owner: 500px
• Created: 2012-05-28T22:17:35.000Z (about 14 years ago)
• Default Branch: master
• Last Pushed: 2019-07-30T17:05:00.000Z (almost 7 years ago)
• Last Synced: 2024-05-23T04:41:14.581Z (about 2 years ago)
• Topics: api, oauth, photos
• Size: 582 KB
• Stars: 22
• Watchers: 30
• Forks: 9
• Open Issues: 97
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

          
# 500px API

500px API provides programmatic access to 500px functionality and content.

Version 1 of the API is limited to the essentials of the website's functionality: viewing feature streams, photo information and comments, as well as user profiles.

The API is [REST API](http://en.wikipedia.org/wiki/Representational_State_Transfer "RESTful")

and uses [OAuth](http://oauth.net/ "OAuth") 1.0a for user authentication purposes.

Currently, return format for all endpoints is [JSON](http://json.org/ "JSON").

You can try our API in [console](http://bitly.com/api500px) ([http://bitly.com/api500px](http://bitly.com/api500px))

See [status.500px.com](http://status.500px.com) for API status updates, outages, and scheduled maintenance.

***

## Basics

- **[Formats and Terms](https://github.com/500px/api-documentation/blob/master/basics/formats_and_terms.md)**

- **[API Terms of Use](https://github.com/500px/api-documentation/blob/master/basics/terms_of_use.md)**

- **[Uploading photos](https://github.com/500px/api-documentation/blob/master/basics/upload.md)**

## Examples

- **[JavaScript](http://500px.github.com/500px-js-sdk)**

- **[iOS](https://github.com/500px/api-documentation/blob/master/examples/iOS/API%20Tutorials.md)**

- **[Ruby](https://github.com/500px/api-documentation/blob/master/examples/Ruby/)**

- **[PHP](https://github.com/500px/api-documentation/blob/master/examples/PHP/PHP.md)**

## Changes

* 2017-12-12 Deprecated the old upload flow with `upload_key` and [replaced with new one](https://github.com/500px/api-documentation/blob/master/basics/upload.md)

* 2014-03-27 Deprecated photo object's image_url key.

## SDK

- **[JavaScript](https://github.com/500px/500px-js-sdk)**

- **[Android](https://github.com/500px/500px-android-sdk)**

- **[iOS](https://github.com/500px/500px-iOS-api)**

## Endpoints

#### Photo Resources

- **[GET photos](https://github.com/500px/api-documentation/blob/master/endpoints/photo/GET_photos.md)**

- **[GET photos/search](https://github.com/500px/api-documentation/blob/master/endpoints/photo/GET_photos_search.md)**

- **[GET photos/:id](https://github.com/500px/api-documentation/blob/master/endpoints/photo/GET_photos_id.md)**

- **[GET photos/:id/comments](https://github.com/500px/api-documentation/blob/master/endpoints/photo/GET_photos_id_comments.md)**

- **[GET photos/:id/votes](https://github.com/500px/api-documentation/blob/master/endpoints/photo/GET_photos_id_votes.md)**

- **[PUT photos/:id](https://github.com/500px/api-documentation/blob/master/endpoints/photo/PUT_photos_id.md)**

- **[POST photos](https://github.com/500px/api-documentation/blob/master/endpoints/photo/POST_photos.md)**

- **[POST photos/:id/vote](https://github.com/500px/api-documentation/blob/master/endpoints/photo/POST_photos_id_vote.md)**

- **[DELETE photos/:id/vote](https://github.com/500px/api-documentation/blob/master/endpoints/photo/DELETE_photos_id_vote.md)**

- **[POST photos/:id/tags](https://github.com/500px/api-documentation/blob/master/endpoints/photo/POST_photos_id_tags.md)**

- **[POST photos/:id/comments](https://github.com/500px/api-documentation/blob/master/endpoints/photo/POST_photos_id_comments.md)**

- **[POST photos/:id/report](https://github.com/500px/api-documentation/blob/master/endpoints/photo/POST_photos_id_report.md)**

- **[DELETE photos/:id](https://github.com/500px/api-documentation/blob/master/endpoints/photo/DELETE_photos_id.md)**

- **[DELETE photos/:id/tags](https://github.com/500px/api-documentation/blob/master/endpoints/photo/DELETE_photos_id_tags.md)**

#### User Resources

- **[GET users](https://github.com/500px/api-documentation/blob/master/endpoints/user/GET_users.md)**

- **[GET users/show](https://github.com/500px/api-documentation/blob/master/endpoints/user/GET_users_show.md)**

- **[GET users/:id/friends](https://github.com/500px/api-documentation/blob/master/endpoints/user/GET_users_id_friends.md)**

- **[GET users/:id/followers](https://github.com/500px/api-documentation/blob/master/endpoints/user/GET_users_id_followers.md)**

- **[GET users/search](https://github.com/500px/api-documentation/blob/master/endpoints/user/GET_users_search.md)**

- **[POST users/:id/friends](https://github.com/500px/api-documentation/blob/master/endpoints/user/POST_users_id_friends.md)**

- **[DELETE users/:id/friends](https://github.com/500px/api-documentation/blob/master/endpoints/user/DELETE_users_id_friends.md)**

#### Gallery Resources

- **[GET users/:user_id/galleries](https://github.com/500px/api-documentation/blob/master/endpoints/galleries/GET_galleries.md)**

- **[GET users/:user_id/galleries/:id](https://github.com/500px/api-documentation/blob/master/endpoints/galleries/GET_galleries_id.md)**

- **[GET users/:user_id/galleries/:id/items](https://github.com/500px/api-documentation/blob/master/endpoints/galleries/GET_galleries_id_items.md)**

- **[GET users/:user_id/galleries/:id/share_url](https://github.com/500px/api-documentation/blob/master/endpoints/galleries/GET_galleries_id.md)**

- **[PUT users/:user_id/galleries/:id](https://github.com/500px/api-documentation/blob/master/endpoints/galleries/PUT_galleries_id.md)**

- **[PUT users/:user_id/galleries/:id/items](https://github.com/500px/api-documentation/blob/master/endpoints/galleries/PUT_galleries_id_items.md)**

- **[PUT users/:user_id/galleries/reposition](https://github.com/500px/api-documentation/blob/master/endpoints/galleries/PUT_galleries_reposition.md)**

- **[POST users/:user_id/galleries](https://github.com/500px/api-documentation/blob/master/endpoints/galleries/POST_galleries.md)**

- **[DELETE users/:user_id/galleries/:id](https://github.com/500px/api-documentation/blob/master/endpoints/galleries/DELETE_galleries_id.md)**

#### Collections/Sets Resources

- **DEPRECATED**.  Please use [Gallery Resources](#gallery-resources) instead

#### Comment Resources

- **[POST comments/:id/comments](https://github.com/500px/api-documentation/blob/master/endpoints/comments/POST_comments_id_comments.md)**

## Directory API

You can also programmatically access the [500px Directory](https://500px.com/directory). The Directory allows you to contact photographers and search for photographers by speciality, availability, service rates, language, camera, and other information. To gain access to the Directory API please contact sales@500px.com.

## Authentication

- **[POST oauth/request_token](https://github.com/500px/api-documentation/blob/master/authentication/POST_oauth_requesttoken.md)**

- **[POST oauth/authorize](https://github.com/500px/api-documentation/blob/master/authentication/POST_oauth_authorize.md)**

- **[POST oauth/access_token](https://github.com/500px/api-documentation/blob/master/authentication/POST_oauth_accesstoken.md)**

- **[Upload key](https://github.com/500px/api-documentation/blob/master/authentication/upload_key.md)**

## FAQ

### What do I need to know before I start using the API?

Got rust on your skills? No worries. Here are the docs you might need to get started:

- HTTPS protocol

- [REST software pattern][]

- Authentication with [OAuth][] (or the official [Beginner’s Guide][])

- Data serialization with [JSON][] (or see a [quick tutorial][])

### How do I connect to the 500px.com API?

The API is only available to authenticated clients. Clients should authenticate users using [OAuth][]. Once authenticated, you need to request a resource from one of the endpoints using HTTPS. Generally, reading any data is done through a request with GET method. If you want our server to create, update or delete a given resource, POST or PUT methods are required.

### What return formats do you support?

500px API currently returns data in [JSON](http://json.org/ "JSON") format.

### What kind of authentication is required?

Applications must identify themselves to access any resource.

If your application only needs read-only access and does not authenticate the user, **consumer_key** containing a valid Consumer Key parameter should be specified in the query string. Otherwise, [OAuth](https://github.com/500px/api-documentation/tree/master/authentication) or upload key authentication takes care of identifying the application as well as the user accessing the API.

### Is there a request rate limit?

There is a rate limit of 1,000,000 API requests per month per account. We will contact you and, if required, disable your application if we find that your application is exceeding this limit or interfering with our system's stability. This revised rate limit came into effect May 1, 2014.

[REST software pattern]: http://en.wikipedia.org/wiki/Representational_State_Transfer

[OAuth]: http://oauth.net/core/1.0a/

[Beginner’s Guide]: http://hueniverse.com/oauth/

[JSON]: http://json.org

[quick tutorial]: http://www.webmonkey.com/2010/02/get_started_with_json/

[Register your application]: http://500px.com/settings/applications

[API Terms of Use]: https://github.com/500px/api-documentation/blob/master/basics/terms_of_use.md

[See if the concepts used by the API are familiar to you]: https://github.com/500px/api-documentation#what-do-i-need-to-know-before-i-start-using-the-api