sites

Modifier un texte où qu’il apparaisse

Recherche find dans les sources du site (fichiers de contenu et code, sous src/), le remplace par replace, crée UNE entrée dans l’historique et lance la génération. Renvoie 404 si le texte n’apparaît pas exactement ainsi, et 409 s’il apparaît plusieurs fois, sauf si path restreint la recherche ou si all vaut true. Le contenu JSON conserve son échappement et reste valide. Ne coûte aucun crédit ; modifie uniquement le brouillon.

POST/v1/sites/{site_id}/text:replace

Request

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

import json
import requests

url = "https://api.atelier201.com/v1/sites/<site_id>/text:replace"
headers = {
  "Authorization": "<api-key>",
  "Content-Type": "application/json"
}
payload = json.loads("{\"find\":\"<string>\",\"replace\":\"<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>/text:replace", {
  method: "POST",
  headers: {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "find": "<string>",
    "replace": "<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>/text:replace");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
    "Content-Type: application/json",
]);
curl_setopt($client, CURLOPT_POSTFIELDS, "{\"find\":\"<string>\",\"replace\":\"<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>/text:replace", bytes.NewBuffer([]byte("{\"find\":\"<string>\",\"replace\":\"<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>/text:replace"))
    .header("Authorization", "<api-key>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"find\":\"<string>\",\"replace\":\"<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>/text:replace")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "<api-key>"
request["Content-Type"] = "application/json"
request.body = "{\"find\":\"<string>\",\"replace\":\"<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": {
    "replaced": 123,
    "files": [
      {
        "path": "<string>",
        "occurrences": 123
      }
    ],
    "revision": "<string>",
    "parent": "<string>",
    "changed": true,
    "changes": [
      {
        "path": "<string>",
        "action": "<string>"
      }
    ],
    "build": {
      "id": "<string>",
      "state": "<string>",
      "next_action": "<string>"
    },
    "next_action": "<string>"
  },
  "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 sites:write. Ne coûte aucun crédit. Le chemin se termine par /text:replace. La modification ne concerne que le brouillon. Les visiteurs ne voient rien tant que vous n’avez pas publié.

La méthode la plus rapide pour modifier un texte visible sans savoir où il est écrit. Envoyez find, le texte tel qu’il apparaît sur la page, et replace, le nouveau texte. Atelier201 recherche dans les sources du site sous src/ (fichiers de contenu et code des pages), remplace le passage, ajoute une entrée à l’historique et lance la compilation. La réponse contient build avec son identifiant.

Introuvable (404). Le texte n’apparaît pas exactement ainsi. Un passage coupé par du balisage, par exemple un lien ou un mot en gras au milieu, ne constitue pas un seul texte. Envoyez un passage plus court.
Plusieurs occurrences (409). Affinez la recherche avec path (un fichier ou un motif glob), envoyez un passage plus long, ou définissez all: true pour modifier toutes les occurrences, par exemple un nouveau numéro de téléphone utilisé sur plusieurs pages.
Le contenu reste valide. Dans un fichier de contenu JSON, le texte est recherché et écrit avec l’échappement JSON, puis le fichier est analysé de nouveau avant toute sauvegarde.

Pour modifier un champ dont vous connaissez l’adresse, par exemple business:/tagline, utilisez Modifier un champ, qui effectue la même opération avec une validation selon le modèle de contenu.

Autorisations

Authorizationbearerin headerrequired

Paramètres de chemin

site_idstringrequired

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

Corps

application/jsonrequired

findstringrequiredlength: 1–2000 chars

Le texte à modifier, exactement comme il apparaît sur la page ou dans le fichier (majuscules et ponctuation comprises).

replacestringrequiredlength: ≤ 5000 chars

Le nouveau texte. Une valeur vide supprime le passage.

pathstringlength: ≤ 300 chars

Uniquement dans ce fichier (ou ce glob, par ex. src/pages/*.astro), si le texte apparaît à plusieurs endroits.

allboolean

Modifier toutes les occurrences (un produit renommé, un nouveau numéro de téléphone). Par défaut, refuse si le texte apparaît plusieurs fois.

summarystringlength: ≤ 200 chars

Une phrase pour l’historique. Par défaut : Modifier « ».

Réponse

application/json

Modifier un texte partout où il apparaît

dataobjectrequired

Show child attributes

data.replacedintegerrequiredrange: -9007199254740991–9007199254740991

Nombre d’occurrences modifiées.

data.filesobject[]required

Show child attributes

data.files.pathstringrequired

data.files.occurrencesintegerrequiredrange: -9007199254740991–9007199254740991

data.revisionstringrequiredlength: 40–40 chars

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

data.parentstring | nullrequired

data.changedbooleanrequired

data.changesobject[]required

Show child attributes

data.changes.pathstringrequired

data.changes.actionstringrequired

data.buildobject | nullrequired

La génération démarrée (ou rejointe) par cette modification : l’aperçu la suit. Aucun appel à build_site n’est nécessaire.

Show child attributes

data.build.idstringrequired

data.build.statestringrequired

data.build.next_actionstringrequired

data.next_actionstringrequired

request_idstringrequired

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

{ "data": { "replaced": 123, "files": [ { "path": "<string>", "occurrences": 123 } ], "revision": "<string>", "parent": "<string>", "changed": true, "changes": [ { "path": "<string>", "action": "<string>" } ], "build": { "id": "<string>", "state": "<string>", "next_action": "<string>" }, "next_action": "<string>" }, "request_id": "<string>" }

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

Modifier un texte où qu’il apparaisse

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