Attribuer un succès Steam

Awards the specified users the specified Steam achievements

Error codes

This operation may return the following PlayFab errors:

Error	Code
ProductDisabledForTitle	1609
UserisNotValid	1030

POST

Server

AwardSteamAchievement

Award Steam Achievement

curl --request POST \
  --url https://{titleId}.playfabapi.com/Server/AwardSteamAchievement \
  --header 'Content-Type: application/json' \
  --header 'X-SecretKey: <api-key>' \
  --data '
{
  "Achievements": [
    {
      "PlayFabId": "234974573892",
      "AchievementName": "FinishLevel1"
    },
    {
      "PlayFabId": "334353433",
      "AchievementName": "FinishLevel1"
    }
  ]
}
'

import requests

url = "https://{titleId}.playfabapi.com/Server/AwardSteamAchievement"

payload = { "Achievements": [
        {
            "PlayFabId": "234974573892",
            "AchievementName": "FinishLevel1"
        },
        {
            "PlayFabId": "334353433",
            "AchievementName": "FinishLevel1"
        }
    ] }
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({
    Achievements: [
      {PlayFabId: '234974573892', AchievementName: 'FinishLevel1'},
      {PlayFabId: '334353433', AchievementName: 'FinishLevel1'}
    ]
  })
};

fetch('https://{titleId}.playfabapi.com/Server/AwardSteamAchievement', 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/AwardSteamAchievement",
  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([
    'Achievements' => [
        [
                'PlayFabId' => '234974573892',
                'AchievementName' => 'FinishLevel1'
        ],
        [
                'PlayFabId' => '334353433',
                'AchievementName' => 'FinishLevel1'
        ]
    ]
  ]),
  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/AwardSteamAchievement"

	payload := strings.NewReader("{\n  \"Achievements\": [\n    {\n      \"PlayFabId\": \"234974573892\",\n      \"AchievementName\": \"FinishLevel1\"\n    },\n    {\n      \"PlayFabId\": \"334353433\",\n      \"AchievementName\": \"FinishLevel1\"\n    }\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/AwardSteamAchievement")
  .header("X-SecretKey", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"Achievements\": [\n    {\n      \"PlayFabId\": \"234974573892\",\n      \"AchievementName\": \"FinishLevel1\"\n    },\n    {\n      \"PlayFabId\": \"334353433\",\n      \"AchievementName\": \"FinishLevel1\"\n    }\n  ]\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{titleId}.playfabapi.com/Server/AwardSteamAchievement")

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  \"Achievements\": [\n    {\n      \"PlayFabId\": \"234974573892\",\n      \"AchievementName\": \"FinishLevel1\"\n    },\n    {\n      \"PlayFabId\": \"334353433\",\n      \"AchievementName\": \"FinishLevel1\"\n    }\n  ]\n}"

response = http.request(request)
puts response.read_body

{
  "code": 200,
  "status": "OK",
  "data": {
    "AchievementResults": [
      {
        "PlayFabId": "234974573892",
        "AchievementName": "FinishLevel1",
        "Result": true
      },
      {
        "PlayFabId": "334353433",
        "AchievementName": "FinishLevel1",
        "Result": true
      }
    ]
  }
}

{
  "code": 123,
  "errorCode": 123,
  "status": "<string>",
  "error": "<string>",
  "errorMessage": "<string>",
  "errorDetails": {}
}

Autorisations

X-SecretKey

string

header

requis

This API requires a title secret key, available to title admins, from PlayFab Game Manager.

Corps

application/json

Achievements

object[]

requis

Array of achievements to grant and the users to whom they are to be granted.

Show child attributes

Réponse

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

Show child attributes

Exemple:

{
  "AchievementResults": [
    {
      "PlayFabId": "234974573892",
      "AchievementName": "FinishLevel1",
      "Result": true
    },
    {
      "PlayFabId": "334353433",
      "AchievementName": "FinishLevel1",
      "Result": true
    }
  ]
}

Dernière modification le 6 octobre 2026

Sujets connexes

Statistiques et succès Fonctionnalités du GDK absentes de Steamworks Succès Configurer les succès gérés par le titre dans Partner Center Différences conceptuelles entre le GDK et Steamworks

⌘I