查询实名状态(realname_status)
返回当前账户是否已完成实名认证。无额外业务参数,仅需携带通用请求参数。仅限销售/管理员角色调用。
接口信息
| 项目 | 说明 |
|---|---|
| 接口地址 | POST /api.php |
| action | realname_status |
| 认证方式 | 全局应用 APP ID / APP KEY |
| 角色限制 | 仅销售/管理员 |
请求参数
无额外参数,仅通用请求参数(action / app_id / app_key)。
请求示例
{
"action": "realname_status",
"app_id": "68B0FA47FEC9E7EBC4BF80F8",
"app_key": "2b901515a427b6c0b68f866eece70e0d2ecf687146022412"
}
PHP
<?php
$app_id = '68B0FA47FEC9E7EBC4BF80F8';
$app_key = '2b901515a427b6c0b68f866eece70e0d2ecf687146022412';
$url = 'https://yunsapi.com/api.php';
$params = [
'action' => 'realname',
'app_id' => $app_id,
'app_key' => $app_key,
];
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($params));
curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
$resp = curl_exec($ch);
curl_close($ch);
echo $resp;
Java
import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class ApiDemo {
static final String URL = "https://yunsapi.com/api.php";
static final String APP_ID = "68B0FA47FEC9E7EBC4BF80F8";
static final String APP_KEY = "2b901515a427b6c0b68f866eece70e0d2ecf687146022412";
public static void main(String[] args) throws Exception {
String body = "{\"action\":\"realname\",\"app_id\":\"" + APP_ID + "\",\"app_key\":\"" + APP_KEY + "\"}";
HttpClient client = HttpClient.newHttpClient();
HttpRequest req = HttpRequest.newBuilder()
.uri(URI.create(URL))
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(body))
.build();
HttpResponse<String> resp = client.send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(resp.body());
}
}
响应示例
{
"code": 0,
"msg": "success",
"data": {
"verified": true
}
}
响应参数
| 参数 | 类型 | 说明 |
|---|---|---|
data.verified | boolean | 是否已实名 |