Pikchur.Dev.Blog

You can now use Pikchur on Tweetbot 1.2!

If you already use them, simply go to your “Account Settings” > Select Photo & Video Upload and choose Pikchur. 

If not you can download them here!

As always, feel to reach out to info@pickhur.com if ya have any questions or feedback!

~Pikchur Team 

So you want to add Pikchur to your next App? Great!

Our API mimics the ones you already integrated in the past, and all you need to do is

• Change API End point to http://api.pikchur.com/simple/upload
• Add Parameter api_key, to gain access, can be found here http://pikchur.com/api
• Optional: Add Parameter source
• Optional: Add parameter return_format values json or xml (xml is default)

Also, when you have your app, we can add you to our supported apps page! :)

You have two API options.

• 1) Upload, this is your standard method for Twitter clients, you upload to us we post to users synced accounts -except- there one used to authenticate with (in this case twitter, because you already post to it.).
• 2) Upload & Post, this method is used to post to all accounts synced to the user, including there twitter account.

Documentation

upload

This is used if the application wants to post the status message it sent for the authenticated service. For example if you use this with an authentication for “Twitter” we will not post a note to Twitter but the photo will still propagate out to the users remaining synced services (facebook, flickr, etc).

Endpoint XML:    http://api.pikchur.com/simple/upload

Required Parameters: 

• media
  • Binary image/video data
    • The image/video data to be posted.

• username
  • Text Value
    • This is the username for the synced service (default is Twitter). 

• password
  • Text Value
    • This is the password for the synced service (default is Twitter).

    Username/Password OR if using Twitter’s echo oAuth system please include the following headers

• X_VERIFY_CREDENTIALS_AUTHORIZATION
  • HEADER, Should contain the following

          oauth_consumer_key=”YOUR KEY HERE”, 

          oauth_signature_method=”HMAC-SHA1”, 

          oauth_token=”YOUR TOKEN HERE”, 

          oauth_timestamp=”TIMESTAMP”, 

          oauth_nonce=”OAUTH NONCE”, 

          oauth_version=”1.0”, 

          oauth_signature=”SIGNATURE”

• EXAMPLEcurl -v -H ‘X-Verify-Credentials-Authorization:oauth_version=”1.0”, oauth_nonce=”a436ee1ee9437e98ffafa04f39af2a69”, oauth_timestamp=”1274233993”, oauth_consumer_key=”BdkEXpkerXPqJMaiYMN3Q”, oauth_token=”16056271-aVl42OcvOA81cjdBpFy2yaLzmjLiNwSSByMXvh…”, oauth_signature_method=”HMAC-SHA1”, oauth_signature=”LiG5LqZO1Zprc6fJmVci%2FmXIwuk%3D”’ -F ‘api_key=O1kXlYN1SYQG82ZXtvZC0g’ -F ‘media=@/var/test.jpg’ -F ‘message=Hello World!’ http://api.pikchur.com/simple/upload

• api_key
  • Text Value
    • A Pikchur API developer key, which is used to prevent abuse. It can easily be obtained here: http://pikchur.com/api#key

Optional Parameters: 

• message
  • Media Caption

• service
  • Text Value
    • If the service requested for authentication is not Twitter, it can be specified by sending it along with the request. i.e: identi.ca,plurk, etc

• X_AUTH_SERVICE_PROVIDER 
  • HEADER
    • The service to auth with (default is https://api.twitter.com/1/account/verify_credentials.json). 
• source
  • Text Value
    • Request a source id from api[at]Pikchur.com and all photos sent in will say “Via yourApp” and link to your website.

• private
  • Text Value
    • Overrides users media privacy settings for this one upload. Options “YES” for enable privacy “NO” to make media public.

Sample response

<rsp status=”ok”>

    <mediaid>

          abc

    </mediaid>

    <mediaurl>

          http://pk.gd/abc

   </mediaurl>

</rsp>

uploadAndPost

Used to authenticate and post a photo to the user’s Pikchur account, along with a status update to Twitter and any other supported service users have synched.

(If the service requested for authentication is not Twitter, it can be specified by sending it along with the request, such as identi.ca, plurk, etc.)

Please make sure all data sent is formatted as multipart/form-data.

Endpoint XML:    http://api.pikchur.com/simple/uploadAndPost

Required Parameters: 

• username
  • Text Value
    • This is the username for the synced service (default is Twitter). 

• password
  • Text Value
    • This is the password for the synced service (default is Twitter).

• media
  • Binary image/video data
    • The image/video data to be posted.

• api_key
  • Text Value
    • A Pikchur API developer key, which is used to prevent abuse. It can easily be obtained here: http://pikchur.com/api#key

Optional Parameters: 

• message
  • Media Caption / message to post to Twitter or any other service. The URL to the image will be appended to the message

• service
  • Text Value
    • If the service requested for authentication is not Twitter, it can be specified by sending it along with the request. i.e: identi.ca,plurk, etc

• source
  • Text Value
    • Request a source id from api[at]Pikchur.com and all photos sent in will say “Via yourApp” and link to your website.

• private
  • Text Value
    • Overrides users media privacy settings for this one upload. Options “YES” for enable privacy “NO” to make media public.

Sample response

<rsp status=”ok”>

    <mediaid>

          abc

    </mediaid>

    <mediaurl>

          http://pk.gd/abc

   </mediaurl>

</rsp>

So, you want to convert our URL’s to usable source urls of the media?

We gotcha..

Converting URLs

Photo URLS

• http://pk.gd/<media_id>
• http://pikchur.com/<media_id>

    - Thumb (48X48) http://img.pikchur.com/pic_<media_id>_t.jpg

    - Small (170XScale) http://img.pikchur.com/pic_<media_id>_s.jpg

    - Medium (320XScale) http://img.pikchur.com/pic_<media_id>_m.jpg

    - Large (600XScale) http://img.pikchur.com/pic_<media_id>_l.jpg

    - Original  http://img.pikchur.com/pic_<media_id>_o.jpg (PRO Only)

For example : http://pk.gd/l00    Converts to http://img.pikchur.com/pic_l00_l.jpg

Video URLS

• http://mp.gd/<media_id>
• http://pikchur.com/v/<media_id>

    - Thumb Image (48X48) http://vid.pikchur.com/vid_<media_id>_t.jpg

    - Small  Image  (170XScale) http:// vid .pikchur.com/ vid _<media_id>_s.jpg

    - Medium  Image  (320XScale) http:// vid .pikchur.com/ vid _<media_id>_m.jpg

    - Large  Image  (600XScale) http:// vid .pikchur.com/ vid _<media_id>_l.jpg

    - MP4  http://vid.pikchur.com/pic_<media_id>.mp4

For example : http://mp.gd/aoi    Converts to  http://vid.pikchur.com/vid_aoi.mp4  (Thumbnail @  http://vid.pikchur.com/vid_aoi_t.jpg)

As always feel free to drop us a line if you need help @ Support@Pikchur.com

We recently received a few request with people asking us how it is you go about editing your photos contrast, red eye, rotate or even crop on Pikchur.com

So we decided to write this short 3 step post on how to get started.

Step 1: Login, Go to your photo and click “Edit Photo”

Step 2: Go to the bottom and Click “Edit With Picnik”

Step 3 Begin to edit!

And thats it! 

Hope that helps, as always thanks for choosing Pikchur :)

