從 Nintendo Switch 裝置 ID 取得 PlayFab ID
Retrieves the unique PlayFab identifiers for the given set of Nintendo Switch Device identifiers.
POST
/
Server
/
GetPlayFabIDsFromNintendoSwitchDeviceIds
Get Play Fab IDs From Nintendo Switch Device Ids
curl --request POST \
--url https://{titleId}.playfabapi.com/Server/GetPlayFabIDsFromNintendoSwitchDeviceIds \
--header 'Content-Type: application/json' \
--header 'X-SecretKey: <api-key>' \
--data '
{
"NintendoSwitchDeviceIds": [
"526f79204261747478",
"526f79204261747479"
]
}
'import requests
url = "https://{titleId}.playfabapi.com/Server/GetPlayFabIDsFromNintendoSwitchDeviceIds"
payload = { "NintendoSwitchDeviceIds": ["526f79204261747478", "526f79204261747479"] }
headers = {
"X-SecretKey": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-SecretKey': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({NintendoSwitchDeviceIds: ['526f79204261747478', '526f79204261747479']})
};
fetch('https://{titleId}.playfabapi.com/Server/GetPlayFabIDsFromNintendoSwitchDeviceIds', 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/Server/GetPlayFabIDsFromNintendoSwitchDeviceIds",
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([
'NintendoSwitchDeviceIds' => [
'526f79204261747478',
'526f79204261747479'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-SecretKey: <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/Server/GetPlayFabIDsFromNintendoSwitchDeviceIds"
payload := strings.NewReader("{\n \"NintendoSwitchDeviceIds\": [\n \"526f79204261747478\",\n \"526f79204261747479\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-SecretKey", "<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/Server/GetPlayFabIDsFromNintendoSwitchDeviceIds")
.header("X-SecretKey", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"NintendoSwitchDeviceIds\": [\n \"526f79204261747478\",\n \"526f79204261747479\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{titleId}.playfabapi.com/Server/GetPlayFabIDsFromNintendoSwitchDeviceIds")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-SecretKey"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"NintendoSwitchDeviceIds\": [\n \"526f79204261747478\",\n \"526f79204261747479\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"status": "OK",
"data": {
"Data": [
{
"NintendoSwitchDeviceId": "526f79204261747478",
"PlayFabId": "5a446c83645201"
},
{
"NintendoSwitchDeviceId": "526f79204261747479",
"PlayFabId": "6345cd25a6c7cc"
}
]
}
}{
"code": 123,
"errorCode": 123,
"status": "<string>",
"error": "<string>",
"errorMessage": "<string>",
"errorDetails": {}
}授權
This API requires a title secret key, available to title admins, from PlayFab Game Manager.
主體
application/json
Array of unique Nintendo Switch Device identifiers for which the title needs to get PlayFab identifiers. The array cannot exceed 25 in length.
回應
For Nintendo Switch Device 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 Nintendo Switch Device identifiers which have not been linked to PlayFab accounts, null will be returned.
Show child attributes
Show child attributes
範例:
{
"Data": [
{
"NintendoSwitchDeviceId": "526f79204261747478",
"PlayFabId": "5a446c83645201"
},
{
"NintendoSwitchDeviceId": "526f79204261747479",
"PlayFabId": "6345cd25a6c7cc"
}
]
}
最後修改於 2026年10月6日
這個頁面有幫助嗎?
⌘I
Get Play Fab IDs From Nintendo Switch Device Ids
curl --request POST \
--url https://{titleId}.playfabapi.com/Server/GetPlayFabIDsFromNintendoSwitchDeviceIds \
--header 'Content-Type: application/json' \
--header 'X-SecretKey: <api-key>' \
--data '
{
"NintendoSwitchDeviceIds": [
"526f79204261747478",
"526f79204261747479"
]
}
'import requests
url = "https://{titleId}.playfabapi.com/Server/GetPlayFabIDsFromNintendoSwitchDeviceIds"
payload = { "NintendoSwitchDeviceIds": ["526f79204261747478", "526f79204261747479"] }
headers = {
"X-SecretKey": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'X-SecretKey': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({NintendoSwitchDeviceIds: ['526f79204261747478', '526f79204261747479']})
};
fetch('https://{titleId}.playfabapi.com/Server/GetPlayFabIDsFromNintendoSwitchDeviceIds', 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/Server/GetPlayFabIDsFromNintendoSwitchDeviceIds",
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([
'NintendoSwitchDeviceIds' => [
'526f79204261747478',
'526f79204261747479'
]
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"X-SecretKey: <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/Server/GetPlayFabIDsFromNintendoSwitchDeviceIds"
payload := strings.NewReader("{\n \"NintendoSwitchDeviceIds\": [\n \"526f79204261747478\",\n \"526f79204261747479\"\n ]\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("X-SecretKey", "<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/Server/GetPlayFabIDsFromNintendoSwitchDeviceIds")
.header("X-SecretKey", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"NintendoSwitchDeviceIds\": [\n \"526f79204261747478\",\n \"526f79204261747479\"\n ]\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{titleId}.playfabapi.com/Server/GetPlayFabIDsFromNintendoSwitchDeviceIds")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["X-SecretKey"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"NintendoSwitchDeviceIds\": [\n \"526f79204261747478\",\n \"526f79204261747479\"\n ]\n}"
response = http.request(request)
puts response.read_body{
"code": 200,
"status": "OK",
"data": {
"Data": [
{
"NintendoSwitchDeviceId": "526f79204261747478",
"PlayFabId": "5a446c83645201"
},
{
"NintendoSwitchDeviceId": "526f79204261747479",
"PlayFabId": "6345cd25a6c7cc"
}
]
}
}{
"code": 123,
"errorCode": 123,
"status": "<string>",
"error": "<string>",
"errorMessage": "<string>",
"errorDetails": {}
}