SERVISICIOS-API REST

¿Por qué REST?
1. REST es una forma simple de organizar interacciones entre sistemas independientes. En teoría, REST no está vinculado a la web, pero casi siempre se implementa como tal y se inspiró en HTTP.
¿Cómo se usa una API REST?
1. Un ejemplo del mundo real
  1. http://search.twitter.com/search.json?q=jQuery&result_type=recent&rpp=3
2. Una API REST define un conjunto de funciones que los desarrolladores pueden realizar solicitudes y recibir respuestas a través del protocolo HTTP, como GET y POST.
Requisitos clave para una API REST
1. Use URLs y acciones RESTful
  1. Los principios clave de REST implican separar su API en recursos lógicos. Una vez que haya definido sus recursos, debe identificar qué acciones se aplican a ellos y cómo se correlacionarían con su API.
    1. Ejemplo
    2. 1. GET / tickets: recupera una lista de tickets
      2. GET / tickets / 12 - Recupera un ticket específico
      3. POST / tickets: crea un nuevo ticket
      4. PUT / tickets / 12 - Actualiza ticket # 12
      5. PATCH / tickets / 12 - Actualiza parcialmente el ticket # 12
      6. DELETE / tickets / 12 - Elimina el ticket # 12
2. Una API es la interfaz de usuario de un desarrollador: al igual que cualquier UI, es importante asegurarse de que la experiencia del usuario se piense cuidadosamente.
  1. 1. Debe usar estándares web donde tengan sentido
    2. Debe ser amigable para el desarrollador y ser explorable a través de una barra de direcciones del navegador
    3. Debe ser simple, intuitivo y consistente para hacer que la adopción no solo sea fácil sino también agradable
    4. Debe proporcionar suficiente flexibilidad para impulsar la mayoría de la interfaz de usuario de encantamiento.
    5. Debe ser eficiente, manteniendo el equilibrio con los otros requisitos
Cómo diseñar una API REST
1. En esta sección mostraremos como diseñar una API REST para una aplicación basada en red.
2. Identificar el modelo de objeto
  1. Para una aplicación basada en la red, el modelado de objetos es bastante más simple. Tenga en cuenta que ambos objetos / recursos en nuestro modelo anterior tendrán un identificador único, que es la propiedad de identificación.
    1. Dispositivos
    2. Configuraciones
3. Crear un modelo URI
  1. Ahora que el modelo de objetos está listo, es hora de decidir los URI de los recursos. En nuestra aplicación, un dispositivo es un recurso de nivel superior.
    1. /dispositivos /dispositivos/{id}
    2. /configuraciones /configuraciones/{id}
    3. /dispositivos/{id}/configuraciones /dispositivos/{id}/configuraciones/{id}
4. Determinar representaciones
  1. La mayoría de las representaciones se definen en formato XML o JSON.
1. API REST: Requisitos y Ejemplos
  1. 1. Tipos de API
    2. Ejemplos de API
    3. ¿Qué son las API?

Next up

SERVISICIOS-API REST

Description

Resource summary

Media attachments

Similar

	Created by Xavier Code almost 5 years ago