Sorry for the late post, we sent out word that we support the new echo Auth functionality twitter released but forgot to write a blog post about it. 

For documentation on how to integrate the new support please review our API Docs @ : http://bit.ly/dbWGQe  

Feel free to reach us any time @ API@Pikchur.com for support/feedback.

~The Pikchur Crew

Hey guys, 

As you know Twitter for the iPhone is out, and allows for “custom” photo posting. To Add Pikchur support to your Account simple follow the steps below. 

First Click More

Next Click Settings

Now Click Account & Settings

Select Services

Next Click Image Service

Then Select Custom

And Finally enter this URL

(Custom Photo URL http://api.pikchur.com/twitter)

And thats it, you now have the ability to post directly to Pikchur via Twitter for the iPhone.

As always feel free to reach us anytime, we love to hear from you. 

~The Pikchur Crew

Hey, you can now post images & videos to Pikchur from Twitterrific, how sweet is that!? Here is how you do it:

1) Launch the application and tap on the Compose button in the upper-right corner of the screen.

2) In the window that appears, tap on the camera icon and select “Change Upload Service”.

3) At the bottom of the list that’s displayed, you’ll see “Other…”. Tap that and you see a text field where you can specify the “Media Service URL Endpoint”.

4) Enter “http://api.pikchur.com/twitterrific” and then tap outside the popover window to dismiss it. Done!

That’s it you’re set to use Pikchur in Twitterrific for photos & videos :)

What’s nice is that this media end point supports twitters new echo oAuth functionality so no need to update your settings with the Restful API is shut down. 

Hope you guys like it :) 

-Pikchur

Thanks to @Davidedichillo suggesting we add the end point, and helping us write the how to get Pikchur on the iPad instructions.

Great news, triggers now work within our API as well as our mms/email posting methods. Which means any application that supports Pikchur will now be able to  have a basic trigger system which will override your posting settings on the go! We have plans to include some pretty slick custom triggers really soon, but for now refer to this list of service triggers. 

To override any of the services you are posting to simply include the trigger in the subject of your post in the following format : 


To turn posting OFF for a service: -triggername-
To turn posting ON for a service: +triggername+ 

Twitter( tw )

FourSquare( 4sq )

Flickr( fk )

Tumblr( tr )

Jaiku( jk )

Facebook( fb )

FriendFeed( ff )

Plurk( pl)

Identi.ca( id )

Koornk( ko )

Totspot( ts )

Brightkite( bk )

For example if your account settings are :

• Twitter, Facebook, Foursquare, Flickr > Enabled
• Brightkite,Identi.ca,Plurk > Disabled 

Lets say you want to not send to twitter but you do want to send to Plurk. 

All you would have to do is in your subject/message is add the following triggers -tw- +pl+

When we recive your request we will override your account settings to match your trigger request and filter out the triggers from your message for that one upload.

We are working on some pretty neat things to be released really soon, so keep an eye out!

~The Pikchur Crew

Pikchur Teams up with @France2TV to launch a contest for a chance to win 2 tickets to the Coupe d’Europe de Rugby 2010.

Homepage: http://france2.pikchur.com/

Timeline: http://france2.pikchur.com/timeline

Media Landing Page: http://france2.pikchur.com/OsK

“Envoyez une photo typée Rugby à rugby@pocarles.com et vous la retrouverez ici http://bit.ly/9YAfuM Les 2 plus RT avant lundi gagnent ! :-)” - @France2TV

In order to win you must have the most Retweets, we look forward to seeing what Piks come in and good luck!

~The Pikchur Crew