Ejecutar Cloud Script de entidad

Cloud Script is one of PlayFab’s most versatile features. It allows client code to request execution of any kind of custom server-side functionality you can implement, and it can be used in conjunction with virtually anything.

Error codes

This operation may return the following PlayFab errors:

Error	Code
CloudScriptAPIRequestCountExceeded	1209
CloudScriptAPIRequestError	1210
CloudScriptFunctionArgumentSizeExceeded	1208
CloudScriptHTTPRequestError	1211
CloudScriptNotFound	1136
InvalidEntityType	1373
JavascriptException	1099
TitleDeleted	1347

POST

CloudScript

ExecuteEntityCloudScript

Execute Entity Cloud Script

curl --request POST \
  --url https://{titleId}.playfabapi.com/CloudScript/ExecuteEntityCloudScript \
  --header 'Content-Type: application/json' \
  --header 'X-EntityToken: <api-key>' \
  --data '
{
  "FunctionName": "levelCompleted",
  "FunctionParameter": {
    "level": 3,
    "points": 400
  },
  "RevisionSelection": "Live",
  "GeneratePlayStreamEvent": true,
  "Entity": {
    "Id": "aaa",
    "Type": "title_player_account",
    "TypeString": "title_player_account"
  }
}
'

import requests

url = "https://{titleId}.playfabapi.com/CloudScript/ExecuteEntityCloudScript"

payload = {
    "FunctionName": "levelCompleted",
    "FunctionParameter": {
        "level": 3,
        "points": 400
    },
    "RevisionSelection": "Live",
    "GeneratePlayStreamEvent": True,
    "Entity": {
        "Id": "aaa",
        "Type": "title_player_account",
        "TypeString": "title_player_account"
    }
}
headers = {
    "X-EntityToken": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-EntityToken': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    FunctionName: 'levelCompleted',
    FunctionParameter: {level: 3, points: 400},
    RevisionSelection: 'Live',
    GeneratePlayStreamEvent: true,
    Entity: {Id: 'aaa', Type: 'title_player_account', TypeString: 'title_player_account'}
  })
};

