... h1. SmugMug's API h3. About SmugMug's API allows you to read from and write to SmugMug for your own applications. You'll need an [API Key|http://www.smugmug.com/hack/apikeys] to get started, and need to use REST, JSON, serialized PHP , or XML-RPC to interact with the service. SmugMug \*highly\* recommends using REST, JSON, or serialized PHP....
|
h3. Accounts
|
Anyone building something for all SmugMug customers to use, we'll start you off with a free full featured Pro account with all the bells and whistles for 1-year\! If your application becomes one of our most popular, we'll make that account free even longer :-) Simply drop us a note (markham at smugmug dot com) letting us know what your application will do and a link to some of your prior work.
|
Already have an account? Just include it in your email.
|
...
|
h3. Commercial Applications
|
We're thrilled that you want to build your business on top of SmugMug. Contact us (Same email as above) first for approval or clarification.
|
h3. User-Agent
|
... {color:#ff0000}{*}IMPORTANT:*{color} Please send along your own custom User-Agent string on all requests, including version number, so we can help our customers out who might be using your application. Thanks\! h3. Feeds Often, if you just want to read data and not write it, it's often easier to just grab and parse one of our feeds. Sorry the documentation is a little weak, do feel free to ask on dgrin about more details (or even write up a better page yourself\!). See our [feeds page|http://wiki.smugmug.net/display/SmugMug/Feeds] for more info on the actual feeds.
|
h3. Uploading
|
We have a special page on [uploading|SmugMug:Uploading] [uploading|API:Uploading] photos to SmugMug since that can be a little confusing.
|
h3. Documentation
|
... And, of course, we have documentation on all of the SmugMug API methods. Current versions are: * [Release - 1.2.0|API 1.2.0] * [Beta - 1.2.1|API 1.2.1] (see this dgrin thread until documentation has been updated) * [Beta - 1.2.2|http://wiki.smugmug.net/display/API/API+1.2.2] (with [OAuth|http://wiki.smugmug.net/display/API/OAuth]) h3. Updates * [The official SmugMug API blog|http://blogs.smugmug.com/api/] * The API Announce mailing list h3. Discussion * [The Digital Grin (dgrin) API message forum|http://www.dgrin.com/forumdisplay.php?f=25] * [The API Discussion mailing list|https://mail.smugmug.net/mailman/listinfo] h3.
|
|
|
h3. [Hacks and Applications|http://wiki.smugmug.com/display/SmugMug/Hacks+and+Apps]
|
... * Lots of people have made some [awesome hacks and applications|http://wiki.smugmug.com/display/SmugMug/Hacks+and+Apps] for SmugMug\! h3. Future * Looking for a new feature? Check the SmugBugs? and the API Feature Requests page and add it.
|