API 新手指南

API是8sim为你提供的获取8sim用户相应授权信息的API,当你获得用户授权后通过以下API可以轻松的访问相应的资源。

准备

如果您没有8sim账户,请下载8sim客户端,并注册一个8sim帐号。

请求地址

http://api.8sim.top:8080/

备用请求地址

http://api2.8sim.top:8080/

如果你的IP不在中国,使用这个api地址速度会更快

If your IP is not in China, using this api address will be faster

登录接口

功能: 用户可通过此接口来获取自己的相关用户信息

频次限制:是

接口请求参数:

参数 描述 是否必须
username 你通过客户端注册的账号 Yes
password 你通过客户端注册的密码 Yes

接口请求实例

POST/GET http://api.8sim.top:8080/login.php?username=xuanyuan&password=123123

返回结果:JSON示例

{ "time": "1610450805234", "result": "success", "token": "5d444926db0af4778c39228caf1979a4", "msg": "", "integral": "23.000", "points": "0" }

返回字段说明
返回值字段 字段类型 字段说明
token string 秘钥(失败返回空)
result string 结果(成功为success 失败为fail)
msg string 用户公告
integral string 用户剩余积分
points string 用户兑换积分
error string 错误信息
time string 时间

获取余额接口

功能: 用户可通过此接口来获取自己的余额信息

频次限制:是

接口请求参数:

参数 描述 是否必须
token 你通过登录获取的token秘钥字符串 Yes

接口请求实例:

POST/GET http://api.8sim.top:8080/yhye.php?token=a456753b3cde2781cd96367c67c8f0b8

返回结果:JSON示例

{ "time": "1610452037676", "result": "success", "points": "0", "name": "xuanyuan", "integral": "8888.000" }

返回字段说明
返回值字段 字段类型 字段说明
result string 结果(成功为success 失败为fail)
name string 查询的账户
integral string 用户剩余积分
points string 用户兑换积分
time string 时间
error string 错误信息

获取号码

功能: 用户可通过此接口获取对应的号码

频次限制:是

接口请求参数:

参数 描述 是否必须
id 客户端项目所属的ID编号 Yes
operator 0=全部 Yes
Region 请填写0 Yes
card 请填写0 Yes
phone 当你需要指定号码时候在填入此参数 No
loop 是否需要获取你获取过的号码(1排除已做过号码取号时不会再获取到,2不过滤已做号码可以取号时循环获取号码) Yes
token 你通过登录获取的token秘钥字符串 Yes

接口请求实例:

POST/GET http://api.8sim.top:8080/yhquhao.php?id=118467&operator=0&Region=0&card=0&phone=&loop=1&token=token

返回结果:JSON示例

{ "time": "1610457564308", "result": "success", "number": "188888888888" }

返回字段说明
返回值字段 字段类型 字段说明
result string 结果(成功为success 失败为fail)
number string 返回的号码
time string 时间
error string 错误信息

获取状态

功能: 用户可通过此接口获取对应号码短信和向对应号码发送信息

频次限制:是

接口请求参数:

参数 描述 是否必须
id 客户端项目所属的ID编号 Yes
phone 通过获取号码方法获取到的手机号 Yes
t 开发者用户名 No
token 你通过登录获取的token秘钥字符串 Yes

接口请求实例:

POST/GET http://api.8sim.top:8080/yhquma.php?id=118467&phone=17059163287&t=&token=a814853b3cde2771cd96367c67c8f0b8

返回结果:JSON示例

{ "time": "1610459498126", "result": "fail", "message": "Your Tinder code is 420111 Don’t share", "Code": "1508", "error": "没有收到短信" }

返回字段说明
返回值字段 字段类型 字段说明
result string 结果(成功为success 失败为fail)
message string 返回的短信内容
Code string 返回的验证码数字
time string 时间
error string 错误信息

释放加黑

功能: 用户可通过此接口加黑和释放

频次限制:是

接口请求参数:

参数 描述 是否必须
id 客户端项目所属的ID编号 Yes
phone 获取到号码 Yes
token 你通过登录获取的token秘钥字符串 Yes

释放接口请求实例:

POST http://api.8sim.top:8080/yhsf.php?token=token&id=项目ID&phone=手机号

加黑接口请求实例:

POST http://api.8sim.top:8080/yhlh.php?token=token&id=项目ID&phone=手机号

返回结果:JSON示例

{ "time": "1610462486833", "result": "success", "msg": "加黑成功" "error": "" }

返回字段说明
返回值字段 字段类型 字段说明
result string 结果(成功为success 失败为fail)
msg string 返回状态文本
time string 时间
error string 错误信息

注意事项:

1. 若指定地区(Region)参数无效,请在提交时候进行UTF-8编码

2. 访问频率请适当降低,你访问太快也没用,短信来到你这里需要一定时间。

3. 修改密码了后请一定要重新获取token秘钥,也可以自己在客户端更新秘钥。