While using the PHP league's Fractal as the transformer for my API, I have encountered an issue where the item transformer is wrapping everything in an array similar to a collection. This goes against the standards set by the JSON API.
For instance, when retrieving a user with ID of one, the response looks like this:
{
"users":[
{
"id":1,
"firstName":"Jacob",
"surname":"Windsor",
}
]
}
It should actually look like this:
{
"users":
{
"id":1,
"firstName":"Jacob",
"surname":"Windsor",
}
}
This inconsistency is causing issues with naming conventions in Ember.js.
In my Laravel userController, the code snippet looks something like this:
public function show($id)
{
$user = User::find($id);
return $this->respondItem($user);
}
This issue stems from the apiController, which all controllers extend:
public function respond($response, $status = 200){
return Response::make($response, $status);
}
public function respondTransform($resource){
$fractal = new Fractal\Manager();
$fractal->setSerializer(new JsonApiSerializer());
return $this->respond($fractal->createData($resource)->toJson());
}
public function respondItem($data, $transformer = null, $namespace = null){
! isset($transformer) ? $transformer = $this->transformer : $transformer = $transformer;
! isset($namespace) ? $namespace = $this->namespace : $namespace = $namespace;
$resource = new Item($data, $transformer, $namespace);
return $this->respondTransform($resource);
}
It seems like there might be an error in my implementation. The documentation for Fractal doesn't provide examples specifically for items, only collections. As a result, I am unsure about the mistake I may have made.