【小胖课堂】开工第一讲：认真读文档！
本帖最后由 吴小胖 于 2023-1-28 12:56 编辑上课前，先来考考大家：这四个字怎么读？
hengheng教诲？xiangxiang教诲？哈哈哈哈哈，答案留在评论区
再来一题，这个头像知道是属于谁的吗？
2023开工大吉！言归正传，开始咱们今天的授课。玩了七天了，放松了七天了，今天也该收收心了~
话说活字格7.0后，有了对HTTP请求的支持，这功能和效率是蹭蹭蹭的提升~对接其他系统也不在话下~简单易用！
但是在对接的过程中也遇到了不少的问题，今天我们就一起来简单梳理一下：
在此之前我们要简单的了解一下HTTP请求的方式：GET POST PUT DELETE……现在我们用的比较多的是get或post请求方式；简单理解get请求就是在浏览器中输入一串URL回车，这就是一个get请求；post请求是不能直接通过浏览器来访问的，需要借助工具来完成，比如：POSTMAN（开发大佬基本上都在使用，也是行业内的老大哥了）、APIPOST（国产软件，我个人比较喜欢~），还有就是各个平台自己研发的测试工具：比如钉钉开放平台服务端API调试工具
了解了一些基础知识，咱们再来说说如何看文档：
厅长：一个字一个字的去看文档！
这句话厅长不止跟我说了一遍！这句话真的很受用！一个字一个字的看文档，大厂的文档其实写的很规范而且很详实！逐字逐句的去看，认真看，对接不在话下！
以钉钉开放平台为例：
https://open.dingtalk.com/document/org-roadmap
官方已经给出了详细的开发者学习地图，其实现在的开发都是大同小异，搞清楚了阿里家的，鹅厂的也不难搞明白了~
开发的整体逻辑：
1、新建一个应用，获取Key和Secret（可能各家的叫法不一样，但是大同小异）；
1.1 按照自己的需要给这个应用分配不同的权限；（有些家是权限直接就分配好了）
2、通过Key和Secret获取AccessToken；（这个token是有有效期的，一般是两个小时，但是度娘家是一个月的有效期，鹅厂是需要每次请求都要鉴权一次）
3、使用这个token，通过请求地址传参后完成一次请求。
以钉钉为例：
https://open.dingtalk.com/document/orgapp/obtain-orgapp-token
请求方式：GET
请求地址：https://oapi.dingtalk.com/gettoken我们把这段话对应到活字格里：
我每次对接钉钉时都会使用钉钉的服务端API调试工具，一是因为我可以直观的获取到结果；二是我可以直接把请求地址、请求头、请求体直接复制到活字格里~以获取token为例，按照要求填写key和Secret，点击“发起调用”，随后就会在右侧出现调用的结果，返回errcode：0及token，调用成功！红色圈内的内容我们就可以直接活字格内使用；appkey和appsecret后的内容可以使用拼接的方式，也可以直接使用固定值；这里要特别注意一下请求方式是：GET
直接把钉钉调试工具Url里的地址复制到活字格里就可以了~
有了这个token接下来我们就可以起飞了~想怎么折腾就怎么折腾了~
以https://open.dingtalk.com/document/orgapp/query-user-details为例
打开文档逐字逐句阅读，读不懂的地方也别害怕，看看官方demo里传的是什么值，可以在什么地方找到这个值，官方文档里肯定是有说明的！
这也就是我为什么推荐使用官方自带的调试工具的原因了！在页面上找到调试，点击进入
按照提示填写相关的值，点击“发起调试”，在右边就会出现调试结果，我们把右边的值一一对应到活字格里：
Url里的值复制到http请求地址里，注意请求方式是POST；body直接复制到请求体中；
按照图示，直接把调试工具body里的json数据复制到活字格的请求体中；
以上就是本节课的内容了，这只是一些我自己的小经验，望各位大神指出不当之处！希望对各位能有所帮助！
dlxubo 发表于 2023-1-28 12:26
你这是过年吃饺子,噎着了,刚开头就没下文拉
哈哈哈哈哈，手滑点了一下发布~已经更新完了~还望大神轻喷~ 你这是过年吃饺子,噎着了,刚开头就没下文拉:lol 吴小胖 发表于 2023-1-28 12:56
哈哈哈哈哈，手滑点了一下发布~已经更新完了~还望大神轻喷~
:hjyzw: 干货 有地址，有密码，就可以找到要去的房子里找自己需要的东西了！HTTP请求真是万能命令啊 jones_leung 发表于 2023-1-28 12:59
干货
希望对您有帮助~ 数据民工 发表于 2023-1-28 13:09
有地址，有密码，就可以找到要去的房子里找自己需要的东西了！HTTP请求真是万能命令啊
哈哈哈哈，这个比喻贴切~ 正需要，感谢小胖老师
页:
[1]