简介
总所周知,EVE是一款表格游戏(雾,特殊的游戏环境也需要游戏内的军团组织获取玩家的信息,以便于更加高效的管理,例如获取游戏内组队信息来管理出勤,获取社交信息来防止spy,获取挖矿信息来管理矿税,获取物价信息来制作查价机器人···
甚至你还可以通过ESI接口直接对游戏内数据进行操作,编辑联系人,邮件管理等
国内虽然管理系统五花八门,却没有人来介绍ESI接口,使得很多玩游戏的程序猿对EVE第三方软件开发望而却步,所以我便萌生了ESI基础介绍的想法
ESI是什么
ESI全程EVE Interface Swagger,是一款Restful风格的接口,简单来说就是通过HTTP请求获取到Json数据,由于ESI大部分的接口都需要玩家ID,所以这里展示获取ID的接口文档
因为是Post请求,可以看出需要三个参数与一个响应体,而三个参数都有默认值,那么我们只需要编写body即可,如图我查询自己的ID SadMU
这个时候就发现了这个接口是进行了模糊查询,不仅查到了我的ID,还查到了一个军团的ID
当然这只是最简单的用法,接下来来介绍ESI接口中大部分需要鉴权的接口
创建ESI应用
首先我们需要准备一个充值过的EVE账号,登录EVE开发者网站,并点击Manage applications
然后创建一个新的应用程序,用于授权,各大军团所谓的提交ESI指的就是玩家给这个应用程序授权
点击create new application看到创建页面,名字和描述这里我就不赘述了,他们用于玩家管理授权时看到的信息
连接方式
身份验证&API授权 仅身份验证 简单来说就是需要权限的接口程序和公开接口的程序,我们选择第一个
CallBack URL
指的是在玩家登陆后,跳转回的网站,这里我们使用Postman,我们就填https://www.getpostman.com/oauth2/callback
最后点击creat application,然后点开刚才创建的应用,如图(别拿我的ID和密钥来试,我写完就删)
打开你的Postman,创建一个请求,点击Auth,Type选择OAuth 2.0
然后拉到下面,如图配置基础信息
Callback URL:https://www.getpostman.com/oauth2/callback
Auth URL :https://login.eveonline.com/oauth/authorize
Access Token URL :https://login.eveonline.com/oauth/token
然后到最底下,点击Get new Access Token,登录你的账号,选择角色,就完成了角色的授权,并且这时会获得一个Token
那么拿到Token了我们就随便测一个接口吧,我选择了钱包
分析可以看出这里有四个参数,嵌入在path中的玩家id,数据源,Etag,token
其中数据源只有一个可用值,Etag是一种缓存机制,用于在服务端判断数据是否相同
那么就开始写请求
可以看到返回了一串数字,就是我钱包中isk的总量,至此,我们就完成了一次ESI的请求