唐诗三百首
州讯互联 官方文档
收录唐代诗人77家,共311首,包含解释、赏析等
基本说明:
接口地址:http://zhouxunwang.cn/data/?id=149
返回格式:json
请求方式:get
请求示例:http://zhouxunwang.cn/data/?id=149&key=R5RTF4G5F5H6&keyword=李白&pagesize=4&pagenum=2
请求参数说明:
名称 类型 必填 说明
key string 必填 平台的KEY 扫码关注公众号
keyword string 必填 关键字
pagesize string 必填 每页数量(默认为1 最大为4)
pagenum string 必填 页码(默认为1)
返回参数说明:
名称 类型 说明
total string 总数
pagenum int 当前页
pagesize int 每页数量
title string 标题
type string 分类
content string 内容
explanation string 解释
appreciation string 赏析
author string 作者
JSON返回示例:
{
	"status": 0,
	"msg": "ok",
	"result": {
		"total": "9",
		"pagenum": "1",
		"pagesize": "1",
		"list": [{
			"title": "登鹳雀楼",
			"type": "五言绝句",
			"content": "白日依山尽,黄河入海流。欲穷千里目, 更上一层楼。 ",
			"explanation": " 1.鹳雀楼: 旧址在山西永济县, 楼高三层, 前对中条山, 下临黄河。 传说常有鹳雀在此停留, 故有此名。",
			"appreciation": "这首诗写诗人在登高望远中表现出来的不凡的胸襟抱负, 反映了盛唐时期人们积极向上的进取精神。",
			"author": "王之涣"
		}]
	}
}
服务级错误码参照
错误码 说明
00000 没有该接口
00001 参数有空
00002 key错误
00003 未办理过该业务
00004 条数不够
00005 已到期
00006 今天条数已用光
00007 您的账号不存在
201 关键词为空
203 没有信息
101 APPKEY为空或不存在
102 APPKEY已过期
103 APPKEY无请求此数据权限
104 请求超过次数限制
105 IP被禁止
106 IP请求超过限制
107 接口维护中
108 接口已停用
完整教学代码示例
<?php
/**
 * Created by PhpStorm.
 * User: FZS
 * Time: 2020/06/06 17:26
 */
class freeApi
{
    private $apiUrl;

    public function __construct()
    {
        $this->apiUrl = 'http://zhouxunwang.cn/data/?id=149&key=R5RTF4G5F5H6&keyword=李白&pagesize=4&pagenum=2';
    }

    /**
     * 获取结果
     * @return array
     */
    public function getResult()
    {
        return file_get_contents($this->apiUrl);
    }
}
package main

import (
	"fmt"
	"io/ioutil"
	"log"
	"net/http"
)

const (
	APIURL   = "http://zhouxunwang.cn/data/?id=149&key=R5RTF4G5F5H6&keyword=李白&pagesize=4&pagenum=2"
)

func main() {
	queryUrl := fmt.Sprintf("%s",APIURL)
	resp, err := http.Get(queryUrl)
	if err != nil {
		log.Println(err)
		return
	}

	defer resp.Body.Close()

	body, err := ioutil.ReadAll(resp.Body)

	if err != nil {
		fmt.Println(err)
		return
	}

	fmt.Println(string(body))
}