restful-api-guidelines icon indicating copy to clipboard operation
restful-api-guidelines copied to clipboard
verified publisher icon zalando

Guide return code usage for (robust) create

Open tfrauenstein opened this issue 4 years ago • 0 comments

Improve guidance for return code usage for (robust) create.

  • 201 (success, created) vs. return code 200 (success, robust repetition) vs. 409 (error, no robust repetition)
  • 20x are idempotent
  • 302 (or other 3xx codes) should not be used

affected rules:

  • https://opensource.zalando.com/restful-api-guidelines/#229
  • https://opensource.zalando.com/restful-api-guidelines/#150

Related discussion see https://github.com/zalando/restful-api-guidelines/issues/655#issuecomment-907000485

tfrauenstein avatar Sep 07 '21 13:09 tfrauenstein