Passer au contenu principal
POST
/
2
/
media
/
upload
Téléverser des médias
curl --request POST \
  --url https://api.x.com/2/media/upload \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "media": "<string>",
  "media_category": "tweet_image",
  "additional_owners": [
    "2244994945"
  ],
  "media_type": "image/png",
  "shared": false
}
'
{
  "errors": [
    {
      "title": "<string>",
      "type": "<string>",
      "detail": "<string>",
      "status": 123
    }
  ]
}

Autorisations

​
Authorization
string
header
requis

The access token received from the authorization server in the OAuth 2.0 flow.

Corps

​
media
requis

Fichier à téléverser.

​
media_category
enum<string>
requis

Une valeur d’énumération de type chaîne de caractères qui identifie un cas d’usage de média. Cet identifiant est utilisé pour imposer des contraintes spécifiques à ce cas d’usage (par exemple, taille de fichier) et activer des fonctionnalités avancées.

Options disponibles:
tweet_image,
dm_image,
subtitles
Exemple:

"tweet_image"

​
additional_owners
string[]

Identifiant unique de cet utilisateur. Il est renvoyé sous forme de chaîne de caractères afin d’éviter les problèmes avec les langages et outils qui ne prennent pas en charge les entiers de grande taille.

Pattern: ^[0-9]{1,19}$
​
media_type
enum<string>

Le type d’image ou de sous-titre.

Options disponibles:
text/srt,
text/vtt,
image/jpeg,
image/bmp,
image/png,
image/webp,
image/pjpeg,
image/tiff
Exemple:

"image/png"

​
shared
boolean
défaut:false

Indique si ce média est partagé ou non.

Réponse

La requête a réussi.

Réponse renvoyée lors de la récupération du statut d’une requête de téléversement de média.

​
data
object
​
errors
object[]
Minimum array length: 1

Un objet HTTP Problem Details, tel que défini dans la RFC IETF 7807 (https://tools.ietf.org/html/rfc7807).