Métodos HTTP

Los métodos HTTP son como las "instrucciones de acción" que les das a los datos.

En una API RESTful, usamos principalmente cuatro métodos, que corresponden a las cuatro operaciones básicas de los datos:

Método HTTP Función Operación correspondiente Analogía cotidiana
GET Obtener datos Lectura Ver el menú
POST Crear datos Creación Pedir un plato
PUT Actualizar datos Actualización Modificar el pedido
DELETE Eliminar datos Eliminación Cancelar el pedido

Método GET

GET se usa para obtener datos, como cuando le preguntas al camarero: "¿Qué platos hay hoy?"

// 获取所有用户
GET /api/users

// 获取特定用户
GET /api/users/123

// 获取用户的订单
GET /api/users/123/orders

Características:

  • Operación segura, no modifica datos.
  • Puede ser almacenado en caché.
  • Los parámetros se ponen en la URL.

Método POST

POST se usa para crear nuevos datos, como cuando le dices al camarero: "Quiero pedir un pollo kung pao".

// 创建新用户
POST /api/users
{
  "name": "张三",
  "email": "zhangsan@example.com"
}

// 创建新订单
POST /api/orders
{
  "userId": 123,
  "items": ["商品A", "商品B"]
}

Características:

  • Modifica el estado del servidor.
  • No es idempotente (llamarlo varias veces crea múltiples recursos).
  • Los datos se colocan en el cuerpo de la solicitud.

Método PUT

PUT se usa para actualizar todo el recurso, como cuando dices: "Cambia mi pedido a esto".

// 更新用户信息
PUT /api/users/123
{
  "name": "李四",
  "email": "lisi@example.com",
  "phone": "13800138000"
}

Características:

  • Es idempotente (llamarlo varias veces da el mismo resultado).
  • Normalmente reemplaza todo el recurso.
  • Si el recurso no existe, puede crear un nuevo recurso.

Método DELETE

DELETE se usa para eliminar recursos, como cuando dices: "Cancela mi pedido".

// 删除用户
DELETE /api/users/123

// 删除订单
DELETE /api/orders/456
  • Es idempotente.
  • Elimina el recurso especificado.
  • Después de un resultado exitoso, el recurso ya no existe.

Códigos de estado HTTP

Cuando el servidor termina de procesar la solicitud, devuelve un código de estado para indicarte el resultado:

Código de estado Significado Descripción
200 OK Solicitud exitosa
201 Created Recurso creado con éxito
400 Bad Request Solicitud incorrecta
401 Unauthorized No autorizado
404 Not Found Recurso no encontrado
500 Internal Server Error Error interno del servidor
Otras extensiones