sites

Modificare un testo ovunque sia presente

Cerca find nelle sorgenti del sito (file di contenuto e codice, in src/), lo sostituisce con replace, registra UNA voce nella cronologia e avvia la build. Restituisce 404 se il testo non è presente esattamente così e 409 se compare più di una volta, a meno che path non restringa la ricerca o all sia true. Il contenuto JSON mantiene gli escape ed è valido. Non costa crediti: modifica solo la bozza.

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

Richiede sites:write. Non costa crediti. Il percorso termina con /text:replace. Modifica solo la bozza. I visitatori non vedranno nulla finché non pubblicherai.

Il modo più rapido per modificare un testo visibile quando non sai dove si trova. Invia find, il testo così come appare nella pagina, e replace, il nuovo testo. Atelier201 cerca nei sorgenti del sito in src/ (file di contenuto e codice delle pagine), sostituisce il passaggio, registra un’unica voce nella cronologia e avvia la build: la risposta include build con il relativo ID.

Non trovato (404). Il testo non è presente esattamente in questa forma. Un passaggio diviso dal markup, ad esempio da un link o da una parola in grassetto al suo interno, non costituisce un unico testo: invia un passaggio più breve.
Trovato più volte (409). Restringi la ricerca con path (un file o un glob), invia un passaggio più lungo oppure imposta all: true per modificare tutte le occorrenze, ad esempio un nuovo numero di telefono usato in più pagine.
Il contenuto resta valido. In un file di contenuto JSON, il testo viene cercato e scritto con l’escape JSON; prima di salvare, il file viene nuovamente analizzato.

Per modificare un campo di cui conosci l’indirizzo, ad esempio business:/tagline, usa Modificare un campo: applica la validazione rispetto al modello dei contenuti.

Autorizzazioni

Authorizationbearerin headerrequired

Parametri di percorso

site_idstringrequired

L'ID del sito o il suo slug (l'indirizzo prima di .atelier201.page).

Corpo

application/jsonrequired

findstringrequiredlength: 1–2000 chars

Il testo da modificare, esattamente come appare nella pagina o nel file (incluse maiuscole, minuscole e punteggiatura).

replacestringrequiredlength: ≤ 5000 chars

Il nuovo testo. Se vuoto, il passaggio viene rimosso.

pathstringlength: ≤ 300 chars

Solo in questo file (o glob, ad es. src/pages/*.astro), se il testo compare in più file.

allboolean

Modifica ogni occorrenza (un prodotto rinominato, un nuovo numero di telefono). Valore predefinito: rifiuta la modifica se il testo compare più di una volta.

summarystringlength: ≤ 200 chars

Una frase da inserire nella cronologia. Predefinita: Change "".

Risposta

application/json

Modifica un testo ovunque sia presente

dataobjectrequired

Show child attributes

data.replacedintegerrequiredrange: -9007199254740991–9007199254740991

Numero di occorrenze modificate.

data.filesobject[]required

Show child attributes

data.files.pathstringrequired

data.files.occurrencesintegerrequiredrange: -9007199254740991–9007199254740991

data.revisionstringrequiredlength: 40–40 chars

ID di un commit Git (40 caratteri esadecimali) del repository del sito.

data.parentstring | nullrequired

data.changedbooleanrequired

data.changesobject[]required

Show child attributes

data.changes.pathstringrequired

data.changes.actionstringrequired

data.buildobject | nullrequired

La build avviata (o a cui si è unita) questa modifica: l'anteprima la segue. Non serve chiamare build_site.

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

Modificare un testo ovunque sia presente

Autorizzazioni

Parametri di percorso

Corpo

Risposta

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookie