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 |