Initial API availability

27 views
Skip to first unread message

maciej

unread,
Oct 16, 2009, 7:30:48 AM10/16/09
to Pinboard
I've enabled an experimental API endpoint at https//api.pinboard.in/
v1/. This version of the API is targeted at developers and people
who want to horse around and are not afraid of a few bugs, hiccups,
complete data loss etc. You're welcome to use it (and I would love
bug reports), but please do not release public code using the API
until I have a chance to finish debugging and testing. I'll make an
announcement on the site blog and this list once things are ready.

This version of the API is meant to exactly emulate the del.icio.us
API, documented at http://delicious.com/help/api. The operations
and syntax listed there should all work, except for the following
unsupported API calls:

posts/all?hashes
posts/suggest
any tag bundle operations
/posts/get - the "hashes" and "meta" argument
/posts/all - "meta" argument

Please let me know by email if you come across any bugs, or if there
are additional API methods you need exposed in order to do something
neat. Also, please rate limit to one request/second and back up your
data before you start mucking around ( https://username:pass...@api.pinboard.in/v1/posts/all).

Thanks!

Maciej



Jason Broyles

unread,
Oct 17, 2009, 11:00:13 AM10/17/09
to Pinboard
Awesome, thanks for doing this. Something I see off the top of my head
would be the
https://api.del.icio.us/v1/posts/update to tell when the bookmarks
were last updated. Also, did you see their list of public feeds? Do
you have any plans on implementing something like this?
http://delicious.com/help/feeds

On Oct 16, 7:30 am, maciej <mceglow...@gmail.com> wrote:
> I've enabled an experimental API endpoint at https//api.pinboard.in/
> v1/.    This version of the API is targeted at developers and people
> who want to horse around and are not afraid of a few bugs, hiccups,
> complete data loss etc.  You're welcome to use it (and I would love
> bug reports), but please do not release public code using the API
> until I have a chance to finish debugging and testing.  I'll make an
> announcement on the site blog and this list once things are ready.
>
> This version of the API is meant to exactly emulate the del.icio.us
> API, documented athttp://delicious.com/help/api.    The operations
> and syntax listed there should all work, except for the following
> unsupported API calls:
>
> posts/all?hashes
> posts/suggest
> any tag bundle operations
> /posts/get - the "hashes" and "meta" argument
> /posts/all - "meta" argument
>
> Please let me know by email if you come across any bugs, or if there
> are additional API methods you need exposed in order to do something
> neat.  Also, please rate limit to one request/second and back up your
> data before you start mucking around ( https://username:passw...@api.pinboard.in/v1/posts/all).
>
> Thanks!
>
> Maciej

maciej

unread,
Oct 17, 2009, 11:22:22 AM10/17/09
to Pinboard


On Oct 17, 6:00 pm, Jason Broyles <ja...@jasonism.org> wrote:
> Awesome, thanks for doing this. Something I see off the top of my head
> would be the https://api.del.icio.us/v1/posts/update to tell when the bookmarks
> were last updated.

This is already implemented. Are you having trouble getting it to
work?

> Also, did you see their list of public feeds? Do
> you have any plans on implementing something like this?http://delicious.com/help/feeds

A lot of this stuff overlaps with feeds that we already offer. Do you
or others have any particular pages you want to see a feed for, or
feed features (like JSON callbacks) that aren't implemented yet? I
have plans to add a number of feeds (for URL pages, global tag pages,
etc.) but I'm always happy to bump stuff up the priority list if
people are actually asking for it.

Jason Broyles

unread,
Oct 17, 2009, 12:10:41 PM10/17/09
to Pinboard
https://api.pinboard.in/v1/posts/update does not seem to be returning
anything. The below would be great to get.

Private
Read later
To read (XML of all without secret key, user/pass instead)
Mark as read

Public
Users recent network
Users network members

All recent by specific tag

Popular tags
Popular bookmarks by specific tag

On Oct 17, 11:22 am, maciej <mceglow...@gmail.com> wrote:
> On Oct 17, 6:00 pm, Jason Broyles <ja...@jasonism.org> wrote:
>
> > Awesome, thanks for doing this. Something I see off the top of my head
> > would be thehttps://api.del.icio.us/v1/posts/updateto tell when the bookmarks

maciej

unread,
Oct 17, 2009, 12:19:50 PM10/17/09
to Pinboard


On Oct 17, 7:10 pm, Jason Broyles <ja...@jasonism.org> wrote:
> https://api.pinboard.in/v1/posts/updatedoes not seem to be returning
> anything.

I get the expected response with this syntax:

# curl https://maciej:x...@api.pinboard.in/v1/posts/update
<?xml version="1.0" encoding="UTF-8"?><update
time="2009-10-17T06:57:43Z" />

Are you getting back an empty response, or any kind of interesting
error? Anyone else able to get this call to work?

> The below would be great to get.

I'll add them in.

Thanks!

Maciej


>
> Private
>         Read later
>         To read (XML of all without secret key, user/pass instead)
>         Mark as read
>
> Public
>         Users recent network
>         Users network members
>
>         All recent by specific tag
>
>         Popular tags
>         Popular bookmarks by specific tag
>
> On Oct 17, 11:22 am, maciej <mceglow...@gmail.com> wrote:
>
>
>
> > On Oct 17, 6:00 pm, Jason Broyles <ja...@jasonism.org> wrote:
>
> > > Awesome, thanks for doing this. Something I see off the top of my head
> > > would be thehttps://api.del.icio.us/v1/posts/updatetotell when the bookmarks

Jason Broyles

unread,
Oct 17, 2009, 12:54:13 PM10/17/09
to Pinboard
Thanks for doing that. The update does work with curl, I was trying to
use it in my browser and I the window looked blank but source ended up
having the proper response.


On Oct 17, 12:19 pm, maciej <mceglow...@gmail.com> wrote:
> On Oct 17, 7:10 pm, Jason Broyles <ja...@jasonism.org> wrote:
>
> >https://api.pinboard.in/v1/posts/updatedoesnot seem to be returning
> > anything.
>
> I get the expected response with this syntax:
>
> # curl https://maciej:x...@api.pinboard.in/v1/posts/update
> <?xml version="1.0" encoding="UTF-8"?><update
> time="2009-10-17T06:57:43Z" />
>
> Are you getting back an empty response, or any kind of interesting
> error?  Anyone else able to get this call to work?
>
> > The below would be great to get.
>
> I'll add them in.
>
> Thanks!
>
> Maciej
>
>
>
> > Private
> >         Read later
> >         To read (XML of all without secret key, user/pass instead)
> >         Mark as read
>
> > Public
> >         Users recent network
> >         Users network members
>
> >         All recent by specific tag
>
> >         Popular tags
> >         Popular bookmarks by specific tag
>
> > On Oct 17, 11:22 am, maciej <mceglow...@gmail.com> wrote:
>
> > > On Oct 17, 6:00 pm, Jason Broyles <ja...@jasonism.org> wrote:
>
> > > > Awesome, thanks for doing this. Something I see off the top of my head
> > > > would be thehttps://api.del.icio.us/v1/posts/updatetotellwhen the bookmarks

Amy

unread,
Oct 17, 2009, 4:24:24 PM10/17/09
to Pinboard


On Oct 16, 6:30 am, maciej <mceglow...@gmail.com> wrote:
> I've enabled an experimental API endpoint at https//api.pinboard.in/
> v1/.    

Well, the post/add seems to be working just fine-- thanks! Now I can
stop flooding the server with my email postings. :)

-Amy

Amy

unread,
Oct 17, 2009, 6:59:56 PM10/17/09
to Pinboard
By the way... is the post/add api supposed to work with HTTP POST
requests? It does not seem to, only GETs. (for me, this is not a
problem-- just checking).

-Amy

maciej

unread,
Oct 18, 2009, 6:05:25 AM10/18/09
to Pinboard
The API endpoint only understands GET requests right now.
Reply all
Reply to author
Forward
0 new messages