JSON 入门实战:3 步读懂接口返回的数据
昨天那篇讲了 HTTP:浏览器发请求,服务器回响应。响应体里装的常常是一包数据,而这包数据最常见的格式就是 JSON——前后端之间传数据的通用写法。下面 3 步读懂它。
1. 长相:键值对加两种容器
JSON 就是用纯文本写出来的数据,长这样:
{
"name": "冒险大转盘",
"stars": 1026,
"free": true,
"tags": ["鸿蒙", "案例"],
"author": {
"name": "张睿基",
"level": 1
}
}
规则只有几条:数据是键值对,键一定用双引号包起来;值可以是字符串、数字、布尔值、null,也可以是对象(花括号)和数组(方括号);对象和数组能互相嵌套。记住这三点:键必须有双引号,单引号不行;最后一个值后面不能加逗号;注释写不进去,JSON 里没有注释。
对照着看:name 是字符串,stars 是数字,free 是布尔值,tags 是数组,author 是嵌套对象。接口返回的数据,基本都是这个套路的放大版。
2. 读写:程序怎么拿里面的值
看懂了长相,接下来是程序怎么用它。以 JavaScript 为例,拿到一串 JSON 文本,先解析成对象再取值:
const text = '{"name": "冒险大转盘", "stars": 1026}';
const data = JSON.parse(text);
console.log(data.name); // 冒险大转盘
console.log(data.stars); // 1026
反过来,把对象发给服务器之前,要先转成文本:
const obj = { name: "冒险大转盘", stars: 1026 };
const json = JSON.stringify(obj);
console.log(json); // {"name":"冒险大转盘","stars":1026}
记住这一对:JSON.parse 是文本变对象,JSON.stringify 是对象变文本。前端调接口,基本就是发请求、拿到 JSON 文本、parse 之后按字段名取值、把值填进页面——这条链路走通了,大部分接口都能读了。
3. 动手:用 curl 亲眼看一次真实接口
不用写后端,命令行里就能看到一个真实的 JSON 响应:
curl -s https://api.github.com/repos/octocat/Hello-World | python3 -m json.tool | head -20
curl -s 是静默拿回响应体,python3 -m json.tool 是把 JSON 格式化打印出来。回车后会看到 name、full_name、private 这些字段,结构和第 1 步的例子一模一样,只是字段更多。换个接口再跑一次,比如把路径换成另一个公开仓库,对比两次返回的字段——接口文档里列的字段名,就是这样一个个对上号的。
新手最容易踩的三个坑
第一,键没加双引号。{name: "a"} 在 JavaScript 对象里能跑,在 JSON 里就是错的,接口直接报解析失败——复制别人的对象字面量当 JSON 发,最容易栽在这里。
第二,末尾多一个逗号。{"a": 1,} 看着无害,解析器认死理,多个逗号就报错。手写 JSON 时先检查最后一个值后面有没有逗号。
第三,把 JSON 当成只能前端用的东西。Python 的 json.loads、Java 的 ObjectMapper、Go 的 encoding/json,每种语言都有自己的解析方法,格式本身是通用的——这正是它成为接口标准的原因。
小结
JSON 的套路就一句话:键值对写数据,对象和数组做容器,parse 读进来、stringify 发出去。能对照着接口文档读出字段、取出想要的值,这套格式就入门了;明天那篇再讲:页面出了问题,怎么用浏览器开发者工具定位到是哪一步。
- 点赞
- 收藏
- 关注作者
评论(0)