You are not logged in. Your edit will be placed in a queue until it is peer reviewed.
We welcome edits that make the post easier to understand and more valuable for readers. Because community members review edits, please try to make the post substantially better than how you found it, for example, by fixing grammar or adding additional resources and hyperlinks.
Required fields*
-
Consider how it is being consumed. I would lean toward returning an actual empty list. A Success code might be sufficient, but the receiver still has to check to see if a list is returned and handle numerous branches. However if you always return the list (or whatever base object) a receiver on success knows it can always deserialise to a given type successfully (otherwise it is certain that the connection was prematurely terminated and it did not receive the entire response).Kain0_0– Kain0_02019-08-06 06:27:45 +00:00Commented Aug 6, 2019 at 6:27
-
@Kain0_0 not about my preference, looking for api design refrence, what are the stblished patterns?jimjim– jimjim2019-08-06 06:36:27 +00:00Commented Aug 6, 2019 at 6:36
-
1? I'm failing to see how that was a preference. I pointed out the extra design effort being enforced on each and every client to handle a discontinuous edge case - and how homogeneity avoids that. As for references google it, everyone has a different opinion. As for Rigour, REST is quite clear about that. Take a read of the literature.Kain0_0– Kain0_02019-08-06 07:12:29 +00:00Commented Aug 6, 2019 at 7:12
-
@Kain0_0 : Thank you for the academic refrence, the problem with google search is that I have already tried it and all I see is ideas of some company or blogger, nothing definitive as a text book or protocol definition.jimjim– jimjim2019-08-06 07:59:03 +00:00Commented Aug 6, 2019 at 7:59
Add a comment
|
How to Edit
- Correct minor typos or mistakes
- Clarify meaning without changing it
- Add related resources or links
- Always respect the author’s intent
- Don’t use edits to reply to the author
How to Format
-
create code fences with backticks ` or tildes ~
```
like so
``` -
add language identifier to highlight code
```python
def function(foo):
print(foo)
``` - put returns between paragraphs
- for linebreak add 2 spaces at end
- _italic_ or **bold**
- indent code by 4 spaces
- backtick escapes
`like _so_` - quote by placing > at start of line
- to make links (use https whenever possible)
<https://example.com>[example](https://example.com)<a href="https://example.com">example</a>
How to Tag
A tag is a keyword or label that categorizes your question with other, similar questions. Choose one or more (up to 5) tags that will help answerers to find and interpret your question.
- complete the sentence: my question is about...
- use tags that describe things or concepts that are essential, not incidental to your question
- favor using existing popular tags
- read the descriptions that appear below the tag
If your question is primarily about a topic for which you can't find a tag:
- combine multiple words into single-words with hyphens (e.g. design-patterns), up to a maximum of 35 characters
- creating new tags is a privilege; if you can't yet create a tag you need, then post this question without it, then ask the community to create it for you