常见的几种 POST 数据提交方式

#http #计算机网络

1. application/x-www-form-urlencoded（默认）

这是最常见的 POST 提交数据的方式，浏览器的原生 form 表单如果不设置 enctype 属性，默认会以这种方式提交数据。

Content-Type: application/x-www-form-urlencoded

name=John+Doe&age=30

2. multipart/form-data

这种方式主要用于上传文件，也可以用于提交普通表单数据。

Content-Type: multipart/form-data; boundary=----WebKitFormBoundary7MA4YWxkTrZu0gW

------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="name"

John Doe
------WebKitFormBoundary7MA4YWxkTrZu0gW
Content-Disposition: form-data; name="file"; filename="example.txt"
Content-Type: text/plain

(file content here)
------WebKitFormBoundary7MA4YWxkTrZu0gW--

3. application/json

现在越来越多的 API 使用 JSON 格式传输数据。

Content-Type: application/json

{
  "name": "John Doe",
  "age": 30
}

4. text/plain

纯文本格式。

Content-Type: text/plain

Some plain text content

5. application/xml

XML 格式。

Content-Type: application/xml

<?xml version="1.0" encoding="UTF-8"?>
<user>
  <name>John Doe</name>
  <age>30</age>
</user>

6. application/octet-stream

用于发送二进制数据。

Content-Type: application/octet-stream

(Binary data)

7. 示例

让我们看一些代码示例，展示如何使用不同的方式发送 POST 请求：

使用 HTML 表单（application/x-www-form-urlencoded）：

<form action="/submit" method="post">
  <input type="text" name="name" value="John Doe">
  <input type="number" name="age" value="30">
  <input type="submit" value="Submit">
</form>

使用 HTML 表单（multipart/form-data）：

<form action="/upload" method="post" 
	  enctype="multipart/form-data">
  <input type="text" name="name" value="John Doe">
  <input type="file" name="file">
  <input type="submit" value="Upload">
</form>

使用 JavaScript 发送 JSON 数据：

fetch('/api/user', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    name: 'John Doe',
    age: 30
  })
})
.then(response => response.json())
.then(data => console.log(data))
.catch((error) => console.error('Error:', error));

使用 Python requests 库发送不同类型的 POST 请求：

import requests

# application/x-www-form-urlencoded
response = requests.post('https://httpbin.org/post', data={'key': 'value'})

# multipart/form-data
files = {'file': open('example.txt', 'rb')}
response = requests.post('https://httpbin.org/post', files=files)

# application/json
response = requests.post('https://httpbin.org/post', json={'key': 'value'})

# text/plain
headers = {'Content-Type': 'text/plain'}
response = requests.post('https://httpbin.org/post', data='Some text', headers=headers)

print(response.text)

使用 Node.js 的 axios 库发送 POST 请求：

const axios = require('axios');

// application/x-www-form-urlencoded
axios.post('https://httpbin.org/post', 'name=John&age=30', {
  headers: { 'Content-Type': 'application/x-www-form-urlencoded' }
})
.then(response => console.log(response.data))
.catch(error => console.error('Error:', error));

// application/json
axios.post('https://httpbin.org/post', {
  name: 'John',
  age: 30
})
.then(response => console.log(response.data))
.catch(error => console.error('Error:', error));

// multipart/form-data
const FormData = require('form-data');
let form = new FormData();
form.append('name', 'John');
form.append('file', fs.createReadStream('example.txt'));

axios.post('https://httpbin.org/post', form, {
  headers: form.getHeaders()
})
.then(response => console.log(response.data))
.catch(error => console.error('Error:', error));

在选择 POST 数据提交方式时，需要考虑以下因素：

服务器端的支持情况
数据的类型和结构
是否需要上传文件
API 的设计规范
客户端的兼容性

不同的数据提交方式适用于不同的场景，选择合适的方式可以提高数据传输的效率和可靠性。

liguwe's site