sites

Einen Text überall dort ändern, wo er vorkommt

Sucht find in den Quellen der Website (Inhaltsdateien und Code unter src/) und ersetzt es durch replace. Dabei wird EIN Verlaufseintrag erstellt und der Build gestartet. Wird mit 404 abgelehnt, wenn der Text nicht genau so geschrieben ist, und mit 409, wenn er mehrmals vorkommt, es sei denn, path schränkt die Suche ein oder all ist true. JSON-Inhalte behalten ihre Escape-Sequenzen und bleiben gültig. Kostet keine Credits. Ändert nur den Entwurf.

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

Erfordert sites:write. Kostet keine Credits. Der Pfad endet mit /text:replace. Änderungen betreffen nur den Entwurf. Besucher sehen sie erst, wenn Sie veröffentlichen.

Der schnellste Weg, sichtbaren Text zu ändern, wenn Sie nicht wissen, wo er geschrieben steht. Senden Sie find mit dem Text, wie er auf der Seite erscheint, und replace mit dem neuen Text. Atelier201 durchsucht die Quellen der Website unter src/ (Inhaltsdateien und Seitencode), ersetzt die Passage, speichert einen Verlaufseintrag und startet den Build. Die Antwort enthält build mit dessen ID.

Nicht gefunden (404). Der Text steht nicht genau so dort. Eine durch Markup unterbrochene Passage, etwa durch einen Link oder ein hervorgehobenes Wort in der Mitte, ist kein zusammenhängender Text. Senden Sie eine kürzere Passage.
Mehrfach gefunden (409). Grenzen Sie die Suche mit path ein (Datei oder Glob), senden Sie eine längere Passage oder setzen Sie all: true, um alle Vorkommen zu ändern, zum Beispiel eine neue Telefonnummer, die auf mehreren Seiten steht.
Inhalte bleiben gültig. In einer JSON-Inhaltsdatei wird der Text mit JSON-Escaping gesucht und geschrieben. Vor dem Speichern wird die Datei erneut geparst.

Wenn Sie die Adresse eines Felds kennen, etwa business:/tagline, verwenden Sie Ein Feld ändern. Dabei wird der Wert anhand des Inhaltsmodells validiert.

Autorisierung

Authorizationbearerin headerrequired

Pfadparameter

site_idstringrequired

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

Body

application/jsonrequired

findstringrequiredlength: 1–2000 chars

Der zu ändernde Text, genau so, wie er auf der Seite oder in der Datei steht (einschließlich Groß- und Kleinschreibung sowie Satzzeichen).

replacestringrequiredlength: ≤ 5000 chars

Der neue Text. Ein leerer Wert entfernt die Passage.

pathstringlength: ≤ 300 chars

Nur in dieser Datei (oder diesem Glob, z. B. src/pages/*.astro), wenn der Text mehrfach vorkommt.

allboolean

Alle Vorkommen ändern (etwa bei einem umbenannten Produkt oder einer neuen Telefonnummer). Standard: Ablehnen, wenn der Text mehrmals vorkommt.

summarystringlength: ≤ 200 chars

Ein Satz für den Verlauf. Standard: Change "".

Antwort

application/json

Einen Text überall ändern, wo er vorkommt

dataobjectrequired

Show child attributes

data.replacedintegerrequiredrange: -9007199254740991–9007199254740991

Anzahl der geänderten Vorkommen.

data.filesobject[]required

Show child attributes

data.files.pathstringrequired

data.files.occurrencesintegerrequiredrange: -9007199254740991–9007199254740991

data.revisionstringrequiredlength: 40–40 chars

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

data.parentstring | nullrequired

data.changedbooleanrequired

data.changesobject[]required

Show child attributes

data.changes.pathstringrequired

data.changes.actionstringrequired

data.buildobject | nullrequired

Der Build, den diese Änderung gestartet oder übernommen hat: Die Vorschau folgt diesem Build. Kein Aufruf von build_site erforderlich.

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

Einen Text überall dort ändern, wo er vorkommt

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