Versión 2: recurso

Nuevamente vuelvo a recomendar el Curso de Postman 👀
.
Relamente alguien que desarrolla el frontend no te va a estar hablando para preguntarte cuáles son los campos que vas a mandar, etc. Si no que tú como el desarrolador de API debes generar una documentación que te diga cuáles son los endpoints y qué retorna, por ejemplo, esta sería la documentación de Conekta (una pasarela de pagos):
.
Documentación del API Conekta
.
Aquí se alcanza a ver cómo del lado izquierdo se encuentra la descripción y del lado derecho el código para hacer el request en diversos lenguajes, eso es lo que tú tienes que generar.
.
Ahora, por eso recomiendo el curso de Postman, porque Postman, a medida que vas haciendo tus tests y pruebas, va registrando cada respuesta que te devuelve tu API, y al final del día él va a guardar todo eso y con un simple click te va a generar una página de documentación muy similar a la de Conekta en varios lenguajes de programación 😄

Nuevamente YO jaja!
Un tip para que no tengan sus endpoints de v1 y v2 en el mismo archivo es que separen los mismo por un archivo y los registren en el app>>Providers>>RouteServiceProvider.php.

De la siguiente manera:

$this->routes(function () {
            Route::prefix('api/v1')
                ->middleware('api')
                ->namespace($this->namespace)
                ->group(base_path('routes/api/v1.php'));

            Route::prefix('api/v2')
                ->middleware('api')
                ->namespace($this->namespace)
                ->group(base_path('routes/api/v2.php'));

            Route::middleware('web')
                ->namespace($this->namespace)
                ->group(base_path('routes/web.php'));
        });

Les comparto el código del archivo
App/Http/Resources/V2/PostResource.php

  public function toArray($request)
  {
    return [
      'id' => $this->id,
      'post_name' => $this->title,
      'slug' => $this->slug,
      'content' => $this->content,
      'author' => [
        'name' => $this->user->name,
        'email' => $this->user->email,
      ],
      'created_at' => $this->published_at
    ];
  }

Alternativa a postman

Les recomiento tambien el uso de https://insomnia.rest/ ya que postman tiene demasiadas funciones por lo que aveces puede consumir 500 Mb, y ser algo agobiante.
Tambien se actualizaciones frecuentemente.

se debe documentar como hacer request y que response devuelve cada endPoint, pero tanto los tester como frontEnd deben poder hacer algo como consultar por medio de postman con el estandar rest(verbos) y pues con el response saben como codificar el front