Restful最佳实践

遵循规范

API版本控制

API版本控制有三种方式：
- 无版本控制
无版本控制，每次API的升级都写新的接口，不影响旧的。
- 版本控制

错误定义

遵循常规通用的错误定义

常规通用错误对照表

Response Class HTTP Status Code Symbol 消息 100 continue 101 switching_protocols 102 processing 成功 200 ok 201 created 202 accepted 203 non_authoritative_information 204 no_content 205 reset_content 206 partial_content 207 multi_status 208 already_reported 226 im_used 重定向 300 multiple_choices 301 moved_permanently 302 found 303 see_other 304 not_modified 305 use_proxy 306 reserved 307 temporary_redirect 308 permanent_redirect 客户端错误 400 bad_request 401 unauthorized 402 payment_required 403 forbidden 404 not_found 405 method_not_allowed 406 not_acceptable 407 proxy_authentication_required 408 request_timeout 409 conflict 410 gone 411 length_required 412 precondition_failed 413 request_entity_too_large 414 request_uri_too_long 415 unsupported_media_type 416 requested_range_not_satisfiable 417 expectation_failed 422 unprocessable_entity 423 locked 424 failed_dependency 426 upgrade_required 428 precondition_required 429 too_many_requests 431 request_header_fields_too_large 服务端错误 500 internal_server_error 501 not_implemented 502 bad_gateway 503 service_unavailable 504 gateway_timeout 505 http_version_not_supported 506 variant_also_negotiates 507 insufficient_storage 508 loop_detected 510 not_extended 511 network_authentication_required