获取 POST 参数 ​

当使用 POST 请求调用云函数时，HTTP Request Body 会被转化为对应云函数中的 params 变量，方便开发者获取和使用。

根据请求 Content Type 的不同， params 也会有不同的类型。

application/json ​

application/json 为最常用的请求数据类型，此时 params 的类型为 Object ，其值是对 Request Body 使用 JSON.parse 得到的。

例如，对于如下云函数：

module.exports = async function(params, context) {
  return {
    method: context.method,
    paramsFromPost: params

module.exports = async function(params, context) {
  return {
    method: context.method,
    paramsFromPost: params

部署后，携带 application/json 类型的数据发送 POST 请求：

curl -X POST -d '{"hello":"world"}' -H "Content-Type:application/json" \
https://sample.hk.aircode.run/postParams

curl -X POST -d '{"hello":"world"}' -H "Content-Type:application/json" \
https://sample.hk.aircode.run/postParams

会得到如下结果：

{ 
  "method": "POST",
  "paramsFromPost": {
    "hello": "world"
  "method": "POST",
  "paramsFromPost": {
    "hello": "world"

multipart/form-data ​

multipart/form-data 一般用于上传文件，此时 params 的类型为 Object ，并以 Key-Value 的形式直接对应请求数据。对于文件，其数据结构如下：

type UploadFile = {
  name: string;       // Name of the uploaded file
  type: string;       // Mime type of the file
  size: number;       // Size of the file in bytes
  buffer: Buffer;     // Content of the entire file

type UploadFile = {
  name: string;       // Name of the uploaded file
  type: string;       // Mime type of the file
  size: number;       // Size of the file in bytes
  buffer: Buffer;     // Content of the entire file

例如，对于如下云函数：

module.exports = async function(params, context) {
  return {
    method: context.method,
    paramsFromPost: params

module.exports = async function(params, context) {
  return {
    method: context.method,
    paramsFromPost: params

部署后，携带 multipart/form-data 类型的数据发送 POST 请求：

# Please make sure you have hello.txt in your directory
curl -X POST -F "abc=123" -F [email protected] \
https://sample.hk.aircode.run/postParams

# Please make sure you have hello.txt in your directory
curl -X POST -F "abc=123" -F [email protected] \
https://sample.hk.aircode.run/postParams

会得到如下结果：

{
  "method": "POST",
  "paramsFromPost": {
    "abc": "123",
    "xyz": {
      "name": "hello.txt",
      "type": "text/plain",
      "size": 11,
      "buffer": {
        "type": "Buffer",
        "data": [ 72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100 ]
  "method": "POST",
  "paramsFromPost": {
    "abc": "123",
    "xyz": {
      "name": "hello.txt",
      "type": "text/plain",
      "size": 11,
      "buffer": {
        "type": "Buffer",
        "data": [ 72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100 ]

application/x-www-form-urlencoded ​

当请求的 Content Type 为 application/x-www-form-urlencoded 时， params 的类型为 Object ，其值是对 Request Body 使用 querystring.parse 得到的。

例如，对于如下云函数：

module.exports = async function(params, context) {
  return {
    method: context.method,
    paramsFromPost: params

module.exports = async function(params, context) {
  return {
    method: context.method,
    paramsFromPost: params

部署后，携带 application/x-www-form-urlencoded 类型的数据发送 POST 请求：

curl -X POST -d 'hello=world&abc=xyz&abc=123' \
-H "Content-Type:application/x-www-form-urlencoded" \
https://sample.hk.aircode.run/postParams

curl -X POST -d 'hello=world&abc=xyz&abc=123' \
-H "Content-Type:application/x-www-form-urlencoded" \
https://sample.hk.aircode.run/postParams

会得到如下结果：

{
  "method": "POST",
  "paramsFromPost": {
    "hello": "world",
    "abc": [ "xyz", "123" ]
  "method": "POST",
  "paramsFromPost": {
    "hello": "world",
    "abc": [ "xyz", "123" ]

text/plain ​

text/plain 一般用于发送纯文本内容，此时 params 的类型为 string ，代表该文本的内容。

例如，对于如下云函数：

module.exports = async function(params, context) {
  return {
    method: context.method,
    paramsFromPost: params

module.exports = async function(params, context) {
  return {
    method: context.method,
    paramsFromPost: params

部署后，携带 text/plain 类型的数据发送 POST 请求：

curl -X POST -d "Some Text..." -H "Content-Type:text/plain" \
https://sample.hk.aircode.run/postParams

curl -X POST -d "Some Text..." -H "Content-Type:text/plain" \
https://sample.hk.aircode.run/postParams

会得到如下结果：

{
  "method": "POST",
  "paramsFromPost": "Some Text..."
  "method": "POST",
  "paramsFromPost": "Some Text..."

其他类型 ​

当使用其他类型（例如 application/octet-stream ）时， params 的类型为 Buffer ，代表请求的原始二进制数据。

例如，对于如下云函数：

module.exports = async function(params, context) {
  return {
    method: context.method,
    paramsFromPost: params

module.exports = async function(params, context) {
  return {
    method: context.method,
    paramsFromPost: params

部署后，携带 application/octet-stream 类型的数据发送 POST 请求：

curl -X POST -d "Hello World" -H "Content-Type:application/octet-stream" \
https://sample.hk.aircode.run/postParams

curl -X POST -d "Hello World" -H "Content-Type:application/octet-stream" \
https://sample.hk.aircode.run/postParams

会得到如下结果：

{
  "method": "POST",
  "paramsFromPost": {
    "type": "Buffer",
    "data": [ 72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100 ]
  "method": "POST",
  "paramsFromPost": {
    "type": "Buffer",
    "data": [ 72, 101, 108, 108, 111, 32, 87, 111, 114, 108, 100 ]