Modificación de recursos en servidor con método HTTPS Push

Contenido del curso

Comprender los objetivos y pre-requisitos del curso

Conocer los conceptos principales de REST

Aprender a consumir servicios REST

5
Consumo de APIs con PHP y manejo de peticiones HTTP
09:38 min

Aprender a producir servicios REST

Conocer diferentes modos de restringir el acceso a las API Rest

Aprender a tratar errores en la comunicación vía REST

14
Manejo de Errores HTTP en Cliente y Servidor con PHP
08:20 min

Aprender a utilizar una API Rest para la comunicación FrontEnd/BackEnd

Conocer buenas prácticas del diseño de APIs REST

19
Buenas prácticas para diseñar APIs RESTful
02:32 min

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:004:06

Recursos

Resumen

Es importante recordar que el método PUT hace un reemplazo, no modificaciones puntuales. Por ello la información que enviemos a través de la petición debe ser completa.

Modificación de recursos en servidor con método HTTPS Push

Curso de API REST con PHP

Clase 9 de 19

Clase 9 / 19

Carlos Nassif Trejo Garcia

Hace 6 años

Mi version en Python basándome en el código de demás usuarios de clases previas:

# Imports
from flask import Flask, jsonify, make_response
from flask_restful import Resource, Api, abort, request

# Create app and api
app = Flask(__name__)
api = Api(app)

# Data base
BOOKS = {
    '1': {
        'isbn': '744586',
        'title': 'Cien años de soledad',
        'description': 'Lorem insup lol.',
        'autor': 'Gabriel Garcia Marquez'
    },
    '2': {
        'isbn': '7894546',
        'title': 'De animales a dioses',
        'description': 'Lorem insup lol.',
        'autor': 'Yuval Noah Harari'
    }
}

# Aborts the request and returns an error
def abort_if_book_doesnt_exits(book_id):
    if book_id not in BOOKS:
        abort(404, message='El libro con id {} no existe'.format(book_id))

# Returns the whole book list
class BookList(Resource):
    def get(self):
        return jsonify({'data': BOOKS}) # Returns as json in data variables

    # Metodo para agregar nuevo libro
    def post(self):
        # Getting the request as json format
        json = request.get_json(force=True)

        # Index to post the new book
        index = len(BOOKS) + 1

        # Putting the new book in the database
        BOOKS.update( {'{}'.format(index): json } )

        # Returining the ID to the user
        return 'Libro agregado correctamente con ID: ' + str(index)

# Returns an especific id book
class Book(Resource):
    def get(self, book_id):
            abort_if_book_doesnt_exits(book_id)
            return make_response( jsonify(BOOKS[book_id]), 200 ) # Returns a response as json with some info code

    def put(self, book_id):
        # Getting the request as json format
        json = request.get_json(force=True)

        # If the id donesn't exist, then quit
        abort_if_book_doesnt_exits(book_id)

        # Replace the information of the book
        BOOKS.update( {'{}'.format(book_id): json} )

        # Return the whole collection
        return jsonify(BOOKS)

class Authors(Resource):
    pass

class Generes(Resource):
    pass

# Add resources as REST arquitecture
api.add_resource(BookList, '/books')
api.add_resource(Book, '/books/<book_id>') #<> means it's a variable
api.add_resource(Authors, '/authors')
api.add_resource(Generes, '/generes')

if __name__ == '__main__':
    app.run(debug=True)

Comentarios (40)40 comentarios

Marla Carolina Prieto Pelayo

Hace 7 años

Código de la clase, Método PUT

<?php

$allowedResourceTypes = [
    'books',
    'authors',
    'genres'
];

$resourceType = $_GET['resource_type'];

if( !in_array($resourceType, $allowedResourceTypes)){
    die;
}

// Defino los recursos
$books = [
    1 => [
        'titulo' => 'Lo que el viento se llevo',
        'id_autor' => 2,
        'id_genero' => 2,
    ],
    2 => [
        'titulo' => 'La Iliada',
        'id_autor' => 1,
        'id_genero' => 1,
    ],
    3 => [
        'titulo' => 'La Odisea',
        'id_autor' => 1,
        'id_genero' => 1,
    ],
];

// Se indica al cliente que lo que recibirá es un json
header('Content-Type: application/json');
// Levantamos el id del recurso buscado
$resourceId = array_key_exists('resource_id', $_GET) ? $_GET['resource_id']:'';

