domains

Website-Adresse ändern

Verschiebt die Website zu .atelier201.page. Die Adresse muss verfügbar sein. Die vorherige Adresse leitet 30 Tage lang hierher weiter (Besucher können ihre Links weiterhin verwenden) und kann in dieser Zeit nur von dieser Website zurückgeholt werden. Vorhandene Vorschaulinks funktionieren weiterhin. Eine Live-Website, deren Hauptadresse dies ist, wird neu erstellt. Veröffentliche sie, um den Vorgang abzuschließen. Keine Credits.

POST/v1/sites/{site_id}/address

Request

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

import json
import requests

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

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

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

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>/address");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
    "Content-Type: application/json",
]);
curl_setopt($client, CURLOPT_POSTFIELDS, "{\"slug\":\"<string>\"}");
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>/address", bytes.NewBuffer([]byte("{\"slug\":\"<string>\"}")))
  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>/address"))
    .header("Authorization", "<api-key>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"slug\":\"<string>\"}"))
    .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>/address")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "<api-key>"
request["Content-Type"] = "application/json"
request.body = "{\"slug\":\"<string>\"}"

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": {
    "slug": "<string>",
    "hostname": "<string>",
    "url": "<string>",
    "previous_hostname": null,
    "redirects_until": null,
    "rebuild": {
      "id": "<string>",
      "site_id": "<string>",
      "revision": "<string>",
      "state": "queued",
      "target_origin": "<string>",
      "profile": "standard",
      "file_count": 123,
      "total_bytes": 123,
      "duration_ms": 123,
      "error": {
        "code": "<string>",
        "message": null
      },
      "warnings": [
        "<string>"
      ],
      "created_at": "<string>",
      "started_at": "<string>",
      "finished_at": "<string>"
    },
    "next_action": null
  },
  "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 domains:write und einen Workspace-Administrator.

Die bisherige Adresse wird 30 Tage lang weitergeleitet. In dieser Zeit kann nur diese Website sie zurückholen. Canonical-Links und die Sitemap werden beim Build erstellt. Deshalb muss eine Live-Website neu gebaut werden, wenn dies ihre Hauptadresse ist. Veröffentliche diesen Build, um den Vorgang abzuschließen. Die Antwort weist in next_action darauf hin.

Autorisierung

Authorizationbearerin headerrequired

Pfadparameter

site_idstringrequired

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

Body

application/jsonrequired

slugstringrequiredlength: 3–40 chars

Die neue Adresse: .atelier201.page. 3 bis 40 Kleinbuchstaben, Ziffern oder einzelne Bindestriche.

Antwort

application/json

Die atelier201.page-Adresse der Website ändern

dataobjectrequired

Show child attributes

data.slugstringrequired

data.hostnamestringrequired

data.urlstringrequired

data.previous_hostnamestringnullrequired

Die aufgegebene Adresse. Null, wenn die Website diese Adresse bereits hatte.

data.redirects_untilstringnullrequired

Bis wann die vorherige Adresse hierher weiterleitet. Null, wenn die Website noch nie veröffentlicht wurde: Es gab keine Besucher, die weitergeleitet werden mussten.

data.rebuildobject | nullrequired

Show child attributes

data.rebuild.idstringrequired

data.rebuild.site_idstringrequired

data.rebuild.revisionstringrequiredlength: 40–40 chars

Eine Git-Commit-ID (40 hexadezimale Zeichen) des Repositorys der Website.

data.rebuild.stateenum<string>requiredone of: queued, building, collecting, ready, failed, cancelled

data.rebuild.target_originstringrequired

data.rebuild.profileenum<string>requiredone of: standard, guest-demo

data.rebuild.file_countinteger | nullrequired

data.rebuild.total_bytesinteger | nullrequired

data.rebuild.duration_msinteger | nullrequired

data.rebuild.errorobject | nullrequired

Show child attributes

data.rebuild.error.codestringrequired

data.rebuild.error.messagestringnullrequired

data.rebuild.warningsstring[]required

data.rebuild.created_atstringrequired

ISO 8601, UTC.

data.rebuild.started_atstring | nullrequired

data.rebuild.finished_atstring | nullrequired

data.next_actionstringnullrequired

request_idstringrequired

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

{ "data": { "slug": "<string>", "hostname": "<string>", "url": "<string>", "previous_hostname": null, "redirects_until": null, "rebuild": { "id": "<string>", "site_id": "<string>", "revision": "<string>", "state": "queued", "target_origin": "<string>", "profile": "standard", "file_count": 123, "total_bytes": 123, "duration_ms": 123, "error": { "code": "<string>", "message": null }, "warnings": [ "<string>" ], "created_at": "<string>", "started_at": "<string>", "finished_at": "<string>" }, "next_action": null }, "request_id": "<string>" }

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

Website-Adresse ändern

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