コンテンツアップロード URL の取得

Retrieves the pre-signed URL for uploading a content file. A subsequent HTTP PUT to the returned URL uploads the content. Also, please be aware that the Content service is specifically PlayFab’s CDN offering, for which standard CDN rates apply.

Error codes

This operation may return the following PlayFab errors:

Error	Code
BillingInformationRequired	1266
ContentQuotaExceeded	1137
NotAuthorized	1089
ProductDisabledForTitle	1609

POST

Admin

GetContentUploadUrl

Get Content Upload Url

curl --request POST \
  --url https://{titleId}.playfabapi.com/Admin/GetContentUploadUrl \
  --header 'Content-Type: application/json' \
  --header 'X-SecretKey: <api-key>' \
  --data '
{
  "Key": "images/sword_icon.png",
  "ContentType": "image/png"
}
'

import requests

url = "https://{titleId}.playfabapi.com/Admin/GetContentUploadUrl"

payload = {
    "Key": "images/sword_icon.png",
    "ContentType": "image/png"
}
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({Key: 'images/sword_icon.png', ContentType: 'image/png'})
};

fetch('https://{titleId}.playfabapi.com/Admin/GetContentUploadUrl', 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/Admin/GetContentUploadUrl",
  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([
    'Key' => 'images/sword_icon.png',
    'ContentType' => 'image/png'
  ]),
  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/Admin/GetContentUploadUrl"

	payload := strings.NewReader("{\n  \"Key\": \"images/sword_icon.png\",\n  \"ContentType\": \"image/png\"\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/Admin/GetContentUploadUrl")
  .header("X-SecretKey", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"Key\": \"images/sword_icon.png\",\n  \"ContentType\": \"image/png\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{titleId}.playfabapi.com/Admin/GetContentUploadUrl")

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  \"Key\": \"images/sword_icon.png\",\n  \"ContentType\": \"image/png\"\n}"

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

{
  "code": 200,
  "status": "OK",
  "data": {
    "URL": "https://..."
  }
}

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

承認

X-SecretKey

string

header

必須

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

ボディ

application/json

Key

string

必須

Key of the content item to upload, usually formatted as a path, e.g. images/a.png

ContentType

string

A standard MIME type describing the format of the contents. The same MIME type has to be set in the header when uploading the content. If not specified, the MIME type is 'binary/octet-stream' by default.

レスポンス

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

例:

{ "URL": "https://..." }

最終更新日 2026年10月6日

⌘I

Get Content Upload Url

curl --request POST \
  --url https://{titleId}.playfabapi.com/Admin/GetContentUploadUrl \
  --header 'Content-Type: application/json' \
  --header 'X-SecretKey: <api-key>' \
  --data '
{
  "Key": "images/sword_icon.png",
  "ContentType": "image/png"
}
'

import requests

url = "https://{titleId}.playfabapi.com/Admin/GetContentUploadUrl"

payload = {
    "Key": "images/sword_icon.png",
    "ContentType": "image/png"
}
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({Key: 'images/sword_icon.png', ContentType: 'image/png'})
};

fetch('https://{titleId}.playfabapi.com/Admin/GetContentUploadUrl', 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/Admin/GetContentUploadUrl",
  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([
    'Key' => 'images/sword_icon.png',
    'ContentType' => 'image/png'
  ]),
  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/Admin/GetContentUploadUrl"

	payload := strings.NewReader("{\n  \"Key\": \"images/sword_icon.png\",\n  \"ContentType\": \"image/png\"\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/Admin/GetContentUploadUrl")
  .header("X-SecretKey", "<api-key>")
  .header("Content-Type", "application/json")
  .body("{\n  \"Key\": \"images/sword_icon.png\",\n  \"ContentType\": \"image/png\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://{titleId}.playfabapi.com/Admin/GetContentUploadUrl")

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  \"Key\": \"images/sword_icon.png\",\n  \"ContentType\": \"image/png\"\n}"

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

{
  "code": 200,
  "status": "OK",
  "data": {
    "URL": "https://..."
  }
}

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

PlayFab API

PlayFab REST API References

コンテンツアップロード URL の取得

Error codes

承認

ボディ

レスポンス