// Generamos la respuesta asumiendo que el pedido es correcto y devilvemos en formafo json
switch( strtoupper($_SERVER['REQUEST_METHOD']) ) {
    case 'GET':
        // en caso de que no pidan ningun recurso
         if ( empty( $resourceId ) ){
            echo json_encode( $books );
         }else{
             // si llegan a pedir un recurso en especifico
            if( array_key_exists( $resourceId, $books) ){
                echo json_encode( $books[ $resourceId ] );
            }
        }
        break;
    case 'POST':
        $json = file_get_contents('php://input');
        // transformamos el json recibido a un nuevo elemento del arreglo
        $books[] = json_decode($json, true);
        // emitimos hacia la salida la ultima clave del arreglo de los libros
        // echo array_keys( $books )[count($books) -1];
        echo json_encode($books);
        break;
    case 'PUT':
        //validamos que el recurso buscado exista
        if (!empty($resourceId) && array_key_exists($resourceId, $books)){
            // Tomamos la entrada cruda
            $json = file_get_contents('php://input');
             // transformamos el json recibido a un nuevo elemento del arreglo
            $books[$resourceId] = json_decode($json, true);
            // Retornamos la coleccion modificada en formato json
            echo json_encode($books);
        }
        break;
    case 'DELETE':
        break;
}



// Inicio el servidor en la terminal 1, aqui le asignamos el puerto 8000
// php -S localhost:8000 server.php

// Terminal 2 ejecutar 
// curl http://localhost:8000 -v
// curl http://localhost:8000/\?resource_type\=books
// curl http://localhost:8000/\?resource_type\=books | jq
// ver la comunicacion a través de los encabezados:
// $ curl http://localhost:8000/\?resource_type\=books -v > /dev/null
// consulta
//$curl "http://localhost:8000?resource_type=books&resource_id=1"
// Método POST
//curl -X 'POST' http://localhost:8000/books -d '{"titulo":"Nuevo Libro","id_autor":1,"id_genero":2}'
// Método Put - el recurso 1 será reemplazado por el libro que estoy creando
// $ curl -X 'PUT' http://localhost:8000/books/1 -d '{"titulo": "Nuevo Libro", "id_autor": 1, "id_genero": 2}'
?>

Juan Pablo Perez

Gracias por el aporte.

Luis Abdel Rangel Castro

PATCH

HTTP PUT method only allows a complete replacement of a document. A PATCH request on the other hand, is used to make changes to part of the resource at a location. That is, it PATCHES the resource — changing its properties. It is used to make minor updates to resources and it's not required to be idempotent.

Jimmy Buriticá Londoño

Buen aporte

Dimanso Perez

GET El método GET solicita una representación de un recurso específico. Las peticiones que usan el método GET sólo deben recuperar datos. HEAD El método HEAD pide una respuesta idéntica a la de una petición GET, pero sin el cuerpo de la respuesta. POST El método POST se utiliza para enviar una entidad a un recurso en específico, causando a menudo un cambio en el estado o efectos secundarios en el servidor. PUT El modo PUT reemplaza todas las representaciones actuales del recurso de destino con la carga útil de la petición.

DELETE El método DELETE borra un recurso en específico. CONNECT El método CONNECT establece un túnel hacia el servidor identificado por el recurso.

OPTIONS El método OPTIONS es utilizado para describir las opciones de comunicación para el recurso de destino. TRACE El método TRACE realiza una prueba de bucle de retorno de mensaje a lo largo de la ruta al recurso de destino.

PATCH El método PATCH es utilizado para aplicar modificaciones parciales a un recurso.

Elmer Padilla Espinoza

Gracias por los comandos Mr.Perez.

Carlos Eduardo Gomez García

Vale, PUT hace un reemplazo COMPLETO del recurso, si queremos hacer modificaciones puntuales debemos usar el método PATCH (Recomiendo investigarlo)

Enrique Garcia Stave

Apuntes: La modificación de datos correspondería a un update en un CRUD, y tiene partes similares a las de GET y POST. Nota: Para los que usan IIS, deben dirigirse a la herramienta de “asignaciones de controlador”, hacer doble click en el controlador de PHP (para el caso que tengan instalados mas de 2 interpretes, seleccionen el que les aparezca en el phpinfo), dirigirse a la opción de restricciones de solicitudes, luego en la pestaña de los versos, seleccionar “todos los verbos”. IIS por defecto nos presenta problemas con los verbos PUT y DELETE.

Mariano Gastón Paduani

Hace 5 años

Gracias!

Israel Yance

El método PUT hace reemplazos, la información se debe de enviar completa. Petición: $ curl -X 'PUT' http://localhost:8000/books/1 -d '{"titulo": "Nuevo Libro", "id_autor": 1, "id_genero": 2}'

lucas cartisano

Hace 4 años

El metodo PUT reemplaza toda la información completa del recurso, pero existe también el metodo PATCH que puede reemplazar datos específicos, como por ejemplo solo el nombre, o solo el autor

Christian David Sánchez

GET para obtener un recurso del servidor del servidor POST para actualizar un recurso del servidor PUT para crear un recurso del servidor DELETE para eliminar un recurso del servidor

William Rodriguez

te quedo cruzado post y put

Upps cierto. POST para crear un recurso del servidor PUT para actualizar un recurso del servidor

Ayriel Noriega

Hace 2 años

¿Por qué existe PATCH en REST?

