从 Battle.net 帐户 ID 获取 PlayFab ID
Retrieves the unique PlayFab identifiers for the given set of Battle.net account identifiers.
POST
/
Client
/
GetPlayFabIDsFromBattleNetAccountIds
Get Play Fab IDs From Battle Net Account Ids
curl --request POST \
--url https://{titleId}.playfabapi.com/Client/GetPlayFabIDsFromBattleNetAccountIds \
--header 'Content-Type: application/json' \
--header 'X-Authorization: <api-key>' \
--data '
{
"BattleNetAccountIds": [
"526f79204261747478",
"526f79204261747479"
]
}
'import requests
url = "https://{titleId}.playfabapi.com/Client/GetPlayFabIDsFromBattleNetAccountIds"
payload = { "BattleNetAccountIds": ["526f79204261747478", "526f79204261747479"] }
headers = {
"X-Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Authorization': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({BattleNetAccountIds: ['526f79204261747478', '526f79204261747479']})
};
fetch('https://{titleId}.playfabapi.com/Client/GetPlayFabIDsFromBattleNetAccountIds', 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://{titleId}.playfabapi.com/Client/GetPlayFabIDsFromBattleNetAccountIds",
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([
'BattleNetAccountIds' => [
'526f79204261747478',
'526f79204261747479'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Authorization: <api-key>"
],
]);
$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://{titleId}.playfabapi.com/Client/GetPlayFabIDsFromBattleNetAccountIds"
payload := strings.NewReader("{\n \"BattleNetAccountIds\": [\n \"526f79204261747478\",\n \"526f79204261747479\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Authorization", "<api-key>")
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://{titleId}.playfabapi.com/Client/GetPlayFabIDsFromBattleNetAccountIds")
.header("X-Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"BattleNetAccountIds\": [\n \"526f79204261747478\",\n \"526f79204261747479\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{titleId}.playfabapi.com/Client/GetPlayFabIDsFromBattleNetAccountIds")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"BattleNetAccountIds\": [\n \"526f79204261747478\",\n \"526f79204261747479\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"status": "OK",
"data": {
"Data": [
{
"BattleNetAccountId": "526f79204261747478",
"PlayFabId": "5a446c83645201"
},
{
"BattleNetAccountId": "526f79204261747479",
"PlayFabId": "6345cd25a6c7cc"
}
]
}
}{
"code": 123,
"errorCode": 123,
"status": "<string>",
"error": "<string>",
"errorMessage": "<string>",
"errorDetails": {}
}授权
This API requires a client session ticket, available from any Client Login function.
请求体
application/json
Array of unique Battle.net account identifiers for which the title needs to get PlayFab identifiers. The array cannot exceed 10 in length.
响应
For Battle.net account identifiers which have not been linked to PlayFab accounts, null will be returned.
The Http status code. If X-ReportErrorAsSuccess header is set to true, this will report the actual http error code.
The Http status code as a string.
For Battle.net account identifiers which have not been linked to PlayFab accounts, null will be returned.
Show child attributes
Show child attributes
示例:
{
"Data": [
{
"BattleNetAccountId": "526f79204261747478",
"PlayFabId": "5a446c83645201"
},
{
"BattleNetAccountId": "526f79204261747479",
"PlayFabId": "6345cd25a6c7cc"
}
]
}
最后修改于 2026年10月6日
此页面对您有帮助吗?
⌘I
Get Play Fab IDs From Battle Net Account Ids
curl --request POST \
--url https://{titleId}.playfabapi.com/Client/GetPlayFabIDsFromBattleNetAccountIds \
--header 'Content-Type: application/json' \
--header 'X-Authorization: <api-key>' \
--data '
{
"BattleNetAccountIds": [
"526f79204261747478",
"526f79204261747479"
]
}
'import requests
url = "https://{titleId}.playfabapi.com/Client/GetPlayFabIDsFromBattleNetAccountIds"
payload = { "BattleNetAccountIds": ["526f79204261747478", "526f79204261747479"] }
headers = {
"X-Authorization": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-Authorization': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({BattleNetAccountIds: ['526f79204261747478', '526f79204261747479']})
};
fetch('https://{titleId}.playfabapi.com/Client/GetPlayFabIDsFromBattleNetAccountIds', 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://{titleId}.playfabapi.com/Client/GetPlayFabIDsFromBattleNetAccountIds",
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([
'BattleNetAccountIds' => [
'526f79204261747478',
'526f79204261747479'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-Authorization: <api-key>"
],
]);
$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://{titleId}.playfabapi.com/Client/GetPlayFabIDsFromBattleNetAccountIds"
payload := strings.NewReader("{\n \"BattleNetAccountIds\": [\n \"526f79204261747478\",\n \"526f79204261747479\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-Authorization", "<api-key>")
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://{titleId}.playfabapi.com/Client/GetPlayFabIDsFromBattleNetAccountIds")
.header("X-Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"BattleNetAccountIds\": [\n \"526f79204261747478\",\n \"526f79204261747479\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{titleId}.playfabapi.com/Client/GetPlayFabIDsFromBattleNetAccountIds")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-Authorization"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"BattleNetAccountIds\": [\n \"526f79204261747478\",\n \"526f79204261747479\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"status": "OK",
"data": {
"Data": [
{
"BattleNetAccountId": "526f79204261747478",
"PlayFabId": "5a446c83645201"
},
{
"BattleNetAccountId": "526f79204261747479",
"PlayFabId": "6345cd25a6c7cc"
}
]
}
}{
"code": 123,
"errorCode": 123,
"status": "<string>",
"error": "<string>",
"errorMessage": "<string>",
"errorDetails": {}
}