Restful Web service - specifications - web-services

what is meant by specifications for Restful web service.
I am new to Restful web services and I created a simple Rest web service with a 'Get' method/operation. The web service was created using jersey . I am asked for the specification for this web service and I am not sure what should be the correct answer.

It means you need to describe what calls are available and what type of objects they can receive or return. For some examples, have a look at the API documentation of major websites like the Twitter API Reference, Facebook Graph API, etc.

Related

Essbase Webservices for Authentication

I want to connect to Essbase from a 3rd Party App - Alteryx. Essbase exposes JAVA APIs and allows 3rd party apps to connect to those JAVA APIs. However, Alteryx cannot connect to those APIs and hence I am interested in knowing about the SOAP based Essbase Webservices.
Does anyone know how to call Essbase Authentication webservice complete with attributes such as URL and request body.
In case if anyone has a working sample that can be shared, please post it or otherwise, kindly point to a web resource that can be referred to fulfill this requirement.
I would recommend against using the SOAP-based Essbase web services. They are a dead end with almost zero documentation. You can just use the normal Essbase Java API, which can be configured to use HTTP. There are numerous examples on the web as well as sample Java examples that ship with Essbase.

WEB API's VS WEB SERVICES?

I have searched a lot upon internet but still i didn't get the clear difference between web services and web APIs? Somewhere I read that all web services are API's but all API' are not web services. How?
What all I know is both allow to utilize the functionality of other applications.Can someone describe me clear difference?
I have been on the same journey to learn the differnce between Web API (not JUST API) vs Web Services.
First, we know for a fact that both use the Web as the communication tool as stated by #Kris.
While looking at these 2 videos, both serve as the "middleman" (the waiter in the restaurant) for a client to ask a Web Server to process and deliver a response.
Web Service (From 0:35)
API (In general) (From 1:12)
When I was looking for an actual differnce between the two, usually most articles and videos go on an unrelated comparison between "Web Services vs API" as they exclude the "Web" out of "Web API".
See this article, for example, which contains the title "Web API Vs Web Service...." yet, contain sub-titles like:
"Differences of API vs Web Service"
"Pros and Cons of Web Services vs API Service"
"Web Service vs API: Fueling Both With Scraping Robot’s API"
The only difference I could find is if we were to discuss this in .NET context.
Here's a question post related to this.
To sum it up, Web Services are used in the SOAP protocal while Web API is usually created in the RESTful way. The more detailed answers are in the post but ultimatelly do not answer the main question that is asked.
Conclusion: The question raised in the public domanin has no clear definition to what is difference between the two, thus the 2 terms are ,for the most part,
interchangeable
All web services are APIs. An API is an Application Programming Interface. But there are offline APIs, which are not web services. There are APIs for all things from Office to Websites. The API is just a defined interface to be able to control/communicate with some software. Web Services just provide that means of connecting over the web.
There is more to discuss when you are talking about APIs which are communication protocols and data formats, but you get the basic idea.
An API (Application Program Interface) is the interface through which another program can communicate with a program.
A web service in this context is one of those programs with an API. 'Web' means that it is accessible via the web, mostly via HTTP. A service usually has a well defined purpose.
For instance a date web service's purpose could be to provide the current date. The API of my service would have a single 'endpoint': get the date. The service then implements this API. It somehow retrieves the date and sends it back.

If I can write HTTP Service in WCF, why should I use Web API?

I've gone over other WCF vs Web API question as well as blogs. It is possible to write HTTP service with webHttpBinding in WCF too. So why should one move to Web API when it is possible to use WCF for the same purpose. Some say it's easy to use HTTP in Web API. But in what sense.
A lot of blogs make me confused. Most of them are like " You can do HTTP in WCF but Web API is pure REST based. You can use Web API if you want but you can use WCF too". It's like salesman describing their product which is really confusing for me here.
I have old asmx service which I want to move to REST Service. I tried WCF with webHttpBinding. It works well but why should one move to Web API?
If you already have a WCF service that you're satisfied with, then you're done. No need for WebAPI.
You would use WebAPI if there are features of the WebAPI which WCF cannot conveniently supply. The WebAPI is "closer to HTTP", whereas WCF is a generic communications framework.

WSO2 Identity Server Web Services Documentation

I am doing a comparison between some Identity Management tools, one of which is the WSO2 Identity Server. I have found a number of wsdl files regarding WSO2 IS web services.
Is there any kind of documentation regarding operations in the wsdl files? Because i can't seam to find any.
Yes. Identity Server contains many web service APIs.. These APIs mainly support for identity and entitlement management functions. You can find web service API such as UserAdmin, RemoteUserStoreManagerService , EntitlementService and so on. But there are some web service APIs for server management functions.. All the UI that you see in WSO2IS server, calls backend web service APIs to get the operation done.. Unfortunately there is no any good document on explaining all these web service APIs. But if you are looking some specific function, You can find them.. As an example, if you want to use WSO2IS as authorization server, You must look about EntitlementService API. More detail on it can be found here. Like that, You can search for some specific topic about WSO2IS in the internet..and get some details about these service.
But, If you like to list and see all WSDL of WSO2IS, You go through this question that is asked in SO. Actually by looking at the WSDL, You can even get some idea about the functions.

API centric application or REST or Web service Where to start

BRIEF:
I am working on a web application, we decide to make some major. We did some researches and we found this tutorial that talks about "Creating api centric application".
we found the topic is very useful to us as we need in the near future to make an android app.
WE STARTED WITH:
Doing some searches starting from this query "api centric application" and we found these two topics related to that query:
REST
WEB SERVICE
WHAT WE WANT TO KNOW:
What is the difference between these terms "API centric application", "REST", "Web Service"
Is Rest an alternative way of Web service?
Is API Centric Application an approach of REST?
Is Web Service the parent of all this terms?
Do i need to produce some other information in order to this question
be eligible for policy.
After study all these types i found that:
A Web Service is a type of API, and all web-services must be API but not all API's must be web-services, The REST is a new concept of writing web-services and Web services written by apply REST Architectural concept are called RESTful web services
So my focus will be on changing my application to be API centric application by using REST Web service as this practice