초안 항목 게시

Initiates a publish of an item from the working catalog to the public catalog. You can use the GetItemPublishStatus API to track the state of the item publish.

Allowed entity token types: title, master_player_account, title_player_account

Error codes

This operation may return the following PlayFab errors:

Error	Code
DatabaseThroughputExceeded	1113
ItemNotFound	1047

POST

Catalog

PublishDraftItem

Publish Draft Item

curl --request POST \
  --url https://{titleId}.playfabapi.com/Catalog/PublishDraftItem \
  --header 'Content-Type: application/json' \
  --header 'X-EntityToken: <api-key>' \
  --data '
{
  "Id": "dddddddd-dddd-dddd-dddd-dddddddddddd"
}
'

import requests

url = "https://{titleId}.playfabapi.com/Catalog/PublishDraftItem"

payload = { "Id": "dddddddd-dddd-dddd-dddd-dddddddddddd" }
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({Id: 'dddddddd-dddd-dddd-dddd-dddddddddddd'})
};

fetch('https://{titleId}.playfabapi.com/Catalog/PublishDraftItem', 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/Catalog/PublishDraftItem",
  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([
    'Id' => 'dddddddd-dddd-dddd-dddd-dddddddddddd'
  ]),
  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/Catalog/PublishDraftItem"

	payload := strings.NewReader("{\n  \"Id\": \"dddddddd-dddd-dddd-dddd-dddddddddddd\"\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/Catalog/PublishDraftItem")
  .header("X-EntityToken", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"Id\": \"dddddddd-dddd-dddd-dddd-dddddddddddd\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{titleId}.playfabapi.com/Catalog/PublishDraftItem")

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  \"Id\": \"dddddddd-dddd-dddd-dddd-dddddddddddd\"\n}"

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

{
  "code": 200,
  "status": "OK",
  "data": {}
}

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

인증

X-EntityToken

string

header

필수

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

본문

application/json

The call kicks off a workflow to publish the item to the public catalog. The Publish Status API should be used to monitor the publish job.

AlternateId

object

An alternate ID associated with this item.

Show child attributes

CustomTags

object

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

Entity

object

The entity to perform this action on.

Show child attributes

ETag

string

ETag of the catalog item to published from the working catalog to the public catalog. Used for optimistic concurrency. If the provided ETag does not match the ETag in the current working catalog, the request will be rejected. If not provided, the current version of the document in the working catalog will be published.

string

The unique ID of the item.

응답

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

예시:

{}

마지막 수정일 2026년 10월 6일

⌘I

Publish Draft Item

curl --request POST \
  --url https://{titleId}.playfabapi.com/Catalog/PublishDraftItem \
  --header 'Content-Type: application/json' \
  --header 'X-EntityToken: <api-key>' \
  --data '
{
  "Id": "dddddddd-dddd-dddd-dddd-dddddddddddd"
}
'

import requests

url = "https://{titleId}.playfabapi.com/Catalog/PublishDraftItem"

payload = { "Id": "dddddddd-dddd-dddd-dddd-dddddddddddd" }
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({Id: 'dddddddd-dddd-dddd-dddd-dddddddddddd'})
};

fetch('https://{titleId}.playfabapi.com/Catalog/PublishDraftItem', 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/Catalog/PublishDraftItem",
  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([
    'Id' => 'dddddddd-dddd-dddd-dddd-dddddddddddd'
  ]),
  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/Catalog/PublishDraftItem"

	payload := strings.NewReader("{\n  \"Id\": \"dddddddd-dddd-dddd-dddd-dddddddddddd\"\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/Catalog/PublishDraftItem")
  .header("X-EntityToken", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"Id\": \"dddddddd-dddd-dddd-dddd-dddddddddddd\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{titleId}.playfabapi.com/Catalog/PublishDraftItem")

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  \"Id\": \"dddddddd-dddd-dddd-dddd-dddddddddddd\"\n}"

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

{
  "code": 200,
  "status": "OK",
  "data": {}
}

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

PlayFab API

PlayFab REST API References

초안 항목 게시

Error codes

인증

본문

응답