Не возвращайте JSON массивы в API

Если в API вам нужно вернуть JSON массив, подумайте о том, чтобы завернуть его в объект, даже если кроме этого массива в объекте ничего не будет.

Например, вместо:

["red", "green", "yellow"]

Лучше сделать:

{
  "data": ["red", "green", "yellow"]
}

API имеет свойство меняться со временем и вы можете захотеть добавить какую-то информацию помимо массива. В первом примере это невозможно сделать, не сломав обратную совместимость. Во втором варианте таких проблем нет:

{
  "data": ["red", "green", "yellow"],
  "shape": "circle"
}