POV-Ray : Newsgroups : povray.off-topic : APIs first? Server Time
6 Sep 2024 05:14:11 EDT (-0400)
  APIs first? (Message 11 to 20 of 28)  
<<< Previous 10 Messages Goto Latest 10 Messages Next 8 Messages >>>
From: Invisible
Subject: Re: APIs first?
Date: 2 Apr 2009 04:56:54
Message: <49d47dd6@news.povray.org>
scott wrote:
>> That's because they are both Micro$oft products.
> 
> Not really, it's because there is an agreed standard for how the 
> information is transferred over http (of course if both sides are made 
> by the same company this is usually automatically the case).

Well, let's face it, any system is merely an agreed way to send data 
between multiple computers. I'm just saying, I'm not aware of any way of 
accessing an arbitrary website programatically without going through a 
world of pain.

> How about RSS feeds, loads of programs written that access those over 
> the web?

I don't what what RSS is.


Post a reply to this message

From: scott
Subject: Re: APIs first?
Date: 2 Apr 2009 05:02:54
Message: <49d47f3e$1@news.povray.org>
> I don't what what RSS is.

http://tinyurl.com/ct6woq


Post a reply to this message

From: Invisible
Subject: Re: APIs first?
Date: 2 Apr 2009 05:06:25
Message: <49d48011$1@news.povray.org>
scott wrote:
>> I don't what what RSS is.
> 
> http://tinyurl.com/ct6woq

Oh, the Wikipedia article on RSS. I would *never* have thought of that. :-P

Seriously, did you think I hadn't read that already?


Post a reply to this message

From: clipka
Subject: Re: APIs first?
Date: 2 Apr 2009 07:55:00
Message: <web.49d4a77ecd1f6b8ff708085d0@news.povray.org>
Nicolas Alvarez <nic### [at] gmailcom> wrote:
> Darren New wrote:
> > http://asserttrue.blogspot.com/2009/04/api-first-design.html
> >
> > Huh? Doesn't everyone document the APIs before they start writing code
> > that
> > exports APIs?  Seriously, don't you programmers do that?
> >
> > I can't imagine how you can even know when you're done a piece of the
> > library if you didn't do the documentation first. I thought that was,
> > like, the only way to do it.
>
> I spent weeks deciding on the API, some more weeks deciding on internal
> design, and I've yet to write any *real code* for this one library... :)

From my experience, a *typical* real-life working mode would be to

(1) design and (optionally) document the API
(2) design and (optionally) document the internal design, modifying the API as
problems with the internal design arise
(3) write the real code, modifying both the internal design and API as problems
with the real code arise
(4) start working on a new project
(5) (optionally) document the changes made to the API in phases (2) and (3)
(6) (optionally) document the changes made to the internal design in phase (3)


Post a reply to this message

From: Darren New
Subject: Re: APIs first?
Date: 2 Apr 2009 11:15:59
Message: <49d4d6af$1@news.povray.org>
clipka wrote:
> From my experience, a *typical* real-life working mode would be to

<chortle>  I think you hit the nail on the head.

-- 
   Darren New, San Diego CA, USA (PST)
   There's no CD like OCD, there's no CD I knoooow!


Post a reply to this message

From: Darren New
Subject: Re: APIs first?
Date: 2 Apr 2009 11:19:46
Message: <49d4d792$1@news.povray.org>
Invisible wrote:
> More to the point, there's masses of tricky parsing to wade through all 
> the presentational HTML to extract the actual raw data I'm after.

That's because you're getting the results in HTML instead of "via an API".

That's what people are talking about when they talk about web APIs: 
presenting data without making you parse it.

"REST" is a pattern for doing this in a way that *also* lets you use a web 
browser to reverse-engineer the protocols by looking at it and which is 
theoretically kind to intermediate proxies.

"SOAP" is a pattern for doing this in a way that lets you publish the 
specification of the interface in a form that a tool can generate code to 
decode it into whatever native data structures are available for your language.

What you're doing is called "screen scraping", and yes, it breaks when the 
format of the web page changes, which happens often when there's so many 
people doing screen scraping that it starts to impact the actual customers 
of the web site.

-- 
   Darren New, San Diego CA, USA (PST)
   There's no CD like OCD, there's no CD I knoooow!


Post a reply to this message

From: Darren New
Subject: Re: APIs first?
Date: 2 Apr 2009 11:21:09
Message: <49d4d7e5$1@news.povray.org>
Invisible wrote:
> accessing an arbitrary website programatically without going through a 
> world of pain.

No, you can't access "arbitrary" websites that present HTML. Well, you can, 
depending on what you want to do. Google does it all the time. But it's hard 
to get specific information out in an automated way. That's why people 
invented HTTP-based APIs like SOAP.

-- 
   Darren New, San Diego CA, USA (PST)
   There's no CD like OCD, there's no CD I knoooow!


Post a reply to this message

From: Invisible
Subject: Re: APIs first?
Date: 2 Apr 2009 11:27:54
Message: <49d4d97a$1@news.povray.org>
>> accessing an arbitrary website programatically without going through a 
>> world of pain.
> 
> No, you can't access "arbitrary" websites that present HTML. Well, you 
> can, depending on what you want to do. Google does it all the time.

Uhuh. And how many PhDs work for Google?

> But 
> it's hard to get specific information out in an automated way. That's 
> why people invented HTTP-based APIs like SOAP.

Why would you base a protocol on HTTP?


Post a reply to this message

From: Invisible
Subject: Re: APIs first?
Date: 2 Apr 2009 11:28:06
Message: <49d4d986$1@news.povray.org>
Darren New wrote:
> Invisible wrote:
>> More to the point, there's masses of tricky parsing to wade through 
>> all the presentational HTML to extract the actual raw data I'm after.
> 
> That's because you're getting the results in HTML instead of "via an API".
> 
> That's what people are talking about when they talk about web APIs: 
> presenting data without making you parse it.
> 
> "REST" is a pattern for doing this in a way that *also* lets you use a 
> web browser to reverse-engineer the protocols by looking at it and which 
> is theoretically kind to intermediate proxies.
> 
> "SOAP" is a pattern for doing this in a way that lets you publish the 
> specification of the interface in a form that a tool can generate code 
> to decode it into whatever native data structures are available for your 
> language.

So you mean you get the web server to search an XML document so the 
client at the other end can parse it into something useful more easily?

> What you're doing is called "screen scraping", and yes, it breaks when 
> the format of the web page changes, which happens often when there's so 
> many people doing screen scraping that it starts to impact the actual 
> customers of the web site.

I doubt my one hit per month hurts PassMark. ;-)


Post a reply to this message

From: Darren New
Subject: Re: APIs first?
Date: 2 Apr 2009 11:43:59
Message: <49d4dd3f$1@news.povray.org>
Invisible wrote:
> So you mean you get the web server to search an XML document so the 
> client at the other end can parse it into something useful more easily?

s/search/serve

Yes.

> I doubt my one hit per month hurts PassMark. ;-)

No, but when people distribute software that (for example) takes TV listings 
off Yahoo's web site without grabbing or showing any ads, and 100,000 people 
run that every day, Yahoo notices.

-- 
   Darren New, San Diego CA, USA (PST)
   There's no CD like OCD, there's no CD I knoooow!


Post a reply to this message

<<< Previous 10 Messages Goto Latest 10 Messages Next 8 Messages >>>

Copyright 2003-2023 Persistence of Vision Raytracer Pty. Ltd.