Representational State Transfer, or REST, is an architectural style for networking software to transfer information through the web.
1
vote
1answer
38 views
What is the proper way of nesting resources in REST model?
I'm designing a REST API of service and got stuck on proper way to nest resources.
Resources: partners, tickets, settings
Connections between resources:
partner has many tickets,
partner has set ...
1
vote
2answers
226 views
Why is aggregation function bad idea for RESTful?
As title: Why is aggregation function bad idea for RESTful? Although I know CRUD is good for RESTful.
For example, the resource is 'employee', and client needs to retrive sum of total 'salary' of all ...
0
votes
1answer
46 views
Rest API Architecture from Rest in Practice book
We maintain an API that as part of its purpose makes a call to an external API. This external API takes a few seconds to fulfil the request we make to it. With our current architecture the request is ...
1
vote
4answers
143 views
Provide both RESTful interfaces and Java ones?
I am writing a RESTful service in Java, of course it's typical HTTP based interface.
I am wondering should the service provide Java interface which has same semantic to the RESTful interface? I think ...
0
votes
1answer
53 views
Combining Single Page Application and DDD with a REST API
I'm creating a web application which on the client side consists of a Single Page Application (with Durandal) and on the server side an ASP.NET MVC site with a Domain Driven Design. The two are ...
4
votes
1answer
135 views
Where to Perform Authentication in REST API Server?
I am working on a set of REST APIs that needs to be secured so that only authenticated calls will be performed. There will be multiple web apps to service these APIs. Is there a best-practice approach ...
3
votes
4answers
477 views
REST API concepts
I have three questions about REST API design that I'm hoping someone can shed some light on. I've searched relentlessly for many hours but haven't found answers to my questions anywhere (maybe I just ...
4
votes
3answers
228 views
Best Practice: Should error messages be handled by the API or by the App?
I am designing an application that interacts with a RESTful API.
When returning error messages like Unable to sign up user
Should the error message be generated by the app? or by the API? I am ...
18
votes
2answers
460 views
Levels of user permissions in a RESTful API
Let's say I have a company that ranks the cutest cats on the internet.
I offer a resource at /cats/ which provides users with the latest, cutest adorable cats.
Users can either get just the top 3 ...
2
votes
0answers
44 views
Modelling a resource that may not be part of the parent resource
I am designing an API and am having a couple of problems with certain parts of the resource modelling.
I have the notion of a SurveyItem which as a collective form a Survey:
Survey Resource ...
7
votes
3answers
217 views
Are there strategies for discovering REST services using HATEOAS?
When building a REST service with the HATEOAS constraint, it's very easy to advertise the existence of resources through linking. You make a GET to the root of my site and I respond with the root ...
0
votes
2answers
61 views
Working with data and meta data that are separated on different servers
While developing a product, I've come across a situation where my group wants to store meta data for data entry forms (questions, layout, etc) in a different database then the database where the ...
1
vote
1answer
101 views
ROA on top of SOA [closed]
I already have a stable Service Oriented Architecture for my application which exposes services as API calls. (the verbs)
Now, I need to build a Resource Oriented Architecture to expose a RESTful API ...
3
votes
3answers
101 views
RESTful applications logic and cross resource operations
I have an RESTful api that allows my users to receive enquiries about their business e.g. 'I would like to book service x on date y. Is this available?'. The api saves this information as a resource ...
17
votes
10answers
585 views
When does SOAP make more sense than REST?
From my understanding of REST, the implicit assumption is that all operations are CRUD operations. Sometimes, you are not doing CRUD operations and are doing some more complex logic. In this case, is ...
1
vote
0answers
52 views
how to integration dynamic web fields and forms
I'm trying to find a way to design backend that will be handling customized web forms creation on the fly. Once created those forms will be injected to part of the existing web pages.
I've created ...
6
votes
4answers
225 views
When did the first “REST”-model and friendly URL web technology come to be?
Everyone knows that the "current" way to do things is to have user-readable URLs. Like:
http://example.com/blog/edit/1234
Rather than:
http://example.com/blog.php?action=edit&id=1234
When ...
2
votes
1answer
58 views
Should I provide client libraries in some select languages along with the APIs themselves?
Say I have created a web service based on RESTful APIs. Does it make sense to also provide users with a client library for the API in some select languages which are likely to be the most used ones? ...
0
votes
0answers
48 views
SharePoint + InfoPath Joins
I am trying to do something somewhat unique, and the best path I can find at the moment is to use List joins, but I'm not sure this is possible. I'm hoping someone can suggest a best course of ...
19
votes
8answers
3k views
RESTful API design. What should I return if there are no rows?
I'm currently coding an API for a social network with the Slim Framework. My question is: What are the best practices when there are no rows to return in the json structure?
Lets say that this call ...
3
votes
1answer
90 views
What does it mean for an architectural style to be document-centric?
I heard it said that REST is "document-centric". Unclear what this meant, I began poking around and found the term document-oriented being used of databases, particularly NoSQL databases, and in ...
1
vote
2answers
142 views
How can I send data without POSTFIELDS in PHP curl?
I'm using a REST API through PHP and I'm a bit confused on the CURL_POSTFIELDS behavior, which implies that I must send a querystring or array, but what I'm seeking to do is just to send a string of ...
2
votes
2answers
187 views
Software Architecture Modelling
I am a little confused at how best to visually model a space-based architecture (SBA) for presenting the system/software architecture design to a client.
The goal of this modelling is to show:
The ...
1
vote
3answers
135 views
How to get different resources in a single endpoint in RESTful?
I have a REST webservice that have a couple of resources, like Company and User. But now I need to make a modification to the API to return a special list combining company, user and maybe other type ...
2
votes
2answers
98 views
Disagreement Concerning Data Integration (I may not understand enterprise ETL tools)
I have been in an ongoing conversation concerning a project we are about to undertake at my place at work. The project concerns data integration. Our customers want to be able to integrate our data ...
0
votes
1answer
95 views
REST API internal directory structure and RewriteEngine
I'm building a REST API. I don't want to have real folders in my directory structure, but I'm not quite sure what to use else. My REST API uses paths like this:
...
0
votes
2answers
97 views
Building Website with JAX-RS (Jersey)
Is it discouraged/not-common to build Websites (not web-services!) using Jersey or any other JAX-RS implementation ?
I didn't find any guide/tutorial/article regarding that..
At first impression , ...
1
vote
3answers
160 views
Is RESTful API appropriate for services which are nearly computational in nature?
Is RESTful API appropriate for the following scenario?
A time-limited token is obtained, which will last for one minute only
Image is uploaded to a server
Server performs some CPU-heavy image ...
2
votes
2answers
134 views
How to be robust against webservice downtime caused by third parties
I'm using iPage as my cloud based server provider. I haven't had any problems with them yet. They hold the scripts for my RESTful services for the mobile app I'm developing. My problem however is ...
0
votes
1answer
338 views
Implementing a claims-based security model to secure a WCF service
Currently, all of our web applications (and the WCF services they interact with) are run internally. Nothing is exposed to the web. We want to open up our web applications to the Internet and will ...
0
votes
0answers
162 views
How to build a highly scalable REST web service? [closed]
Here's an example of what I'm trying to accomplish, which is a public url-based youtube to animate gif conversion service. (ex. http://a.com/youtubevideourl/out.gif) I'm not sure as to what specific ...
0
votes
1answer
138 views
Recommendations on what technology to use to call REST API [closed]
I'm creating a small web-site that needs to call a REST API to retrieve some JSON and display it. What is the best tool for this job?
There are so many Javascript libraries available now it is ...
2
votes
2answers
125 views
How to handle many arguments in an API wrapper?
I'm writing a PHP API wrapper for a third party API. I want to make all the methods consistent, but I'm not sure how to handle the number of arguments some API routes accept. One API request accepts ...
3
votes
3answers
243 views
Versioning an API
I'm starting a side project, the first stage will be a building a web application with MVC, in later stages we will be adding clients for mobile platforms. My thought was to create one API that all of ...
0
votes
0answers
113 views
“Unbiased” recommendation on scalable architecture for real time application [closed]
I've been flipping between a few language/platform combinations trying to determine the best platform combination for a scalable system, that can handle real time application communications.
The goal ...
4
votes
1answer
132 views
Creating an entity relationship in REST: May I create the parent by posting to a child id?
We are currently designing a REST API to access classical customer data.
One of the elements in the API are the assets of an user. The assets are added under a given service. The backend API will ...
8
votes
2answers
397 views
Is this solution RESTful and secure?
Our product registers new players on our service, and we've chosen to host it on Azure (we're using .NET) and we wanted it to be stateless (for scalability) and relatively secure.
Since this is the ...
4
votes
2answers
139 views
Custom functions in a REST API
Looking at two of our entities Company and Address. A company has a billingAddress and a profileAddress.
I'm unsure of how to implement a function to set the billing address versus the profile. Here ...
2
votes
1answer
144 views
REST vs RPC for mobile development
As many know, mobile development is skyrocketing these days and, I believe, it affects what we code. To be specific, I am interested in developing web services for a mobile application.
I see two ...
3
votes
1answer
284 views
Is MVC the optimal pattern to build a RESTful web service?
Not being a Java practitioner, I recently came to learn about the JAX-RS specification and Apache CXF framework. While still wrapping my head around all these things, I also read the this question on ...
0
votes
0answers
61 views
How to properly design REST [duplicate]
I intensively work with REST architecture about last year. And I don't stop a wonder how REST is inflexible or may I can't understand how to properly use it.
So I use REST services on my backend and ...
2
votes
2answers
171 views
RESTful URI's, Creating a new noun/uri or add a queryparameter
I have a Person class with a one to many relationship to Employment. A Person in the CRM can have multiple Employments (historic data).
My current REST URI for this class looks like this:
...
1
vote
1answer
123 views
How to decide the token expiry time in REST web service
I am working on creating a REST ws exposing few API's. A token is required for each API call. I am confused about the expiry time to be set for the token.
Security+Performance wise what is the ideal ...
2
votes
1answer
442 views
Are there any problems with implementing custom HTTP methods?
We have a URL in the following format
/instance/{instanceType}/{instanceId}
You can call it with the standard HTTP methods: POST, GET, DELETE, PUT. However, there are a few more actions that we ...
0
votes
1answer
492 views
Custom use of Authorization header in a REST API
I'm building a REST api where clients are authenticated using client certificates. A client in this case is not an individual user, but some sort of a presentation layer. Users are authenticated using ...
5
votes
1answer
307 views
Best practice for handling asynchronous inter communication?
Recently completed a project for handling credit card processing. One of the difficulties I faced was handling the delay / possible failure of notification messages. The most complex example was:
an ...
4
votes
1answer
856 views
How can I unit-test my REST web service?
I am new to unit testing, I've one REST web method that just calls DB and populates a DTO. Pseudo code is
public object GetCustomer(int id)
{
CustomerDTO objCust = //get from DB
return objCust;
}
...
3
votes
1answer
142 views
Is it OK to partially change a collection with PUT or DELETE?
I have a collection of products in a product group e.g.:
product-groups/123/products
If I need to add to the collection, is it OK that I pass only some products with PUT?
If I need to delete some ...
2
votes
2answers
91 views
What endpoints should I provide, if any, to permit connectivity testing for my web services?
What endpoints should I provide, if any, to permit connectivity / availability testing for my web services / Web API?
TL;DR
I am developing both the server and client in an enterprise environment. ...
4
votes
2answers
431 views
Can REST API be used as business layer?
I am using PHP Codeigniter MVC design pattern
and I had this project with some sort of specific business processes
In my application I will be dealing with 2 existing REST APIs:
Google
Trello
...
