連結 Facebook Instant Games ID
Links the Facebook Instant Games Id to the user’s PlayFab account
Error codes
This operation may return the following PlayFab errors:
| Error | Code |
|---|---|
| AccountLinkedToABannedPlayer | 1613 |
| FacebookInstantGamesAuthNotConfiguredForTitle | 1397 |
| InvalidFacebookInstantGamesSignature | 1396 |
| LinkedIdentifierAlreadyClaimed | 1184 |
POST
/
Client
/
LinkFacebookInstantGamesId
Link Facebook Instant Games Id
curl --request POST \
--url https://{titleId}.playfabapi.com/Client/LinkFacebookInstantGamesId \
--header 'Content-Type: application/json' \
--header 'X-Authorization: <api-key>' \
--data '
{
"FacebookInstantGamesSignature": "abcdef"
}
'import requests
url = "https://{titleId}.playfabapi.com/Client/LinkFacebookInstantGamesId"
payload = { "FacebookInstantGamesSignature": "abcdef" }
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({FacebookInstantGamesSignature: 'abcdef'})
};
fetch('https://{titleId}.playfabapi.com/Client/LinkFacebookInstantGamesId', 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/LinkFacebookInstantGamesId",
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([
'FacebookInstantGamesSignature' => 'abcdef'
]),
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/LinkFacebookInstantGamesId"
payload := strings.NewReader("{\n \"FacebookInstantGamesSignature\": \"abcdef\"\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/LinkFacebookInstantGamesId")
.header("X-Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"FacebookInstantGamesSignature\": \"abcdef\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{titleId}.playfabapi.com/Client/LinkFacebookInstantGamesId")
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 \"FacebookInstantGamesSignature\": \"abcdef\"\n}"
response = http.request(request)
puts response.read_body{
"code": 123,
"status": "<string>",
"data": {}
}{
"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
Facebook Instant Games signature for the user.
The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).
If another user is already linked to the Facebook Instant Games ID, unlink the other user and re-link.
最後修改於 2026年10月19日
這個頁面有幫助嗎?
⌘I
Link Facebook Instant Games Id
curl --request POST \
--url https://{titleId}.playfabapi.com/Client/LinkFacebookInstantGamesId \
--header 'Content-Type: application/json' \
--header 'X-Authorization: <api-key>' \
--data '
{
"FacebookInstantGamesSignature": "abcdef"
}
'import requests
url = "https://{titleId}.playfabapi.com/Client/LinkFacebookInstantGamesId"
payload = { "FacebookInstantGamesSignature": "abcdef" }
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({FacebookInstantGamesSignature: 'abcdef'})
};
fetch('https://{titleId}.playfabapi.com/Client/LinkFacebookInstantGamesId', 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/LinkFacebookInstantGamesId",
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([
'FacebookInstantGamesSignature' => 'abcdef'
]),
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/LinkFacebookInstantGamesId"
payload := strings.NewReader("{\n \"FacebookInstantGamesSignature\": \"abcdef\"\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/LinkFacebookInstantGamesId")
.header("X-Authorization", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"FacebookInstantGamesSignature\": \"abcdef\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://{titleId}.playfabapi.com/Client/LinkFacebookInstantGamesId")
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 \"FacebookInstantGamesSignature\": \"abcdef\"\n}"
response = http.request(request)
puts response.read_body{
"code": 123,
"status": "<string>",
"data": {}
}{
"code": 123,
"errorCode": 123,
"status": "<string>",
"error": "<string>",
"errorMessage": "<string>",
"errorDetails": {}
}