带URL参数的GET API请求怎么做？

带URL参数的GET API请求实现指南

基础概念

GET请求是HTTP协议中最常用的方法之一，用于从服务器获取资源。URL参数（也称为查询参数）是附加在URL末尾的键值对，用于向服务器传递额外的信息。

实现方式

1. 基本URL参数格式

URL参数的格式是在URL后加问号(?)开始，多个参数用&连接：

https://api.example.com/resource?param1=value1&param2=value2

2. 前端实现示例

JavaScript (原生)

const baseUrl = 'https://api.example.com/data';
const params = {
  userId: 12345,
  category: 'books',
  limit: 10
};

// 构建查询字符串
const queryString = Object.keys(params)
  .map(key => `${encodeURIComponent(key)}=${encodeURIComponent(params[key])}`)
  .join('&');

const url = `${baseUrl}?${queryString}`;

fetch(url)
  .then(response => response.json())
  .then(data => console.log(data))
  .catch(error => console.error('Error:', error));

JavaScript (axios)

import axios from 'axios';

axios.get('https://api.example.com/data', {
  params: {
    userId: 12345,
    category: 'books',
    limit: 10
  }
})
.then(response => console.log(response.data))
.catch(error => console.error('Error:', error));

3. 后端实现示例

Node.js (Express)

const express = require('express');
const app = express();

app.get('/api/data', (req, res) => {
  const { userId, category, limit } = req.query;
  // 使用参数处理逻辑...
  res.json({ userId, category, limit });
});

app.listen(3000, () => console.log('Server running on port 3000'));

Python (Flask)

from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/api/data', methods=['GET'])
def get_data():
    user_id = request.args.get('userId')
    category = request.args.get('category')
    limit = request.args.get('limit')
    # 使用参数处理逻辑...
    return jsonify({'userId': user_id, 'category': category, 'limit': limit})

if __name__ == '__main__':
    app.run(debug=True)

注意事项

URL编码：参数值应进行URL编码，特别是包含特殊字符时
参数长度限制：GET请求的URL有长度限制（通常约2048字符）
安全性：敏感数据不应放在URL参数中（会出现在浏览器历史、服务器日志等）
缓存：GET请求通常会被缓存

常见问题及解决方案

问题1：参数中包含特殊字符导致请求失败

原因：未对参数进行正确的URL编码解决：使用encodeURIComponent()或相应语言的URL编码函数

问题2：获取的参数值为undefined/null

原因：

前端未正确发送参数
后端未正确解析参数解决：
检查前端请求URL是否正确构建
检查后端路由和参数解析逻辑

问题3：URL过长导致请求失败

原因：GET请求的URL长度超过服务器或浏览器限制解决：

减少参数数量
将部分参数改为POST请求的body中发送
使用更短的参数名和值

最佳实践

保持参数名称简洁但有意义
对参数值进行验证和清理
为API提供清晰的文档说明参数用途和格式
考虑使用API版本控制
对于复杂查询，考虑使用GraphQL替代传统REST API