Diferencia entre revisiones de «Usuario:ManuelRomero/Laravel/API»

Crear un aplicación

laravel new api --git

Fichero de rutas

• Se va a realizar una api que va a ser una aplicación para ser consumida por otra o por nosotros usando la normativa/recomendación rest, que luego comentaremos
• El fichero de rutas que se usa para una api, debería de ser el de /routes/api.php, en lugar de el de /routes/web.php
• La principal diferencia entre este fichero de rutas api.php y web.php son sus middelware.

¨Los middelware están especificados en el fichero http/kernel.php y ver los middelware que usa cada ruta.

• Ahí vemos los middelware aplicados al fichero web y al fichero api:

    protected $middlewareGroups = [
        'web' => [
            \App\Http\Middleware\EncryptCookies::class,
            \Illuminate\Cookie\Middleware\AddQueuedCookiesToResponse::class,
            \Illuminate\Session\Middleware\StartSession::class,
            \Illuminate\View\Middleware\ShareErrorsFromSession::class,
            \App\Http\Middleware\VerifyCsrfToken::class,
            \Illuminate\Routing\Middleware\SubstituteBindings::class,
        ],
 
        'api' => [
            // \Laravel\Sanctum\Http\Middleware\EnsureFrontendRequestsAreStateful::class,
            //thorttle es un límite de peticiones en un determinado tiempo
            'throttle:api',
            \Illuminate\Routing\Middleware\SubstituteBindings::class,
        ],
    ];

(: Los middelware aplicados a api son trhottle, es decir el límite de peticiones en un determinado tiempo para evitar ataques y que el servidor se quede bloqueado)

• Si miramos las rutas creadas con

php artisan route:list --except-vendor

Vemos que aparece una ruta

  bookspai git:(master) ✗ php artisan  route:list --except-vendor
 
  GET|HEAD       / ........................................................... 
  GET|HEAD       api/user ....................................................

• Observamos que la ruta user, definida en el fichero routes/api.php no tiene el prefijo
• Este se pone en fichero RouteServiceProviders en el método boot se establece
• Posibilidad de crear más prefijos y más ficheros, por ejemplo diferentes versiones (Pendiente probar)

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

Creando los modelos de nuestra api

php artisan make:model Book -mf --apo

• -m migracion
• -f factory
• --api crea el controlador con los métodos tipo Rest
• LA especificación Rest me dice cómo deberían de ser las solicitudes y los métodos asociados para atenderlos

Archivo:Rest api.png(21:50)

Podemos no utilizar la ruta de editar un libro o crear un libro, ya que no vamos a utilizarlo al ser una API, solo vamos a consumir datos.

Modificando el fichero de rutas api.php

• Ahora especicamos las rutas rest, usando el métod ApiRoute de la facade Route

Route::apiResource("bookd", \App\Http\Controllers\BookController::class);

• Podemos ver ahora las rutas

 bookspai git:(master) ✗ php artisan route:list --except-vendor
 
  GET|HEAD        / ......................................................................................................... 
  GET|HEAD        api/books .............................................................. books.index › BookController@index
  POST            api/books .............................................................. books.store › BookController@store
  GET|HEAD        api/books/{book} ......................................................... books.show › BookController@show
  PUT|PATCH       api/books/{book} ..................................................... books.update › BookController@update
  DELETE          api/books/{book} ................................................... books.destroy › BookController@destroy
  GET|HEAD        api/user .............................................................................................

Implementando los métodos

• Primero debemos crear la base de datos
• Para ello configuramos la conexión(fichero .env)

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=books
DB_USERNAME=manuel
DB_PASSWORD=manuel12345

• Modificamos el fichero de migracion para agregar un campo

public function up()
    {
        Schema::create('books', function (Blueprint $table) {
            $table->id();
            $table->string("title");
 
            $table->timestamps();
        });
    }

• ejecutamos la migración

php artisan migrate

• Añadimos un libro en la base de datos
• Ahora agregamos el código en el método index que es el que se va a ejecutar cuando hagamos una solicitud get a api/books (ver rutas creadas)

 public function index()
    {
        //
        $books=Book::all();
        return $books;
 
 
    }

• Por si hubiera miles de libros se suele usar el método paginate en lugar de all(), observa la salida

 public function index()
    {
        //
        $books=Book::paginate();
        return $books;
 
 
    }

• En este método puedo especificar cuantos registros quiero por página

• Solicitamos en el navegador (previo levantamos el servidor php artisan serve &) y nos aparecer un json con los libros
• PAra verlo un poco parseado instalamos en el navegador algún plugin (por ejemplo json-formatter)

El método show

 public function show(Book $book)
    {
        //
        return $book; 
    }

Observa la salida en los siguientes casos y concluimos

 public function show($book)
    {
        //
        return $book; 
    }
 
//En este caso solo recibimos el identificador
 
public function show(Book $book)
    {
        //
        return Books::find($book); 
    }
//

(: Esto se conoce como Route Binding El Implicit Route Binding es una funcionalidad de Laravel que nos permite atar un modelo a una ruta de forma automática, de tal manera que podamos acceder a los registros de un modelo sin definir de forma explicita una función de búsqueda para dicho registro. )