sites

Cambiar un texto dondequiera que aparezca

Busca find en los archivos del sitio (archivos de contenido y código, en src/), lo sustituye por replace, registra UNA entrada en el historial e inicia la compilación. Devuelve 404 si el texto no aparece tal cual y 409 si aparece más de una vez, salvo que path limite la búsqueda o all sea true. El contenido JSON conserva sus caracteres de escape y sigue siendo válido. No consume créditos: solo modifica el borrador.

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

Requiere sites:write. No consume créditos. La ruta termina en /text:replace. Los cambios solo afectan al borrador. Los visitantes no verán nada hasta que publiques.

La forma más rápida de cambiar un texto visible si no sabes dónde está escrito. Envía find con el texto tal como aparece en la página y replace con el texto nuevo. Atelier201 busca en las fuentes del sitio dentro de src/ (archivos de contenido y código de las páginas), sustituye el fragmento, crea una entrada en el historial e inicia la compilación. La respuesta incluye build con su identificador.

No se encuentra (404). El texto no aparece exactamente así. Si un fragmento está dividido por marcado, como un enlace o una palabra en negrita en medio, no cuenta como un solo texto: envía un fragmento más corto.
Se encuentra varias veces (409). Acota la búsqueda con path (un archivo o un patrón glob), envía un fragmento más largo o establece all: true para cambiar todas las apariciones, por ejemplo, un número de teléfono nuevo que se usa en varias páginas.
El contenido sigue siendo válido. En un archivo de contenido JSON, el texto se busca y se escribe con el escape correspondiente a JSON. Después, el archivo se vuelve a analizar antes de guardar nada.

Si conoces la dirección de un campo, como business:/tagline, Cambiar un campo hace lo mismo y valida el resultado con el modelo de contenido.

Autorizaciones

Authorizationbearerin headerrequired

Parámetros de ruta

site_idstringrequired

El ID del sitio o su slug (la dirección antes de .atelier201.page).

Cuerpo

application/jsonrequired

findstringrequiredlength: 1–2000 chars

El texto que quieres cambiar, exactamente como aparece en la página o el archivo (incluidas mayúsculas, minúsculas y puntuación).

replacestringrequiredlength: ≤ 5000 chars

El texto nuevo. Si está vacío, se elimina el fragmento.

pathstringlength: ≤ 300 chars

Solo en este archivo (o patrón glob, p. ej., src/pages/*.astro), si el texto aparece en varios.

allboolean

Cambiar todas las apariciones (un producto con otro nombre, un número de teléfono nuevo). Valor predeterminado: rechazar la operación si el texto aparece más de una vez.

summarystringlength: ≤ 200 chars

Una frase para el historial. Valor predeterminado: Change "".

Respuesta

application/json

Cambiar un texto donde aparezca

dataobjectrequired

Show child attributes

data.replacedintegerrequiredrange: -9007199254740991–9007199254740991

Número de apariciones modificadas.

data.filesobject[]required

Show child attributes

data.files.pathstringrequired

data.files.occurrencesintegerrequiredrange: -9007199254740991–9007199254740991

data.revisionstringrequiredlength: 40–40 chars

Un ID de commit de Git (40 caracteres hexadecimales) del repositorio del sitio.

data.parentstring | nullrequired

data.changedbooleanrequired

data.changesobject[]required

Show child attributes

data.changes.pathstringrequired

data.changes.actionstringrequired

data.buildobject | nullrequired

La compilación que inició este cambio (o a la que se incorporó): la vista previa la sigue. No hace falta llamar a 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>" }

Cambiar un texto dondequiera que aparezca

Autorizaciones

Parámetros de ruta

Cuerpo

Respuesta

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies