publishing

Build veröffentlichen

IM INTERNET SICHTBAR. Veröffentlicht werden kann nur eine Website mit dem Site-Tarif: Bei einem Entwurf wird die Anfrage mit 403 feature_not_available und einer action_url zu dessen Tarif abgelehnt. Dieser genaue Build wird für Besucher unter allen Adressen der Website sichtbar (oder, wenn keine build_id angegeben ist, der aktuelle Entwurf, der bei Bedarf zuerst erstellt wird). Das dauert etwa eine Minute. Die Anfrage wird mit 409 abgelehnt, wenn die Website seit deiner Prüfung veröffentlicht, zurückgesetzt oder offline geschaltet wurde (expected_generation). Erfordert 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>"
}

Erfordert sites:publish und Workspace-Adminrechte. Kostet keine Credits.

Diese Änderung ist im Internet sichtbar. Veröffentliche erst, nachdem der Betreiber die Ergebnisse von Prüfen freigegeben hat. Ein Anspruchslink oder eine Anmeldung gelten nicht als Freigabe.

Wurde der Standort seit der Prüfung veröffentlicht, zurückgesetzt oder offline genommen, auch von dir selbst, wird der Aufruf mit 409 conflict abgelehnt. Es ändert sich nichts. Prüfe den Standort erneut. Ein Build mit Blockern wird genauso abgelehnt. Die Blocker stehen in details.

Ohne build_id wird der aktuelle Entwurf live geschaltet und bei Bedarf zuerst erstellt. Ist ein build_id älter als der Entwurf, wird die Anfrage mit older_than_draft abgelehnt. Das gilt nicht, wenn du allow_older_build: true sendest. Eine ältere Version live zu schalten, ist dann eine bewusste Entscheidung und kein Versehen.

Autorisierung

Authorizationbearerin headerrequired

Pfadparameter

site_idstringrequired

ID der Website oder ihr Slug (die Adresse vor .atelier201.page).

Body

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)$

Der zu veröffentlichende Build. Lässt du dieses Feld aus, wird der Entwurf in seinem aktuellen Stand veröffentlicht. Bei Bedarf wird er zuerst erstellt, was einige Sekunden dauert.

expected_generationintegerrequiredrange: 0–9007199254740991

allow_older_buildboolean

Erforderlich, um absichtlich einen Build zu veröffentlichen, der älter als der Entwurf ist. Andernfalls wird die Anfrage abgelehnt (older_than_draft).

Antwort

application/json

Build veröffentlichen

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

Was unvollständig veröffentlicht wurde: Eine ignorierte _redirects-Zeile lässt eine verschobene Seite verloren gehen. Behebe den Fehler und veröffentliche erneut.

Show child attributes

data.warnings.codestringrequired

data.warnings.messagestringrequired

data.builtboolean

True, wenn der Entwurf zuerst erstellt werden musste.

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

Build veröffentlichen

Autorisierung

Pfadparameter

Body

Antwort

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies