publishing

Publicar una compilación

VISIBLE EN INTERNET. Solo se puede publicar un sitio con el plan Site: si es un borrador, se rechaza con 403 feature_not_available y un action_url a su plan. Esta compilación exacta (o, si no se indica build_id, el borrador tal como está ahora, compilado primero si es necesario) será lo que vean los visitantes en todas las direcciones del sitio, en aproximadamente un minuto. Se rechaza con 409 si el sitio se ha publicado, revertido o desconectado desde la revisión (expected_generation). Requiere sites:publish.

POST/v1/sites/{site_id}/publish

Request

curl --request POST \
  --url 'https://api.atelier201.com/v1/sites/<site_id>/publish' \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "expected_generation": 123
}'

import json
import requests

url = "https://api.atelier201.com/v1/sites/<site_id>/publish"
headers = {
  "Authorization": "<api-key>",
  "Content-Type": "application/json"
}
payload = json.loads("{\"expected_generation\":123}")

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

const response = await fetch("https://api.atelier201.com/v1/sites/<site_id>/publish", {
  method: "POST",
  headers: {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "expected_generation": 123
  }),
});

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>/publish");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
    "Content-Type: application/json",
]);
curl_setopt($client, CURLOPT_POSTFIELDS, "{\"expected_generation\":123}");
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

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

package main

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

func main() {
  req, _ := http.NewRequest("POST", "https://api.atelier201.com/v1/sites/<site_id>/publish", bytes.NewBuffer([]byte("{\"expected_generation\":123}")))
  req.Header.Set("Authorization", "<api-key>")
  req.Header.Set("Content-Type", "application/json")
  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>/publish"))
    .header("Authorization", "<api-key>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"expected_generation\":123}"))
    .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>/publish")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "<api-key>"
request["Content-Type"] = "application/json"
request.body = "{\"expected_generation\":123}"

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": {
    "site_id": "<string>",
    "build_id": "<string>",
    "generation": 123,
    "url": "<string>",
    "visible_within_seconds": 123,
    "warnings": [
      {
        "code": "<string>",
        "message": "<string>"
      }
    ],
    "built": true
  },
  "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:publish y permisos de administrador del espacio de trabajo. No consume créditos.

El sitio será visible en Internet. Publícalo solo después de que el propietario haya aprobado lo que se muestra en la revisión. Un enlace de acceso o iniciar sesión no equivalen a esa aprobación.

Si alguien, tú incluido, ha publicado el sitio, lo ha restaurado a una versión anterior o lo ha retirado desde tu revisión, la llamada se rechazará con 409 conflict y no cambiará nada. Vuelve a revisar. Una compilación con bloqueos también se rechaza del mismo modo, y los bloqueos se indican en details.

Si no se especifica build_id, se publica el borrador tal como está, después de compilarlo si hace falta. Si build_id corresponde a una versión anterior al borrador, se rechazará (older_than_draft), a menos que envíes allow_older_build: true: publicar una versión anterior será entonces una decisión, no un accidente.

Autorizaciones

Authorizationbearerin headerrequired

Parámetros de ruta

site_idstringrequired

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

Cuerpo

application/jsonrequired

build_idstring<uuid>pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

La compilación que se va a publicar. Omítelo para publicar el borrador tal como está ahora: se compilará primero si es necesario, lo que añadirá unos segundos.

expected_generationintegerrequiredrange: 0–9007199254740991

allow_older_buildboolean

Obligatorio para publicar deliberadamente una compilación anterior al borrador; de lo contrario, se rechaza (older_than_draft).

Respuesta

application/json

Publicar una compilación

dataobjectrequired

Show child attributes

data.site_idstringrequired

data.build_idstringrequired

data.generationintegerrequiredrange: -9007199254740991–9007199254740991

data.urlstringrequired

data.visible_within_secondsintegerrequiredrange: -9007199254740991–9007199254740991

data.warningsobject[]required

Qué se publicó con algo pendiente: una línea _redirects ignorada hace que se pierda una página movida. Corrígelo y vuelve a publicar.

Show child attributes

data.warnings.codestringrequired

data.warnings.messagestringrequired

data.builtboolean

Es true cuando ha sido necesario compilar primero el borrador.

request_idstringrequired

curl --request POST \ --url 'https://api.atelier201.com/v1/sites/<site_id>/publish' \ --header 'Authorization: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "expected_generation": 123 }'

{ "data": { "site_id": "<string>", "build_id": "<string>", "generation": 123, "url": "<string>", "visible_within_seconds": 123, "warnings": [ { "code": "<string>", "message": "<string>" } ], "built": true }, "request_id": "<string>" }

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

Publicar una compilación

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies