Comments on: Data file format and response format http://niklasbe.wordpress.com/2008/05/24/data-file-format-and-response-format/ A blog following the progress of my Summer of Code project Wed, 15 Apr 2009 17:37:48 +0000 http://wordpress.com/ hourly 1 By: How to Get Six Pack Fast http://niklasbe.wordpress.com/2008/05/24/data-file-format-and-response-format/#comment-58 How to Get Six Pack Fast Wed, 15 Apr 2009 17:37:48 +0000 http://niklasbe.wordpress.com/?p=5#comment-58 Not that I'm totally impressed, but this is more than I expected when I found a link on Furl telling that the info here is quite decent. Thanks. Not that I’m totally impressed, but this is more than I expected when I found a link on Furl telling that the info here is quite decent. Thanks.

]]> By: ijabz http://niklasbe.wordpress.com/2008/05/24/data-file-format-and-response-format/#comment-13 ijabz Wed, 04 Jun 2008 19:18:10 +0000 http://niklasbe.wordpress.com/?p=5#comment-13 I mentioned using owned on irc, bad idea, not really robust enough. But you could take the cut and paste the folksonomy webservice code for your project I mentioned using owned on irc, bad idea, not really robust enough. But you could take the cut and paste the folksonomy webservice code for your project

]]> By: ijabz http://niklasbe.wordpress.com/2008/05/24/data-file-format-and-response-format/#comment-12 ijabz Wed, 04 Jun 2008 14:02:03 +0000 http://niklasbe.wordpress.com/?p=5#comment-12 Currently tracks are tagged with 'owned' through the website but there is already a webservice for adding tags to a artist/release/track/label so it could easily be done programatically. In fact in the dev version of Jaikoz I can submit genres to tags at a track level , so by entering 'owned' instead of a genre into the genre field i can hack it to do this already. Currently tracks are tagged with ‘owned’ through the website but there is already a webservice for adding tags to a artist/release/track/label so it could easily be done programatically. In fact in the dev version of Jaikoz I can submit genres to tags at a track level , so by entering ‘owned’ instead of a genre into the genre field i can hack it to do this already.

]]> By: niklas http://niklasbe.wordpress.com/2008/05/24/data-file-format-and-response-format/#comment-11 niklas Wed, 04 Jun 2008 12:19:06 +0000 http://niklasbe.wordpress.com/?p=5#comment-11 "I dont quite follow the example data , are you advocating sending a physical data file rather then sending the data as post parameters. If so I don’t agree you shouldnt impose this restriction some applications may not have access a filesystem, and creating a file is an unneccssary step anyway.." Yes, I was thinking of producing a file to send, but thats so stupid. Thank you for the feedback, will do another post! "I guess the following idea has probably been thrown out already but a simpler alternative approach would could be just be for the server to parse tags entities that are currently being tagged with the ‘owned’ tag using the folksonomy service" Would this require people to manually tag music as owned? Or can this be done automatically with e.g. Picard or Jaikoz somehow? Working on an exam today, got another one tomorrow morning. That will be my last one. After that expect to see more updates... “I dont quite follow the example data , are you advocating sending a physical data file rather then sending the data as post parameters. If so I don’t agree you shouldnt impose this restriction some applications may not have access a filesystem, and creating a file is an unneccssary step anyway..”

Yes, I was thinking of producing a file to send, but thats so stupid. Thank you for the feedback, will do another post!

“I guess the following idea has probably been thrown out already but a simpler alternative approach would could be just be for the server to parse tags entities that are currently being tagged with the ‘owned’ tag using the folksonomy service”

Would this require people to manually tag music as owned? Or can this be done automatically with e.g. Picard or Jaikoz somehow?

Working on an exam today, got another one tomorrow morning. That will be my last one. After that expect to see more updates…

]]> By: ijabz http://niklasbe.wordpress.com/2008/05/24/data-file-format-and-response-format/#comment-10 ijabz Wed, 04 Jun 2008 11:56:47 +0000 http://niklasbe.wordpress.com/?p=5#comment-10 I dont quite follow the example data , are you advocating sending a physical data file rather then sending the data as post parameters. If so I don't agree you shouldnt impose this restriction some applications may not have access a filesystem, and creating a file is an unneccssary step anyway.. What about these post parameters instead: action=add tracklist=trackid1,trackid2 releaselist=releaseid1 would add trackid1,trackid2 and releaseid1 action=remove tracklist=trackid1,trackid2 would remove trackid1,trackid2 I guess the following idea has probably been thrown out already but a simpler alternative approach would could be just be for the server to parse tags entities that are currently being tagged with the 'owned' tag using the folksonomy service I dont quite follow the example data , are you advocating sending a physical data file rather then sending the data as post parameters. If so I don’t agree you shouldnt impose this restriction some applications may not have access a filesystem, and creating a file is an unneccssary step anyway..

