Batch get persons
curl --request POST \
--url 'https://api.flashcat.cloud/person/infos?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"person_ids": [
2476444212131,
3790925372131
]
}
'import requests
url = "https://api.flashcat.cloud/person/infos?app_key="
payload = { "person_ids": [2476444212131, 3790925372131] }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({person_ids: [2476444212131, 3790925372131]})
};
fetch('https://api.flashcat.cloud/person/infos?app_key=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.flashcat.cloud/person/infos?app_key=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'person_ids' => [
2476444212131,
3790925372131
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.flashcat.cloud/person/infos?app_key="
payload := strings.NewReader("{\n \"person_ids\": [\n 2476444212131,\n 3790925372131\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.flashcat.cloud/person/infos?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"person_ids\": [\n 2476444212131,\n 3790925372131\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/person/infos?app_key=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"person_ids\": [\n 2476444212131,\n 3790925372131\n ]\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {
"items": [
{
"account_id": 2451002751131,
"person_id": 2476444212131,
"person_name": "Alice",
"avatar": "/image/avatar1.png",
"locale": "zh-CN",
"time_zone": "Asia/Shanghai",
"email": "alice@example.com",
"phone_verified": false,
"email_verified": true,
"as": "member",
"status": "enabled"
},
{
"account_id": 2451002751131,
"person_id": 3790925372131,
"person_name": "Bob",
"email": "bob@example.com",
"phone_verified": false,
"email_verified": true,
"as": "member",
"status": "enabled"
}
]
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InvalidParameter",
"message": "The specified parameter is not valid."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "Unauthorized",
"message": "You are unauthorized."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "AccessDenied",
"message": "Access Denied."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "RequestTooFrequently",
"message": "Request too frequently."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InternalError",
"message": "We encountered an internal error, and it has been reported. Please try again later."
}
}Members
Batch get persons
Return profile information for a batch of person IDs (members or accounts).
POST
/
person
/
infos
Batch get persons
curl --request POST \
--url 'https://api.flashcat.cloud/person/infos?app_key=' \
--header 'Content-Type: application/json' \
--data '
{
"person_ids": [
2476444212131,
3790925372131
]
}
'import requests
url = "https://api.flashcat.cloud/person/infos?app_key="
payload = { "person_ids": [2476444212131, 3790925372131] }
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({person_ids: [2476444212131, 3790925372131]})
};
fetch('https://api.flashcat.cloud/person/infos?app_key=', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.flashcat.cloud/person/infos?app_key=",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'person_ids' => [
2476444212131,
3790925372131
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.flashcat.cloud/person/infos?app_key="
payload := strings.NewReader("{\n \"person_ids\": [\n 2476444212131,\n 3790925372131\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.flashcat.cloud/person/infos?app_key=")
.header("Content-Type", "application/json")
.body("{\n \"person_ids\": [\n 2476444212131,\n 3790925372131\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.flashcat.cloud/person/infos?app_key=")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"person_ids\": [\n 2476444212131,\n 3790925372131\n ]\n}"
response = http.request(request)
puts response.read_body{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"data": {
"items": [
{
"account_id": 2451002751131,
"person_id": 2476444212131,
"person_name": "Alice",
"avatar": "/image/avatar1.png",
"locale": "zh-CN",
"time_zone": "Asia/Shanghai",
"email": "alice@example.com",
"phone_verified": false,
"email_verified": true,
"as": "member",
"status": "enabled"
},
{
"account_id": 2451002751131,
"person_id": 3790925372131,
"person_name": "Bob",
"email": "bob@example.com",
"phone_verified": false,
"email_verified": true,
"as": "member",
"status": "enabled"
}
]
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InvalidParameter",
"message": "The specified parameter is not valid."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "Unauthorized",
"message": "You are unauthorized."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "AccessDenied",
"message": "Access Denied."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "RequestTooFrequently",
"message": "Request too frequently."
}
}{
"request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
"error": {
"code": "InternalError",
"message": "We encountered an internal error, and it has been reported. Please try again later."
}
}Restrictions
| Aspect | Value |
|---|---|
| Rate limits | 1,000 requests/minute; 50 requests/second per account |
| Permissions | None — any valid app_key can call this operation |
Usage
- Including the account ID returns the account owner, with
asaccount. Other IDs are looked up among the account’s members, including removed ones (statusdeleted), so IDs saved in older records still resolve. - Duplicate IDs are deduplicated; IDs that match neither are omitted.
Authorizations
Body
application/json
Response
Success
Success response envelope. On every 2xx response, request_id identifies the call (also mirrored in the Flashcat-Request-Id header) and data holds the endpoint-specific payload. Failure responses use a different shape — see ErrorResponse.
Was this page helpful?