Skip to Main Content
×
Freshbooks
Official App
Free – Google Play
Get it
FreshBooks is Loved by American Small Business Owners
FreshBooks is Loved by Canadian Small Business Owners
FreshBooks is Loved by Small Business Owners in the UK
Dev Blog

Ch-ch-ch-changes… introducing

by mikeg on December 8/2008

The object URI changes we made a while back appear to be helpful.  So much so, we’ve been getting some granular requests that are object specific, and we can see some of the benefits in bringing them to you.  But first, and a FreshBooks API first, we’ve added our first deprecation to the API.

I’ve secretly hated the look/feel/sound of our current URI responses in the form of and on invoices, estimates and clients.  While they still exist today, you may notice a new property on the and elements, and that is ‘deprecated=“true”’.  Make use of them while you can, because in some future update, they will just vanish.  API version 3?  2.2? I promise nothing.  Consider this a 2 minute warning, of a sort.

The new format consists of a parent which will contain , replacing , and , replacing .  Your output should look something like this:


https://sample.freshbooks.com/inv/514-24-d4622
https://sample.freshbooks.com/inv/514-24-d4622-z

Links is part of the , and response when you execute the appropriate .get operation successfully.

Our object specific update of the day is just for invoice.get and fits into the response element.  The new link directly takes an authenticated administrator to the target invoice for editing.  It should look something like this:


https://sample.freshbooks.com/inv/514-24-d4622-e

As always, comments and further suggestions are welcome and encouraged.