fetch('https://{titleId}.playfabapi.com/CloudScript/ExecuteEntityCloudScript', 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/CloudScript/ExecuteEntityCloudScript",
  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([
    'FunctionName' => 'levelCompleted',
    'FunctionParameter' => [
        'level' => 3,
        'points' => 400
    ],
    'RevisionSelection' => 'Live',
    'GeneratePlayStreamEvent' => true,
    'Entity' => [
        'Id' => 'aaa',
        'Type' => 'title_player_account',
        'TypeString' => 'title_player_account'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-EntityToken: <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/CloudScript/ExecuteEntityCloudScript"

	payload := strings.NewReader("{\n  \"FunctionName\": \"levelCompleted\",\n  \"FunctionParameter\": {\n    \"level\": 3,\n    \"points\": 400\n  },\n  \"RevisionSelection\": \"Live\",\n  \"GeneratePlayStreamEvent\": true,\n  \"Entity\": {\n    \"Id\": \"aaa\",\n    \"Type\": \"title_player_account\",\n    \"TypeString\": \"title_player_account\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-EntityToken", "<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/CloudScript/ExecuteEntityCloudScript")
  .header("X-EntityToken", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"FunctionName\": \"levelCompleted\",\n  \"FunctionParameter\": {\n    \"level\": 3,\n    \"points\": 400\n  },\n  \"RevisionSelection\": \"Live\",\n  \"GeneratePlayStreamEvent\": true,\n  \"Entity\": {\n    \"Id\": \"aaa\",\n    \"Type\": \"title_player_account\",\n    \"TypeString\": \"title_player_account\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{titleId}.playfabapi.com/CloudScript/ExecuteEntityCloudScript")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-EntityToken"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"FunctionName\": \"levelCompleted\",\n  \"FunctionParameter\": {\n    \"level\": 3,\n    \"points\": 400\n  },\n  \"RevisionSelection\": \"Live\",\n  \"GeneratePlayStreamEvent\": true,\n  \"Entity\": {\n    \"Id\": \"aaa\",\n    \"Type\": \"title_player_account\",\n    \"TypeString\": \"title_player_account\"\n  }\n}"

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

{
  "code": 200,
  "status": "OK",
  "data": {
    "Revision": 3,
    "FunctionResult": {
      "newScore": 25
    },
    "Logs": [
      {
        "Level": "Info",
        "Message": "Something normal happened",
        "Data": {
          "secondsAfterStart": 75
        }
      },
      {
        "Level": "Error",
        "Message": "Something unexpected happened"
      }
    ],
    "ExecutionTimeSeconds": 0.03670790046453476,
    "MemoryConsumedBytes": 38904,
    "APIRequestsIssued": 2
  }
}

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

Autorizaciones

X-EntityToken

string

header

requerido

This API requires an Entity Session Token, available from the Entity GetEntityToken method.

Cuerpo

application/json

Executes CloudScript with the entity profile that is defined in the request.

FunctionName

string

requerido

The name of the CloudScript function to execute

CustomTags

object

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

Entity

object

The optional entity to perform this action on. Defaults to the currently logged in entity.

Show child attributes

FunctionParameter

object

Object that is passed in to the function as the first argument

GeneratePlayStreamEvent

boolean

Generate a 'entity_executed_cloudscript' PlayStream event containing the results of the function execution and other contextual information. This event will show up in the PlayStream debugger console for the player in Game Manager.

RevisionSelection

enum<string>

Option for which revision of the CloudScript to execute. 'Latest' executes the most recently created revision, 'Live' executes the current live, published revision, and 'Specific' executes the specified revision. The default value is 'Specific', if the SpecificRevision parameter is specified, otherwise it is 'Live'.

Opciones disponibles:

Live,

Latest,

Specific

SpecificRevision

number

The specific revision to execute, when RevisionSelection is set to 'Specific'

Respuesta

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

Ejemplo:

{
  "Revision": 3,
  "FunctionResult": { "newScore": 25 },
  "Logs": [
    {
      "Level": "Info",
      "Message": "Something normal happened",
      "Data": { "secondsAfterStart": 75 }
    },
    {
      "Level": "Error",
      "Message": "Something unexpected happened"
    }
  ],
  "ExecutionTimeSeconds": 0.03670790046453476,
  "MemoryConsumedBytes": 38904,
  "APIRequestsIssued": 2
}

Última modificación el 6 de octubre de 2026

Temas relacionados

API de CloudScript de PlayFab Modelos de contexto de CloudScript de PlayFab con Azure Functions Ejecutar Cloud Script Escribir CloudScript personalizado Depuración local de CloudScript con Azure Functions

⌘I

Execute Entity Cloud Script

curl --request POST \
  --url https://{titleId}.playfabapi.com/CloudScript/ExecuteEntityCloudScript \
  --header 'Content-Type: application/json' \
  --header 'X-EntityToken: <api-key>' \
  --data '
{
  "FunctionName": "levelCompleted",
  "FunctionParameter": {
    "level": 3,
    "points": 400
  },
  "RevisionSelection": "Live",
  "GeneratePlayStreamEvent": true,
  "Entity": {
    "Id": "aaa",
    "Type": "title_player_account",
    "TypeString": "title_player_account"
  }
}
'

import requests

url = "https://{titleId}.playfabapi.com/CloudScript/ExecuteEntityCloudScript"

payload = {
    "FunctionName": "levelCompleted",
    "FunctionParameter": {
        "level": 3,
        "points": 400
    },
    "RevisionSelection": "Live",
    "GeneratePlayStreamEvent": True,
    "Entity": {
        "Id": "aaa",
        "Type": "title_player_account",
        "TypeString": "title_player_account"
    }
}
headers = {
    "X-EntityToken": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'X-EntityToken': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    FunctionName: 'levelCompleted',
    FunctionParameter: {level: 3, points: 400},
    RevisionSelection: 'Live',
    GeneratePlayStreamEvent: true,
    Entity: {Id: 'aaa', Type: 'title_player_account', TypeString: 'title_player_account'}
  })
};

fetch('https://{titleId}.playfabapi.com/CloudScript/ExecuteEntityCloudScript', 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/CloudScript/ExecuteEntityCloudScript",
  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([
    'FunctionName' => 'levelCompleted',
    'FunctionParameter' => [
        'level' => 3,
        'points' => 400
    ],
    'RevisionSelection' => 'Live',
    'GeneratePlayStreamEvent' => true,
    'Entity' => [
        'Id' => 'aaa',
        'Type' => 'title_player_account',
        'TypeString' => 'title_player_account'
    ]
  ]),
  CURLOPT_HTTPHEADER => [
    "Content-Type: application/json",
    "X-EntityToken: <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/CloudScript/ExecuteEntityCloudScript"

	payload := strings.NewReader("{\n  \"FunctionName\": \"levelCompleted\",\n  \"FunctionParameter\": {\n    \"level\": 3,\n    \"points\": 400\n  },\n  \"RevisionSelection\": \"Live\",\n  \"GeneratePlayStreamEvent\": true,\n  \"Entity\": {\n    \"Id\": \"aaa\",\n    \"Type\": \"title_player_account\",\n    \"TypeString\": \"title_player_account\"\n  }\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("X-EntityToken", "<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/CloudScript/ExecuteEntityCloudScript")
  .header("X-EntityToken", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"FunctionName\": \"levelCompleted\",\n  \"FunctionParameter\": {\n    \"level\": 3,\n    \"points\": 400\n  },\n  \"RevisionSelection\": \"Live\",\n  \"GeneratePlayStreamEvent\": true,\n  \"Entity\": {\n    \"Id\": \"aaa\",\n    \"Type\": \"title_player_account\",\n    \"TypeString\": \"title_player_account\"\n  }\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{titleId}.playfabapi.com/CloudScript/ExecuteEntityCloudScript")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["X-EntityToken"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"FunctionName\": \"levelCompleted\",\n  \"FunctionParameter\": {\n    \"level\": 3,\n    \"points\": 400\n  },\n  \"RevisionSelection\": \"Live\",\n  \"GeneratePlayStreamEvent\": true,\n  \"Entity\": {\n    \"Id\": \"aaa\",\n    \"Type\": \"title_player_account\",\n    \"TypeString\": \"title_player_account\"\n  }\n}"

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

{
  "code": 200,
  "status": "OK",
  "data": {
    "Revision": 3,
    "FunctionResult": {
      "newScore": 25
    },
    "Logs": [
      {
        "Level": "Info",
        "Message": "Something normal happened",
        "Data": {
          "secondsAfterStart": 75
        }
      },
      {
        "Level": "Error",
        "Message": "Something unexpected happened"
      }
    ],
    "ExecutionTimeSeconds": 0.03670790046453476,
    "MemoryConsumedBytes": 38904,
    "APIRequestsIssued": 2
  }
}

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

PlayFab API

PlayFab REST API References

Ejecutar Cloud Script de entidad

Error codes

Autorizaciones

Cuerpo

Respuesta