La razón de tener ambos métodos es que, en algunos casos, quieres evitar sobrecargar la comunicación enviando datos innecesarios. PATCH es más ligero porque solo envías los datos que cambian, lo que puede ser muy eficiente en aplicaciones con grandes recursos o estructuras de datos. Esto también minimiza el riesgo de sobrescribir campos no deseados.

Gonzalo Gramaglia

¿Y si quiero hacer alguna modificación puntual? ¿Hay algún método que me permita hacerlo?

Massimo Di Berardino

Hola Gonza. Para modificar atributos especificos de una entidad se utiliza el método PATCH.)

LISANDRO MENDEZ

Saludos, alguien tiene una idea si en vez de un array se guarde en una base de datos ejemplo mysql en php? el encabezado y el detalle ejemplo si fuera un tipo factura.

Luis Mojica

Profesor

¿Podrías elaborar mas sobre tu pregunta? no es muy clara aún.

Saludos, imagina que tengo un array encabezado de factura con datos de cliente, fecha, numero de factura, monto total, etc y otra con el detalle de los productos de esa factura relacionado con una clave foranea. Quisiera guardar esa transacción completa en una base de datos cada array en su tabla correspondiente.

Luis Abraham Rosas Barajas

Pesimo curso, le netflix

Kevin Morales

Por qué crees que es un pésimo curso? Cuéntanos

Julio Cardenas

Creo que este no es un curso para principiantes.

Es un curso para alguien que haya hecho el backend de servidores web.

Para quien se haya estrellado leyendo parametros, pasando informacion, haciendo querys en bases de datos, codificando en json.

Si uno no tiene esos prerequisitos es facil perderse.

Las clases son cortas pero llenas de contenido. Me ha tocado repetir algunas varias veces.

Lucas Alvarez

Erik Alejandro Garcia Duarte

aqui les dejo el codigo en python y con flask

Jhon Alexander Romero Gonzaga

Con un poco de lectura en el codigo, se comprende mejor.

Aarón Anibal Ramirez Herrera

curl -i -X PUT-H "Content-Type: application/json" -d "{""titulo"":""EL LOBO DE WALL STREET"",""id_autor"":5,""id_genero"":6}" http://localhost/api_rest/route.php/books/1

Luis Daniel Mendoza Rodríguez

Para los que no le esta funcionando el comando de curl en windows, yo uso la terminal de laragon.

λ curl -H "Content-Type:application/json" -X PUT -d "{ \"titulo\":\"Iliadaaaa\",\"id_autor\": 1,\"genero\": 2}" http://localhost:8000/books/1```

Añaqui Apolinar Morales

Si les sigue marcando errores o mas bien no les muestra nada les dire como consejo que empiecen a debuggear, es una excelente practica para entender lo que se esta haciendo

Alberto Alejandro Núñez Garcia

Todo bien pero en mi caso debo iniciar el servidor para que lo cambios sean efectuados

Comprender los objetivos y pre-requisitos del curso

Integración de Aplicaciones Web con PHP

Concepto y Herramientas Básicas de API en Programación

Conocer los conceptos principales de REST

Conceptos Básicos de HTTP y su Funcionamiento en Navegadores

Protocolo REST: Conceptos y Funciones Básicas

Aprender a consumir servicios REST

Consumo de APIs con PHP y manejo de peticiones HTTP

Aprender a producir servicios REST

Creación de un Servidor REST con PHP

Consulta de recursos específicos en PHP y URLs amigables

Incorporación de Datos a Servidor mediante API REST en PHP

Modificación de recursos en servidor con método HTTPS Push

Eliminar recursos con método DELETE en APIs RESTful

Conocer diferentes modos de restringir el acceso a las API Rest

Autenticación Básica HTTP en PHP: Implementación y Limitaciones

Autenticación Segura con Hashes y Clave Secreta en PHP

Autenticación con Access Touch: Implementación y Funcionamiento

Aprender a tratar errores en la comunicación vía REST

Manejo de Errores HTTP en Cliente y Servidor con PHP

Aprender a utilizar una API Rest para la comunicación FrontEnd/BackEnd

Comunicación Asíncrona en Aplicaciones de una Sola Página

JavaScript para Interacción con el DOM y AJAX

Comunicación con el Servidor Usando AJAX y JSON en JavaScript

Publicación y Configuración de Aplicaciones en Servidores Públicos

Conocer buenas prácticas del diseño de APIs REST

Buenas prácticas para diseñar APIs RESTful

Recursos

Resumen

Modificación de recursos en servidor con método HTTPS Push

Progreso del curso

Comprender los objetivos y pre-requisitos del curso

Conocer los conceptos principales de REST

Aprender a consumir servicios REST

Aprender a producir servicios REST

Conocer diferentes modos de restringir el acceso a las API Rest

Aprender a tratar errores en la comunicación vía REST

Aprender a utilizar una API Rest para la comunicación FrontEnd/BackEnd

Conocer buenas prácticas del diseño de APIs REST