id,page,ref,title,content,breadcrumbs,references
json_api:json-api-shapes,json_api,json-api-shapes,Different shapes,"The  _shape  parameter can be used to access alternative formats for the
                 rows  key which may be more convenient for your application. There are three
                options: 
             
                 
                     ?_shape=objects  -  ""rows""  is a list of JSON key/value objects - the default 
                 
                 
                     ?_shape=arrays  -  ""rows""  is a list of lists, where the order of values in each list matches the order of the columns 
                 
                 
                     ?_shape=array  - a JSON array of objects - effectively just the  ""rows""  key from the default representation 
                 
                 
                     ?_shape=array&_nl=on  - a newline-separated list of JSON objects 
                 
                 
                     ?_shape=arrayfirst  - a flat JSON array containing just the first value from each row 
                 
                 
                     ?_shape=object  - a JSON object keyed using the primary keys of the rows 
                 
             
             _shape=arrays  looks like this: 
             {
  ""ok"": true,
  ""next"": null,
  ""rows"": [
    [3, ""Detroit""],
    [2, ""Los Angeles""],
    [4, ""Memnonia""],
    [1, ""San Francisco""]
  ]
} 
             _shape=array  looks like this: 
             [
  {
    ""id"": 3,
    ""name"": ""Detroit""
  },
  {
    ""id"": 2,
    ""name"": ""Los Angeles""
  },
  {
    ""id"": 4,
    ""name"": ""Memnonia""
  },
  {
    ""id"": 1,
    ""name"": ""San Francisco""
  }
] 
             _shape=array&_nl=on  looks like this: 
             {""id"": 1, ""value"": ""Myoporum laetum :: Myoporum""}
{""id"": 2, ""value"": ""Metrosideros excelsa :: New Zealand Xmas Tree""}
{""id"": 3, ""value"": ""Pinus radiata :: Monterey Pine""} 
             _shape=arrayfirst  looks like this: 
             [1, 2, 3] 
             _shape=object  looks like this: 
             {
  ""1"": {
    ""id"": 1,
    ""value"": ""Myoporum laetum :: Myoporum""
  },
  ""2"": {
    ""id"": 2,
    ""value"": ""Metrosideros excelsa :: New Zealand Xmas Tree""
  },
  ""3"": {
    ""id"": 3,
    ""value"": ""Pinus radiata :: Monterey Pine""
  }
] 
             The  object  shape is only available for queries against tables - custom SQL
                queries and views do not have an obvious primary key so cannot be returned using
                this format. 
             The  object  keys are always strings. If your table has a compound primary
                key, the  object  keys will be a comma-separated string.","[""JSON API""]",[]