Talk:Use a REST API

From Rosetta Code
Revision as of 18:31, 29 December 2014 by rosettacode>Dchapes (→‎Submitting events: ick; prefer generic REST api over paid specific crap)

Output?

I think the task should specify an example set of parameters for the event query and ask for some sample output. E.g. a city and topic and the number of events and partial information for the first n events. —dchapes (talk | contribs) 00:30, 29 December 2014 (UTC)

Submitting events

I think asking for submitting of events will be problematic. Perhaps it would be better for the task author to create a single example/test RosettaCode "event" and then have a bonus task requirement to use POST 2/event_comment to add a comment to it. An example use of any POST API should be close enough to any other POST API for RosettaCode purposes. —dchapes (talk | contribs) 00:41, 29 December 2014 (UTC)

Note also the comment "Needs permission to post, which is paid." in http://rosettacode.org/mw/index.php?title=Using_the_Meetup.com_API&diff=next&oldid=195957
I think that any task which requires people pay money in order to exercise the code (another example might be credit card handling) should be treated as dubious. There's definitely a place for that kind of code, but I think that that place should be on a rigorously regulated paid access site. It's advertising for a commercial endeavor, which is fine as long as the commercial endeavor (a) contributes back, and (b) does so in an honest and clear fashion, and (c) does not whine and complain about other activities. I do not think that the person asking this task be posted here was doing the right thing. --Rdm (talk) 13:12, 29 December 2014 (UTC)
Ick, I wasn't aware of that. IMO then this whole task should be replaced by a generic "use a REST API" task against some kind of test server. If no such freely available API for testing exists then either one could be part of a separate (more involved) task or there isn't much place for this on Rosettacode.org. —dchapes (talk | contribs) 18:31, 29 December 2014 (UTC)

Does cost Kill this task?

If, as Rdm has pointed out, "Posting requires a valid group which is a paid feature", and posting is an important part of the API, then the draft task should not be accepted as RC'ers don't have to pay external parties to complete tasks so far and I don't think that should change. --Paddy3118 (talk) 18:28, 29 December 2014 (UTC)

Uh...

This seems a bit iffy, in my opinion. The whole "talk to an API" thing seems marginal.

First, if the task itself is so complicated that the definition of what the task is doing has to be hosted elsewhere, that seems bad. Why isn't the API documentation included in the task description?

Second, what is an "event", in the context of this task? Why isn't that documented?

Third, what is the success criteria, for talking to an external API like this? Is it acceptable for an implementation to be an utter failure? If so, what's the point? If not, how does a reader verify that the code is working?

Finally, [apparently, currently] none of the implementations are acceptable. --Rdm (talk) 01:05, 29 December 2014 (UTC)