angular.js - Adakah terdapat sebarang amalan terbaik yang popular untuk mereka bentuk format data JSON yang dikembalikan oleh antara muka API?

Question

Baru-baru ini, syarikat kami membangunkan projek bahagian PC, bahagian APP mudah alih dan bahagian web mudah alih Adakah terdapat sebarang amalan terbaik yang popular untuk mereka bentuk format data JSON yang dikembalikan oleh antara muka API.

Pada masa ini saya telah menemui versi berikut

Versi 1: Berjaya dilaksanakan: kepala Kod Status:2XX

json {"id":51,"umur":58,"nama":"lifei"}

Kepala pelaksanaan yang gagal Kod Status:4XX-5XX {"message":"xxxxxx error","errors:{}}

Versi 2: Kepala pelaksanaan yang berjaya dan gagal Kod Status:2xx

json {"code":"0","message:"information","data":{}}

Versi 3: Berjaya dilaksanakan: kepala Kod Status:2XX

json {"id":51,"umur":58,"nama":"lifei"}

Kepala pelaksanaan yang gagal Kod Status:4XX-5XX {"code":10001, "message":"xxxxxx error","errors:{}}

Jika terdapat pelbagai jenis kesalahan dalam perniagaan, contohnya, jika saya ingin mengeluarkan wang tunai, mungkin ada kesilapan seperti kad bank tidak terikat, buku akaun tidak dimuat naik, kad pengenalan tidak dimuat naik. , nombor telefon bimbit tidak terikat, alamat tidak diisi, tiada baki dan lain-lain tunggu.

Answer 1

Jenis ini
http://swagger.io/

Answer 2

http://jsonapi.org/

https://github.com/interagent...

Spesifikasi jenis ini agak rumit, tetapi anda boleh mempelajarinya sekali dan menggunakannya seumur hidup, dan kedua-dua bahagian hadapan dan belakang boleh digunakan semula dengan mudah

Kelebihan mentakrifkan spesifikasi anda sendiri ialah ia mudah, tetapi banyak butiran mungkin tidak dipertimbangkan semasa reka bentuk, menjadikan pengubahsuaian sangat menyusahkan

Answer 3

https://github.com/ShuyunXIAN...

Answer 4

JSON RPC 2.0
http://www.jsonrpc.org/specif...