API接口

单片机常用的API接口基本都是返回的一串JSON格式的数据，这里以ESP32联网获取时间信息作为获取API数据的示例，以便后续移植使用。
很多功能性的API接口都可以直接百度找到，这里也是直接搜索 时间API接口 找到不少接口有下面几个

淘宝时间服务器时间接口：
http://api.m.taobao.com/rest/api3.do?api=mtop.common.getTimestamp
返回json数据格式：
{"api":"mtop.common.getTimestamp","v":"*","ret":["SUCCESS::接口调用成功"],"data":{"t":"1586519130440"}}

苏宁时间服务器接口api：
http://quan.suning.com/getSysTime.do
返回json数据格式：
{"sysTime2":"2020-04-10 19:46:50","sysTime1":"20200410194650"}

腾讯获取当前时间API：
http://vv.video.qq.com/checktime?otype=json
返回数据格式：
QZOutputJson={"s":"o","t":1678083300,"ip":"xxx.xxx.xxx.xxx","pos":"---","rand":"B2Pg8mOVaTTJAA94YMiZzA=="};

测试下来这里比较推荐使用 淘宝的时间接口 ，相对来说稳定一些，缺点是获取的是UTC时间的毫秒数需要进行计算得到具体时间。

需要代码可以在下方留言邮箱。

代码解析

下面是初始化以及主函数的主要功能代码

需要代码可以在下方留言或者私信邮箱，不要只留需要代码哦，没地方发。

void setup() {
  // put your setup code here, to run once:
  Serial.begin(115200);  //启动串口通信,波特率为115200
  WifiConfiguration();
}

void loop() {
  // put your main code here, to run repeatedly:
  int Circle;
  AgainStart:if(WiFi.status() == WL_CONNECTED)   //如果wifi连接成功才执行一下操作
  {
    /*HTTP请求API函数并返回值给JSON函数进行解析,JSON函数取出来的需要的信息返回到 变量 JsonInformation 中*/
    ApiInformation = HTTPRequestApi();
    JsonInformation = ApiJSONAnalysis(ApiInformation);
    Circle = 3;
    while(JsonInformation=="null" && Circle--)   //如果JsonInformation返回值为null那么循环3次请求时间的操作
    {
      ApiInformation = HTTPRequestApi();
      JsonInformation = ApiJSONAnalysis(ApiInformation);
      if(JsonInformation=="null" && Circle==0) goto AgainStart;
    }
    Serial.print("\r\nApi Information:\r\n");
    Serial.print(ApiInformation);
    Serial.print("\r\nJson Information:\r\n");
    Serial.print(JsonInformation);
  }
  else
  {
    Serial.print("\r\nwifi Reconnect...");
    WifiConfiguration();
  }
  
  delay(10000);
  //delay(10000);
}

头部宏定义

/*存储多个WiFi的连接信息*/
String WifiSSID="YXDZ";   //定义wifi名称
String WifiPassword="YXDZ1234";   //定义wifi密码

/*定义获取北京时间需要访问的IP地址、端口以及网址子页或参数*/
const char* ApiHost = "api.m.taobao.com";
uint16_t ApiPort=80;
const char* GetSysApi = "/rest/api3.do?api=mtop.common.getTimestamp";

/*存放最终API接口获取数据以及JSON解析转换后的信息*/
String ApiInformation = "";
String JsonInformation = "";


void WifiConfiguration(void);   //wifi初始化并连接
String HTTPRequestApi(void);  //请求API
String ApiJSONAnalysis(String JsonData);  //Api Json解析函数

定义的参数比较简单，用户如果需要访问其他的API接口，只需要修改 wifi的名称与密码、API接口的地址、端口以及子页地址

如果刚好也是需要获取时间的话那么只需要将 wifi的名称与密码 修改为自己使用的即可

如果你需要的是访问其他的API或者网页，那么可以参考下面的示例进行修改，当然JSON解析的函数肯定是无效的了，由于参数不同后面JSON解析的函数需要另外编写并修改。

如下所示，如果我们需要访问其他的网页，例如：http://www.jxl.wiki:8082/test.txt (自己临时做的测试网页，不一定能一直访问)，将宏定义中的参数修改为如下所示，即可变更为访问上面的网页了

/*定义获取北京时间需要访问的IP地址、端口以及网址子页或参数*/
const char* ApiHost = "www.jxl.wiki";
uint16_t ApiPort=8082;
const char* GetSysApi = "/test.txt";

网页显示结果如下所示，简单显示一个 Hello World!...
在这里插入图片描述
ESP32获取网页打印信息如下

获取时间

需要代码可以在下方留言或者私信邮箱，不要只留需要代码哦，没地方发。

由于时间是计算的从1970年1月1日到现在的毫秒数，不能直观的展示给人看，因此示例代码中 String ApiJSONAnalysis(String JsonData); 这个函数中不仅做了json数据的解析，另外还对时间做了处理，可以看成以下两个部分

String ApiJSONAnalysis(String JsonData)  //Api Json解析函数
{
  /*从JSON数据中提取时间数据，但是是JSON格式的，需要转换成data time格式的，JSON格式时间是从1970年到现在的时间毫秒数*/
  String JSONTime,JsonAnalysisInformation;
  unsigned int Year,Month,Day,Hour,Minute,Second,MonthSecond,DaySecond,JSONTime_1_6,JSONTime_7_13;  //Month存储第几月的时间，MonthSecond存储当年度过所有月的秒数，其他类似
  bool LeapYearFlag = 0;   //闰年标志位，0为平年，1位闰年，默认参数为0
  
  const size_t capacity = JSON_OBJECT_SIZE(4) + JSON_ARRAY_SIZE(1) + JSON_OBJECT_SIZE(1) + 130;
  DynamicJsonDocument JsonDataObject(capacity);
  deserializeJson(JsonDataObject,JsonData);
  JsonAnalysisInformation = JsonDataObject["data"]["t"].as<String>();
  

  /*由于是获取的时间才有下面这部分,如果是其他的API接口可以不需要,直接返回获取到的JsonAnalysisInformation就可以*/
  JSONTime = JsonAnalysisInformation;
  /*
    unsigned int型无法存取这么大的数字，将string型拆分之后再转换为unsigned int型
    substring(N,M) 函数可以将第N个开始到第M个的字符串截取出来，之后再用toInt()转换成整形
  */
  JSONTime_1_6 = (JSONTime.substring(0,6)).toInt()*10000;  //从第1个数到第6个截取出来，第一个数的标号是0，最后一个不截取，并转化为unsigned int型数据，顺便*10000，以便节约后续计算资源
  JSONTime_7_13 = (JSONTime.substring(6,13)).toInt()/1000;   //从第7个数到第13个截取出来，第一个数的标号是0，最后一个不截取，并转化为unsigned int型数据，顺便/1000把单位转换成秒，以便节约后续计算资源
 ...
 ...
 ...

其中只有下面这部分的代码是用来做json数据解析的，只需要把定义的变量JsonAnalysisInformation加上即可，其余的如果不需要可以全部删掉

  const size_t capacity = JSON_OBJECT_SIZE(4) + JSON_ARRAY_SIZE(1) + JSON_OBJECT_SIZE(1) + 130;
  DynamicJsonDocument JsonDataObject(capacity);
  deserializeJson(JsonDataObject,JsonData);
  JsonAnalysisInformation = JsonDataObject["data"]["t"].as<String>();