Re: Using REST service created with IWS

Booth,

It would do yourself a favor and others new to RESTful requests and
services to search the net for that sort of answer. There are a few here
familiar with it, but there is so much free information out there that you
should familiarize yourself with first.

Another nice way to look at a LOT of examples is look at Google's RESTful
APIs for all their services. Calendar is one:

https://developers.google.com/calendar/v3/reference/

You'll see a lot of options for URI paths, query string options, payload
options, etc. Especially when you really dig down into some of the docs.


Bradley V. Stone
www.bvstools.com
MAILTOOL Benefit #8 <https://www.bvstools.com/mailtool.html>: Email Logging
- Each email that is sent out is logged with a delivery status. MAILTOOL
also tracks each of the recipients for each email as well as the
attachment(s) sent along with each email.

On Mon, Jan 14, 2019 at 5:39 PM Booth Martin <booth@xxxxxxxxxxxx> wrote:

Agreed on all of that but in reading Tim Fathers' response, it looks to
me like we should be using queryparm instead of a pathparm?

Like this: http://1.2.3.4:10010/web/services/ftoc?90 - or something
- ???

This has been a long trip for me, and fun every bit of the way. That the
discussion is about style & form tells me thatI finally got there. Now
that I see what IWS is doing I am astonished that there isn't a lot more
discussion about this awesome product.



On 1/14/2019 5:16 PM, Peter Dow wrote:

Hi Booth,

If you already created the temperature conversion example using IWS
and have it running, then you can use the "Manage Deployed Services"
link, select the correct resource from the list and click the
Properties button.

On the General tab that's displayed you'll see

Base resource URL: http://1.2.3.4:10010/web/services/ftoc

Copy and paste that to a browser's address bar and add the temperature
convert, e.g.

http://1.2.3.4:10010/web/services/ftoc/90

The response I get (shown in the browser) is

<CONVERTTEMPResult>
<TEMPOUT>32.22</TEMPOUT>
</CONVERTTEMPResult>

Btw, thanks for all your posts about this subject. Reading that thread
was a great help in my project.

On 1/14/2019 2:31 PM, Booth Martin wrote:

Walk me through this. The temperature conversion example included
with IWS... The address is http://an.iSeries.com/coop/ I want to say
F2C and 90, meaning I want the api to convert 90 degrees Fahrenheit
to Celsius. What should that look like?


On 1/14/2019 4:16 PM, Tim Fathers wrote:

While I agree the definition of REST can be pretty flexible and
there are no hard and fast rules, I think it is a fairly well
established rule of thumb that the URL should generally identify the
resource, not the query parameters. The body (which I think you mean
by "standard input") is where the payload should go, and should not
be used on on a GET request in any case.

In some APIs the resource is not a "thing" but a function, in which
case it is considered ok to pass query parameters to it in the URL
for a GET or in the body for a POST. The example of this from my
favourite REST book "The RESTful Webservices Cookbook" is a distance
calculator. So /calc_distance?from=wiesbaden&to=frankfurt is ok
because "distance" is not a thing but a function.

Tim.

--
This is the Web Enabling the IBM i (AS/400 and iSeries) (WEB400) mailing
list
To post a message email: WEB400@xxxxxxxxxxxxxxxxxx
To subscribe, unsubscribe, or change list options,
visit: https://lists.midrange.com/mailman/listinfo/web400
or email: WEB400-request@xxxxxxxxxxxxxxxxxx
Before posting, please take a moment to review the archives
at https://archive.midrange.com/web400.