Top "Api-design" questions

API design is the process of determining and exposing a set of consistent method signatures, return values, and documentation intended for use by other developers to allow programmatic access to data.

Rest api design: POST to create with duplicate data, would-be IntegrityError/500, what would be correct?

I have a normal, basic REST api like: / GET - list POST - create /<id> GET - detail …

api http rest api-design
What is the gold standard for website APIs? Twitter, Flickr, Facebook, etc

Seems like there are two categories of APIs for websites today. APIs which allow the functionality of the site to …

rest api-design asp.net-web-api
Why is the Java date API (java.util.Date, .Calendar) such a mess?

As most people are painfully aware of by now, the Java API for handling calendar dates (specifically the classes java.…

java date api-design
How to handle pagination in retrofit

I'm building an app using retrofit. Everything's working swimmingly, but I'm worried about the size of my API requests and …

android api-design retrofit okhttp
Return data from Laravel Jobs

I am developing API on Laravel for mobile application. Methods will make requests to other API's, combine and filter data, …

php laravel api-design task-queue
GB English, or US English?

If you have an API, and you are a UK-based developer with a highly international audience, should your API be …

api naming-conventions api-design
Link to another resource in a REST API: by its ID, or by its URL?

I am creating some APIs using apiary, so the language used is JSON. Let's assume I need to represent this …

json api rest api-design hateoas
Identify item by either an ID or a slug in a RESTful API

I'm currently designing an API and I came a cross a little problem: How should a URL of a RESTful …

api rest api-design
Is "logout" useless on a REST API?

Considering that, by definition, a REST API is stateless: is the "logout" operation useless? I mean, I'm creating a REST …

rest logout jwt api-design
Using annotation to ensure that value returned by method is not discarded

String in Java is immutable. The following snippet is, broadly speaking, "wrong". String s = "hello world!"; s.toUpperCase(); // "wrong"!! System.…

java annotations return-value api-design