首页 > 分享 > 宠物大全API接口

宠物大全API接口

萌宠菠菠乐园
2024-09-30 06:03

▼ 请求参数

post方式请求时，enctype应为application/x-www-form-urlencoded

上传文件二进制数据流方式，enctype必须为multipart/form-data

参数url、base64中有特殊字符时，建议对值urlencode编码后传递

名称类型必须示例值/默认值说明 keystring是您自己的APIKEY（注册账号后获得）API密钥namestring否哈士奇宠物名称typeint否1宠物类型，0猫科、1犬类、2爬行类、3小宠物类、4水族类pageint是1翻页numint是5每页返回数量

▼ 返回示例

接口数据样例仅作为预览参考，请以实际测试结果为准

旧域名返回的json结构和现在略有不同，请点击此处查看说明

成功调用，code=>200并产生计费：

{ "code": 200, "msg": "success", "result": { "list": [ { "pettype": 1, "name": "哈士奇", "engName": "SiberianHuskiy", "characters": "聪明机灵、极度热情、神经质", "nation": "俄罗斯", "easyOfDisease": "肠胃疾病", "life": "9-15年", "price": "2000-4000元", "desc": "　　西伯利亚", "feature": "　　西伯利亚雪橇犬是一种原始的古老犬种，因它的独特嘶哑的叫声被称之为当今的哈士奇。很早前哈士奇是最原始的交通工具专门拉雪橇的，并用这种狗猎取和饲养驯鹿，或者繁殖这种狗，然后带出他们居住的冻土地，换取温饱。典型狼性犬。", "characterFeature": "　　哈士奇的外表英俊潇洒，精致的五官和丰富的肢体语言充满了奇特的表现，无需复杂的交谈，就能轻易了解他的喜怒哀乐。哈士奇时常会有点神经质。", "careKnowledge": "　　哈士奇虽然看着一副冷漠无情的样子，事实上，哈士奇对人很友好、温柔、热情的。喜欢与人交往是哈士奇的典型性格。通常不表现出护卫犬强烈的领地占有欲，不对陌生人过多的怀疑，也不会攻击其他犬类。因此有很多人喜欢哈士奇。他对主人非常忠诚，一条忠诚的小狗有一个健康的身体是非常重要的。", "feedPoints": "哈士奇有着敏感的肠胃，因此在饮食上需要主人多加重视，", "coverURL": "http://img.boqiicdn.com/Data/BK/P/imagick14371435571930.png" } ] } }

错误调用，查看接口错误码释义：

{ "code": 150, "msg": "API可用次数不足" }

▼ 返回参数

公共参数指所有接口都会返回的参数，应用参数每个接口都不同

名称类型示例值说明公共参数codeint200状态码msgstringsuccess错误信息resultobject{}返回结果集应用参数 pettypeint1宠物类型，0猫科、1犬类、2爬行类、3小宠物类、4水族类namestring哈士奇宠物名字engNamestringSiberianHuskiy宠物英文名charactersstring聪明机灵、极度热情、神经质性格特点nationstring俄罗斯祖籍easyOfDiseasestring肠胃疾病易患病lifestring9-15年寿命pricestring2000-4000元价格descstring西伯利亚描述featurestring西伯利亚雪橇犬是一种原始的古老犬种......体态特征characterFeaturestring哈士奇的外表英俊潇洒......特点careKnowledgestring哈士奇虽然看着一副冷漠无情的样子......照顾须知feedPointsstring哈士奇有着敏感的肠胃......喂养注意urlstringhttp://www.boqii.com/entry/detail/357.html详细来源coverURLstringhttp://img.boqiicdn.com/Data/BK/P/imagick14371435571930.png封面图片

▼ 接口价格

用户等级免费接口数每日可用次数会员价格说明普通会员10个100次免费每个免费接口100次/天高级会员不限1万次20元/月、120元/年(限时)每个免费接口1W次/天黄金会员不限50万次65元/月、390元/年(限时)每个免费接口50W次/天本接口为会员免费类接口，如业务有更高需求可点此升级会员获得更高每日请求配额（年付限时优惠）

▼ 返回状态码

错误信息可能会有所调整，请根据错误状态码(code)进行流程判断

错误状态码错误信息解释帮助100内部服务器错误报此错误码请及时反馈或等待官方修复110当前API已下线接口已下线无法使用，可关注相关通知120API暂时维护中接口暂时关闭维护中，请注意相关公告130API调用频率超限超过每秒请求数上限，可在控制台-接口管理中查询140API没有调用权限请检查是否自行在接口管理中停用或被禁用了该接口150API可用次数不足免费类接口套餐超限或计次类接口余额不足，点此查看说明160账号未申请该API请先在接口文档页面申请该接口，点此查看说明170Referer请求来源受限设置了Referer白名单，但来源Referer不在白名单内180IP请求来源受限设置了IP白名单，但来源IP不在白名单内190当前key不可用通常为账号无效，此状态无法恢复230key错误或为空请检查apikey是否填写错误，点此查看帮助240缺少key参数请检查是否传递了key参数或者编码格式是否符合要求250数据返回为空数据查询或转换失败，请检查输入值或注意中文编码问题260参数值不得为空请检查关键参数是否传递了空值270参数值不符合要求参数值不符合基本格式要求，点此查看说明280缺少必要的参数缺少必填的参数，请根据接口文档检查290超过最大输入限制参数值超过输入范围，请查看接口文档的说明错误码1开头的是系统级错误，2开头的是用户级错误，其中200表示请求成功处理并计费。

▼ 参考代码

此处代码仅演示关键请求片段，实际使用请根据具体环境修改

如需深入学习参考，可点击此处查看部分第三方完整开源项目