Vincular conta do Game Center

Links the Game Center account associated with the provided Game Center ID to the user’s PlayFab account. Logging in with a Game Center ID is insecure if you do not include the optional PublicKeyUrl, Salt, Signature, and Timestamp parameters in this request. It is recommended you require these parameters on all Game Center calls by going to the Apple Add-ons page in the PlayFab Game Manager and enabling the ‘Require secure authentication only for this app’ option.

Error codes

This operation may return the following PlayFab errors:

Error	Code
AccountAlreadyLinked	1011
AccountLinkedToABannedPlayer	1613
GameCenterAuthenticationFailed	1429
InvalidGameCenterAuthRequest	1428
LinkedAccountAlreadyClaimed	1012

POST

Client

LinkGameCenterAccount

Link Game Center Account

curl --request POST \
  --url https://{titleId}.playfabapi.com/Client/LinkGameCenterAccount \
  --header 'Content-Type: application/json' \
  --header 'X-Authorization: <api-key>' \
  --data '
{
  "GameCenterId": "2998h2998f0b000d0993"
}
'

import requests

url = "https://{titleId}.playfabapi.com/Client/LinkGameCenterAccount"

payload = { "GameCenterId": "2998h2998f0b000d0993" }
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({GameCenterId: '2998h2998f0b000d0993'})
};

fetch('https://{titleId}.playfabapi.com/Client/LinkGameCenterAccount', 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/LinkGameCenterAccount",
  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([
    'GameCenterId' => '2998h2998f0b000d0993'
  ]),
  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/LinkGameCenterAccount"

	payload := strings.NewReader("{\n  \"GameCenterId\": \"2998h2998f0b000d0993\"\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/LinkGameCenterAccount")
  .header("X-Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"GameCenterId\": \"2998h2998f0b000d0993\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{titleId}.playfabapi.com/Client/LinkGameCenterAccount")

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  \"GameCenterId\": \"2998h2998f0b000d0993\"\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": {}
}

Autorizações

X-Authorization

string

header

obrigatório

This API requires a client session ticket, available from any Client Login function.

Corpo

application/json

GameCenterId

string

obrigatório

Game Center identifier for the player account to be linked.

CustomTags

object

The optional custom tags associated with the request (e.g. build number, external trace identifiers, etc.).

ForceLink

boolean

If another user is already linked to the account, unlink the other user and re-link. If the current user is already linked, link both accounts

PublicKeyUrl

string

The URL for the public encryption key that will be used to verify the signature.

Salt

string

A random value used to compute the hash and keep it randomized.

Signature

string

The verification signature of the authentication payload.

Timestamp

string

The integer representation of date and time that the signature was created on. PlayFab will reject authentication signatures not within 10 minutes of the server's current time.

Resposta

code

integer

The Http status code. If X-ReportErrorAsSuccess header is set to true, this will report the actual http error code.

status

string

The Http status code as a string.

data

object

Última modificação em 6 de outubro de 2026

Tópicos relacionados

Vincular conta do Facebook Vincular conta do Google Vincular conta do Google Play Games Services Integrar a Plataforma Universal do Windows ao PlayFab Desvincular conta do Game Center

⌘I

Link Game Center Account

curl --request POST \
  --url https://{titleId}.playfabapi.com/Client/LinkGameCenterAccount \
  --header 'Content-Type: application/json' \
  --header 'X-Authorization: <api-key>' \
  --data '
{
  "GameCenterId": "2998h2998f0b000d0993"
}
'

import requests

url = "https://{titleId}.playfabapi.com/Client/LinkGameCenterAccount"

payload = { "GameCenterId": "2998h2998f0b000d0993" }
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({GameCenterId: '2998h2998f0b000d0993'})
};

fetch('https://{titleId}.playfabapi.com/Client/LinkGameCenterAccount', 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/LinkGameCenterAccount",
  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([
    'GameCenterId' => '2998h2998f0b000d0993'
  ]),
  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/LinkGameCenterAccount"

	payload := strings.NewReader("{\n  \"GameCenterId\": \"2998h2998f0b000d0993\"\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/LinkGameCenterAccount")
  .header("X-Authorization", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"GameCenterId\": \"2998h2998f0b000d0993\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{titleId}.playfabapi.com/Client/LinkGameCenterAccount")

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  \"GameCenterId\": \"2998h2998f0b000d0993\"\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": {}
}

PlayFab API

PlayFab REST API References

Vincular conta do Game Center

Error codes

Autorizações

Corpo

Resposta