sites

Alterar um texto onde quer que apareça

Procura find nos arquivos de conteúdo e no código do site, em src/, substitui por replace, registra UMA entrada no histórico e inicia a build. Retorna 404 quando o texto não aparece exatamente dessa forma e 409 quando aparece mais de uma vez, a menos que path restrinja a busca ou all seja true. O conteúdo JSON mantém os caracteres de escape e continua válido. Não consome créditos; altera apenas o rascunho.

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

Requer sites:write. Não custa créditos. O caminho termina em /text:replace. Altera apenas o rascunho. Os visitantes não veem nada até você publicar.

A maneira mais rápida de alterar um texto visível quando você não sabe onde ele está escrito. Envie find, o texto como aparece na página, e replace, o novo texto. O Atelier201 procura nas fontes do site em src/ (arquivos de conteúdo e código das páginas), substitui o trecho, registra uma única entrada no histórico e inicia a build: a resposta inclui build com o respectivo ID.

Não encontrado (404). O texto não está escrito exatamente dessa forma. Um trecho dividido por marcação, como um link ou uma palavra em negrito no meio, não constitui um único texto: envie um trecho menor.
Encontrado várias vezes (409). Restrinja a busca com path (um arquivo ou um glob), envie um trecho mais longo ou defina all: true para alterar todas as ocorrências, por exemplo, um novo número de telefone usado em várias páginas.
O conteúdo continua válido. Em um arquivo de conteúdo JSON, o texto é localizado e gravado com escape de JSON, e o arquivo é analisado novamente antes de qualquer gravação.

Para um campo cujo endereço você conhece, como business:/tagline, Alterar um campo faz o mesmo, com validação pelo modelo de conteúdo.

Autorizações

Authorizationbearerin headerrequired

Parâmetros de caminho

site_idstringrequired

O id do site ou seu slug (o endereço antes de .atelier201.page).

Corpo

application/jsonrequired

findstringrequiredlength: 1–2000 chars

O texto a ser alterado, exatamente como aparece na página ou no arquivo, incluindo maiúsculas, minúsculas e pontuação.

replacestringrequiredlength: ≤ 5000 chars

O novo texto. Se estiver vazio, o trecho será removido.

pathstringlength: ≤ 300 chars

Somente neste arquivo (ou glob, por exemplo, src/pages/*.astro), caso o texto apareça em vários arquivos.

allboolean

Altere todas as ocorrências (um produto renomeado, um novo número de telefone). Padrão: recusa quando o texto aparece mais de uma vez.

summarystringlength: ≤ 200 chars

Uma frase para o histórico. Padrão: Change "".

Resposta

application/json

Altere um texto onde quer que ele apareça

dataobjectrequired

Show child attributes

data.replacedintegerrequiredrange: -9007199254740991–9007199254740991

Quantidade de ocorrências alteradas.

data.filesobject[]required

Show child attributes

data.files.pathstringrequired

data.files.occurrencesintegerrequiredrange: -9007199254740991–9007199254740991

data.revisionstringrequiredlength: 40–40 chars

Um ID de commit do Git (40 caracteres hexadecimais) do repositório do site.

data.parentstring | nullrequired

data.changedbooleanrequired

data.changesobject[]required

Show child attributes

data.changes.pathstringrequired

data.changes.actionstringrequired

data.buildobject | nullrequired

A compilação iniciada (ou associada) por esta alteração: a prévia acompanha essa compilação. Não é necessário chamar 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>" }

Alterar um texto onde quer que apareça

Autorizações

Parâmetros de caminho

Corpo

Resposta

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies