Laravel 5.2/Ссылка ресурса API Dingo в ответе

Question

Я пытаюсь использовать API-интерфейс Dingo для реализации API-интерфейсов RESTful для нашего webapp. Лучшие практики говорят, что полезная нагрузка ответа должна содержать links для возвращаемых объектов ресурсов. Он может быть в форме _link или href. Я не вижу способа включить это в ответ без использования URL-адреса ресурса. Я хотел был бы получить ответ примерно как ...

[ 
{ 
    'person': "Joe", 
    '_link': 'http://api.mydomain.com/v1/persons/2' 
}, 
{ 
    'person': "Pat", 
    '_link': 'http://api.mydomain.com/v1/persons/3' 
} 
] 

Есть ли способ включить ссылку ресурса в ответ?

Answer 1

Вы используете преобразования для генерации ваших данных ответа. Dingo API использует Fractal как слой преобразования по умолчанию. Таким образом, вы будете нуждаться в PersonTransformer к примеру, как показано ниже:

<?php 
namespace App\Transformer; 

use App\Model\Person; 
use League\Fractal; 

class PersonTransformer extends Fractal\TransformerAbstract 
{ 
    public function transform(Person $person) 
    { 
     return [ 
      'id' => (int) $person->id, 
      'person' => $person->name, 
      'links' => [ 
       [ 
        'rel' => 'self', 
        'uri' => '/persons/' . $person->id, 
       ], 
      ], 
     ]; 
    } 
} 

Вы можете обратиться к следующей ссылке для получения дополнительной информации о преобразованиях и как использовать их для конкретных фрактал. Fractal Transformers