media

Subir un archivo multimedia

Envía el archivo como cuerpo sin procesar de la solicitud con ?filename=. Imágenes, PDF y vídeos cortos, 20 MB cada uno. Las imágenes de más de 200 KB se comprimen al subirlas (máximo 2000 px, objetivo de 150 KB, nitidez para pantallas Retina y metadatos eliminados); keep_original=true las almacena exactamente como se han enviado, solo si lo solicita el propietario. Haz referencia al archivo como /media/ en el contenido; estará incluido a partir de la siguiente compilación.

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

Requiere sites:write. No consume créditos.

Envía los bytes del archivo en el cuerpo de la solicitud e indica su nombre en filename. Cada archivo puede ocupar hasta 20 MB, dentro del almacenamiento del plan. Haz referencia a él como /media/<filename> en el contenido. Se incluirá a partir de la siguiente compilación; los visitantes no verán nada hasta que publiques el sitio.

Autorizaciones

Authorizationbearerin headerrequired

Parámetros de ruta

site_idstringrequired

El ID del sitio o su slug (la dirección antes de .atelier201.page).

Parámetros de consulta

filenamestringrequiredlength: 1–160 chars

altstringlength: ≤ 300 chars

keep_originalboolean

true conserva el archivo exactamente como se ha enviado, con toda su calidad y tamaño: solo cuando lo solicita el propietario (por ejemplo, si es obra de un fotógrafo). De forma predeterminada, las imágenes de más de 200 KB se comprimen al subirlas.

Respuesta

application/json

Subir un archivo multimedia

dataobjectrequired

Show child attributes

data.idstringrequired

data.pathstringrequired

data.url_pathstringrequired

data.mimestringrequired

data.sizeintegerrequiredrange: -9007199254740991–9007199254740991

data.altstringnullrequired

data.creditstringnullrequired

Quién lo creó, cuando la licencia lo requiere: "Photo by Jane Doe on Pixabay", "Generated with Seedream 5 Lite (ByteDance)". Null si se ha subido el archivo.

data.source_urlstringnullrequired

La página de imágenes de stock de la que procede, o null.

data.keep_originalbooleanrequired

Se almacena exactamente como se ha subido y nunca se vuelve a codificar durante una compilación. De lo contrario, las imágenes de más de 200 KB se comprimen al subirlas (máximo 2000 px, objetivo de 150 KB, calidad de 75 o superior y metadatos eliminados).

data.created_atstringrequired

ISO 8601, UTC.

data.original_sizeintegerrequiredrange: -9007199254740991–9007199254740991

El tamaño enviado, en bytes; size es el tamaño almacenado tras la compresión.

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

Subir un archivo multimedia

Autorizaciones

Parámetros de ruta

Parámetros de consulta

Respuesta

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies