domains

Modifier l’adresse du site

Déplace le site vers .atelier201.page. L’adresse doit être disponible. L’ancienne adresse redirige ici pendant 30 jours (les visiteurs conservent leurs liens) et seul ce site peut la récupérer pendant cette période. Les liens d’aperçu existants restent fonctionnels. Si l’adresse principale d’un site en ligne est modifiée, une nouvelle génération est lancée. Publiez-la pour terminer. Aucun crédit.

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

Nécessite domains:write et un administrateur de l’espace de travail.

L’ancienne adresse redirige pendant 30 jours. Pendant ce délai, seul ce site peut la récupérer. Les liens canoniques et le plan du site sont générés au moment de la compilation. Un site en ligne qui utilise cette adresse comme adresse principale doit donc être recompilé. Publiez cette compilation pour terminer. La réponse le précise dans next_action.

Autorisations

Authorizationbearerin headerrequired

Paramètres de chemin

site_idstringrequired

L’identifiant du site ou son slug (l’adresse avant .atelier201.page).

Corps

application/jsonrequired

slugstringrequiredlength: 3–40 chars

La nouvelle adresse : .atelier201.page. De 3 à 40 lettres minuscules, chiffres ou traits d’union isolés.

Réponse

application/json

Modifier l’adresse atelier201.page du site

dataobjectrequired

Show child attributes

data.slugstringrequired

data.hostnamestringrequired

data.urlstringrequired

data.previous_hostnamestringnullrequired

L’adresse abandonnée. Null si le site utilisait déjà cette adresse.

data.redirects_untilstringnullrequired

Date de fin de la redirection de l’ancienne adresse vers celle-ci. Null si le site n’a jamais été publié : il n’avait aucun visiteur à rediriger.

data.rebuildobject | nullrequired

Show child attributes

data.rebuild.idstringrequired

data.rebuild.site_idstringrequired

data.rebuild.revisionstringrequiredlength: 40–40 chars

Un identifiant de commit Git (40 caractères hexadécimaux) du dépôt du site.

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

Modifier l’adresse du site

Autorisations

Paramètres de chemin

Corps

Réponse

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies