Obtenir l'URL de téléversement du contenu

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": {}
}

Autorisations

X-SecretKey

string

header

requis

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

Corps

application/json

Key

string

requis

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.

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:

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

Dernière modification le 6 octobre 2026

Sujets connexes

Obtenir l'URL de téléchargement du contenu Obtenir l'URL de téléversement d'une ressource Obtenir l'URL de téléchargement d'une ressource Démarrage rapide du réseau de distribution de contenu PFCatalogUploadUrlMetadata

⌘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

Obtenir l'URL de téléversement du contenu

Error codes

Autorisations

Corps

Réponse