Anggaplah kita memiliki sumber daya seperti ini,
book:
type: object
properties:
author: {type: string}
isbn: {type: string}
title: {type: string}
books:
type: array
items: book
Jadi, ketika seseorang membuat GET
sumber daya di buku, kami akan mengembalikan yang berikut
[{"author": "Dan Brown", "isbn": "123456", "title": "Digital Fortress"},
{"author": "JK Rowling", "isbn": "234567", "title": "Harry Potter and the Chamber of Secrets"}]
Saya mendengar dari seseorang di tempat kerja bahwa praktik REST yang disarankan adalah selalu mengembalikan respons sebagai objek JSON, yang berarti skema kami books
akan terlihat seperti ini,
books:
type: object
properties:
list:
type: array
items: book
Jadi, sekarang, respons akan terlihat seperti ini,
{
"list": [{"author": "Dan Brown", "isbn": "123456", "title": "Digital Fortress"},
{"author": "JK Rowling", "isbn": "234567", "title": "Harry Potter and the Chamber of Secrets"}]
}
Manakah dari ini yang merupakan praktik REST terbaik?