That was my guess. I guess the question really is whether the API will be
modified to match the docs or vice-versa. When/If you know the answer to
that, let us know.
- Matt
----- Original Message -----
From: "Charles Daminato" <[EMAIL PROTECTED]>
To: "Matt Prigge" <[EMAIL PROTECTED]>
Cc: <[EMAIL PROTECTED]>
Sent: Wednesday, August 22, 2001 8:56 PM
Subject: Re: API Doc Error (?)
> Matt,
>
> My guess would be that there's a discrepancy between the API documentation
> and the actual results. Admittedly the API has fallen a little out of
> whack with the docs (or vice versa?) - we're working hard to get this back
> up to date, as we know how important it is to everyone.
>
> Charles Daminato
> TUCOWS Product Manager
> [EMAIL PROTECTED]
>
> On Wed, 22 Aug 2001, Matt Prigge wrote:
>
> > Hey Folks,
> > Pg 55/130 from the PDF of the OpenSRS v2.4 API states that the
attribute
> > 'remainder' which gets returned from a 'get_domain' request with a type
of
> > 'list' should be "The amount of remaining domain names (this is used for
> > paging, and represents the number of domain names still to show)". Some
> > quick testing using the opensrs-php client shows that this actually
behaves
> > as a boolean stating whether or not there is a remainder, not
necessarily
> > what that remainder is (I have taken a look at the raw XML so I am
fairly
> > sure this isnt the client's fault).
> > My question is whether the documentation is wrong or whether the API
is
> > misbehaving (or at least not working to specification). This isnt a
terribly
> > big deal, because you can get this number from seeing how many domains
the
> > get_domain function returns and which page youre on to see how many
domains
> > you've already seen and then subtract this from the 'count' field to get
the
> > remainder. The only downside to this is that its overly complicated and
> > basically renders the 'remainder' field useless except as a convenience.
> > My suggestion would be to fix the API (if it is in fact broken) to
> > return the actual remainder. This is safe for people who have been using
it
> > as a bool since most anything other than 0 or undef will eval as TRUE in
> > perl (and PHP). Not so sure about other languages, but I dont know that
> > other languages are used a whole lot anyhow.
> >
> > Thanks!
> > Matt Prigge
> >
> >
>
