publishing

Pubblicare una build

VISIBILE SU INTERNET. È possibile pubblicare solo un sito con il piano Site: la pubblicazione di una bozza viene rifiutata con 403 feature_not_available e un action_url al relativo piano. Entro circa un minuto, rende questa build esatta (oppure, se manca build_id, la bozza nello stato attuale, dopo averla creata se necessario) visibile ai visitatori su tutti gli indirizzi del sito. La richiesta viene rifiutata con 409 se, dopo la verifica, il sito è stato pubblicato, ripristinato o messo offline (expected_generation). Richiede 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>"
}

Richiede sites:publish e il ruolo di amministratore del workspace. Non costa crediti.

La modifica sarà visibile su Internet. Pubblica solo dopo che il proprietario ha approvato ciò che è stato mostrato durante la revisione. Un link di rivendicazione o l’accesso con un account non costituiscono un’approvazione.

Se qualcuno, tu compreso, ha pubblicato il sito, ripristinato una versione precedente o lo ha messo offline dopo la revisione, la richiesta viene rifiutata con 409 conflict e non cambia nulla. Esegui di nuovo la revisione. Anche una build con blocchi viene rifiutata allo stesso modo, con i blocchi in details.

Se non specifichi build_id, viene pubblicata la bozza nello stato corrente, creando prima una build se necessario. Se build_id identifica una versione precedente alla bozza, la richiesta viene rifiutata (older_than_draft), a meno che tu non invii allow_older_build: true: pubblicare una versione precedente sarà quindi una scelta consapevole, non un errore.

Autorizzazioni

Authorizationbearerin headerrequired

Parametri di percorso

site_idstringrequired

L'ID del sito o il suo slug (l'indirizzo prima di .atelier201.page).

Corpo

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 build da pubblicare. Omettila per pubblicare la bozza nello stato attuale: se necessario, la build viene creata prima, con un'attesa aggiuntiva di alcuni secondi.

expected_generationintegerrequiredrange: 0–9007199254740991

allow_older_buildboolean

Necessario per pubblicare intenzionalmente una build precedente alla bozza; altrimenti la richiesta viene rifiutata (older_than_draft).

Risposta

application/json

Pubblica una build

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

Cosa è stato pubblicato con un elemento mancante: una riga _redirects ignorata fa perdere una pagina spostata. Correggila e pubblica di nuovo.

Show child attributes

data.warnings.codestringrequired

data.warnings.messagestringrequired

data.builtboolean

True se è stato necessario creare prima la build della bozza.

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

Pubblicare una build

Autorizzazioni

Parametri di percorso

Corpo

Risposta

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookie