media

Importer un fichier multimédia

Envoyez le fichier dans le corps brut de la requête avec ?filename=. Images, PDF et vidéos courtes, 20 MB chacune. Toute image de plus de 200 KB est compressée à l’importation (2000 px maximum, cible de 150 KB, nette sur Retina, métadonnées supprimées) ; keep_original=true la stocke exactement telle qu’envoyée, uniquement à la demande du propriétaire. Référencez-la sous /media/ dans le contenu ; elle sera incluse à partir de la prochaine génération.

POST/v1/sites/{site_id}/media

Request

curl --request POST \
  --url 'https://api.atelier201.com/v1/sites/<site_id>/media?filename=<filename>' \
  --header 'Authorization: <api-key>'

import json
import requests

url = "https://api.atelier201.com/v1/sites/<site_id>/media?filename=<filename>"
headers = {
  "Authorization": "<api-key>"
}

response = requests.request("POST", url, headers=headers)
print(response.json())

const response = await fetch("https://api.atelier201.com/v1/sites/<site_id>/media?filename=<filename>", {
  method: "POST",
  headers: {
    "Authorization": "<api-key>"
  },
});

const data = await response.json();
console.log(data);

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://api.atelier201.com/v1/sites/<site_id>/media?filename=<filename>");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
]);
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($client);
curl_close($client);
echo $response;

package main

import (
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("POST", "https://api.atelier201.com/v1/sites/<site_id>/media?filename=<filename>", nil)
  req.Header.Set("Authorization", "<api-key>")
  res, _ := http.DefaultClient.Do(req)
  defer res.Body.Close()
  data, _ := io.ReadAll(res.Body)
  fmt.Println(string(data))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

var request = HttpRequest.newBuilder(URI.create("https://api.atelier201.com/v1/sites/<site_id>/media?filename=<filename>"))
    .header("Authorization", "<api-key>")
    .method("POST", HttpRequest.BodyPublishers.noBody())
    .build();

var response = HttpClient.newHttpClient().send(
    request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

require 'net/http'
require 'json'

uri = URI("https://api.atelier201.com/v1/sites/<site_id>/media?filename=<filename>")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "<api-key>"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == "https") do |http|
  http.request(request)
end

puts response.body

application/json

{
  "data": {
    "id": "<string>",
    "path": "<string>",
    "url_path": "<string>",
    "mime": "<string>",
    "size": 123,
    "alt": null,
    "credit": null,
    "source_url": null,
    "keep_original": true,
    "created_at": "<string>",
    "original_size": 123,
    "next_action": "<string>"
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

{
  "error": {
    "type": "<string>",
    "code": "<string>",
    "message": "<string>",
    "param": "<string>",
    "docs_url": "<string>",
    "action_url": "<string>",
    "details": {}
  },
  "request_id": "<string>"
}

Nécessite sites:write. Aucun crédit n’est facturé.

Envoyez les octets du fichier dans le corps de la requête, et indiquez son nom dans filename. Chaque fichier peut peser jusqu’à 20 MB, dans la limite de stockage de l’offre. Référencez-le sous /media/<filename> dans le contenu. Il sera inclus à partir de la prochaine compilation, mais les visiteurs ne verront rien avant la publication.

Autorisations

Authorizationbearerin headerrequired

Paramètres de chemin

site_idstringrequired

L’identifiant du site ou son slug (l’adresse avant .atelier201.page).

Paramètres de requête

filenamestringrequiredlength: 1–160 chars

altstringlength: ≤ 300 chars

keep_originalboolean

true conserve le fichier exactement tel qu’envoyé, en qualité et taille maximales : uniquement à la demande du propriétaire (œuvre d’un photographe). Par défaut, toute image de plus de 200 KB est compressée à l’importation.

Réponse

application/json

Importer un fichier multimédia

dataobjectrequired

Show child attributes

data.idstringrequired

data.pathstringrequired

data.url_pathstringrequired

data.mimestringrequired

data.sizeintegerrequiredrange: -9007199254740991–9007199254740991

data.altstringnullrequired

data.creditstringnullrequired

Auteur, lorsque la licence l’exige : « Photo by Jane Doe on Pixabay », « Generated with Seedream 5 Lite (ByteDance) ». Null pour un fichier importé.

data.source_urlstringnullrequired

Page de banque d’images d’origine, ou null.

data.keep_originalbooleanrequired

Stocké exactement comme lors de l’importation, sans jamais être réencodé lors d’une génération. Sinon, toute image de plus de 200 KB est compressée à l’importation (2000 px maximum, cible de 150 KB, qualité de 75 ou plus, métadonnées supprimées).

data.created_atstringrequired

ISO 8601, UTC.

data.original_sizeintegerrequiredrange: -9007199254740991–9007199254740991

La taille envoyée, en octets ; size correspond à la taille stockée après compression.

data.next_actionstringrequired

request_idstringrequired

{ "data": { "id": "<string>", "path": "<string>", "url_path": "<string>", "mime": "<string>", "size": 123, "alt": null, "credit": null, "source_url": null, "keep_original": true, "created_at": "<string>", "original_size": 123, "next_action": "<string>" }, "request_id": "<string>" }

{ "error": { "type": "<string>", "code": "<string>", "message": "<string>", "param": "<string>", "docs_url": "<string>", "action_url": "<string>", "details": {} }, "request_id": "<string>" }

Importer un fichier multimédia

Autorisations

Paramètres de chemin

Paramètres de requête

Réponse

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies