I've got one BIG request for the documentation - that there is an XML
example Request and Response for each Action. At the moment there are only
XML examples for some of them, and the examples that are used only really
represent the Perl structures. Not much use for those os us not using Perl.
Tony Levaggi
Tetradom NZ
-----Original Message-----
From: [EMAIL PROTECTED] [mailto:[EMAIL PROTECTED]]On
Behalf Of Charles Daminato
Sent: Thursday, 23 August 2001 10:48 p.m.
To: Matt Prigge
Cc: [EMAIL PROTECTED]
Subject: Re: API Doc Error (?)
Definitely the documentation requires updating, and that's what we're
doing.
Charles Daminato
TUCOWS Product Manager
[EMAIL PROTECTED]
On Wed, 22 Aug 2001, Matt Prigge wrote:
> 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
> > >
> > >
> >
>
>