What about these post parameters instead:
action=add
tracklist=trackid1,trackid2
releaselist=releaseid1

would add trackid1,trackid2 and releaseid1

action=remove
tracklist=trackid1,trackid2

would remove trackid1,trackid2

I guess the following idea has probably been thrown out already but a simpler alternative approach would could be just be for the server to parse tags entities that are currently being tagged with the ‘owned’ tag using the folksonomy service

]]> By: niklas http://niklasbe.wordpress.com/2008/05/24/data-file-format-and-response-format/#comment-9 niklas Thu, 29 May 2008 19:44:09 +0000 http://niklasbe.wordpress.com/?p=5#comment-9 Im not going to write an update. Not much to change. Im not going to write an update. Not much to change.

]]> By: niklas http://niklasbe.wordpress.com/2008/05/24/data-file-format-and-response-format/#comment-8 niklas Thu, 29 May 2008 12:26:44 +0000 http://niklasbe.wordpress.com/?p=5#comment-8 Thank you for the replies. Will write a small update hopefully by tonight. Will include some more GET parameters, alternatively divide into more resources. Nikki: good mafr: yes, this was the idea with having the error entity with sub-entities. dont know why I did not include it right away. thanks! looked into REST, but not sure how to make this more "RESTful" kuno: will move it. I want to "finalize"(for now) this as soon as possible. school is coming to an end and I want to start coding :) Thank you for the replies. Will write a small update hopefully by tonight.
Will include some more GET parameters, alternatively divide into more resources.

Nikki: good

mafr: yes, this was the idea with having the error entity with sub-entities. dont know why I did not include it right away. thanks! looked into REST, but not sure how to make this more “RESTful”

kuno: will move it. I want to “finalize”(for now) this as soon as possible. school is coming to an end and I want to start coding :)

]]> By: kuno http://niklasbe.wordpress.com/2008/05/24/data-file-format-and-response-format/#comment-7 kuno Tue, 27 May 2008 13:04:37 +0000 http://niklasbe.wordpress.com/?p=5#comment-7 I would move the version into the URL, like the current musicbrainz webservices have. For example if you stick to your current protocol, you can easily move to XML later if the version is part of the URL and not part of the data being sent. Something else which is probably import to mention: Do not dwell on this too long, it is something which can easily be changed later on in the project. You will quickly discover things you missed as you start implementing, so do not try to think of everything in advance. I would move the version into the URL, like the current musicbrainz webservices have. For example if you stick to your current protocol, you can easily move to XML later if the version is part of the URL and not part of the data being sent.

Something else which is probably import to mention:

Do not dwell on this too long, it is something which can easily be changed later on in the project. You will quickly discover things you missed as you start implementing, so do not try to think of everything in advance.

]]> By: mafr http://niklasbe.wordpress.com/2008/05/24/data-file-format-and-response-format/#comment-6 mafr Sun, 25 May 2008 07:20:49 +0000 http://niklasbe.wordpress.com/?p=5#comment-6 XMLWebService uses the REST architectural schema (see wikipedia or Fieldings' dissertation), so it's not quite as easy as posting something to an URL. I designed that web service and it wasn't entirely trivial, I can tell you ;-) Regarding the response format: You might want to use an XML namespace and expand the error element a bit. Client libraries probably want to raise different types of exceptions depending on the type of error, so a machine-readable error code would make sense. A free-text error string is still good and useful. XMLWebService uses the REST architectural schema (see wikipedia or Fieldings’ dissertation), so it’s not quite as easy as posting something to an URL. I designed that web service and it wasn’t entirely trivial, I can tell you ;-)

Regarding the response format: You might want to use an XML namespace and expand the error element a bit. Client libraries probably want to raise different types of exceptions depending on the type of error, so a machine-readable error code would make sense. A free-text error string is still good and useful.

]]> By: Nikki http://niklasbe.wordpress.com/2008/05/24/data-file-format-and-response-format/#comment-5 Nikki Sat, 24 May 2008 18:55:02 +0000 http://niklasbe.wordpress.com/?p=5#comment-5 While I'm not entirely sure what 'release' will mean exactly in NGS, we moved away from using 'album' so I can't see people going back to using it. While I’m not entirely sure what ‘release’ will mean exactly in NGS, we moved away from using ‘album’ so I can’t see people going back to using it.

]]>