sites

Salvar várias entradas

Até 200 itens de várias coleções em um único registro no histórico: para uma importação ou limpeza. A validação é feita em conjunto: se um item for recusado, nada é gravado, e o erro 400 lista todos os itens que precisam ser corrigidos. Itens novos de coleções com um campo de rascunho começam como rascunhos.

POST/v1/sites/{site_id}/content:batch

Request

curl --request POST \
  --url 'https://api.atelier201.com/v1/sites/<site_id>/content:batch' \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "changes": [
    {
      "collection": "<string>",
      "slug": "<string>"
    }
  ]
}'

import json
import requests

url = "https://api.atelier201.com/v1/sites/<site_id>/content:batch"
headers = {
  "Authorization": "<api-key>",
  "Content-Type": "application/json"
}
payload = json.loads("{\"changes\":[{\"collection\":\"<string>\",\"slug\":\"<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>/content:batch", {
  method: "POST",
  headers: {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "changes": [
      {
        "collection": "<string>",
        "slug": "<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>/content:batch");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
    "Content-Type: application/json",
]);
curl_setopt($client, CURLOPT_POSTFIELDS, "{\"changes\":[{\"collection\":\"<string>\",\"slug\":\"<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>/content:batch", bytes.NewBuffer([]byte("{\"changes\":[{\"collection\":\"<string>\",\"slug\":\"<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>/content:batch"))
    .header("Authorization", "<api-key>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"changes\":[{\"collection\":\"<string>\",\"slug\":\"<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>/content:batch")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "<api-key>"
request["Content-Type"] = "application/json"
request.body = "{\"changes\":[{\"collection\":\"<string>\",\"slug\":\"<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": {
    "saved": 123.45,
    "deleted": 123.45
  },
  "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 /content:batch. Altera apenas o rascunho. Os visitantes não veem nada até você publicar.

Use para importar ou fazer uma limpeza. changes contém de 1 a 200 itens, cada um com collection e slug (letras minúsculas, números e hífens). Informe data para os campos e body para o Markdown de uma coleção de conteúdo (com até 500000 caracteres), ou delete: true para remover a entrada. summary, com até 200 caracteres, é a frase registrada no histórico.

O lote é validado por inteiro. Se uma alteração for rejeitada, nada é gravado, e a resposta 400 lista todas as entradas que precisam de correção para que você possa ajustar tudo de uma vez. Em caso de sucesso, é criada uma única entrada no histórico, e a resposta informa as quantidades saved e deleted. Uma nova entrada em uma coleção com campo de rascunho começa como rascunho.

Para alterar uma única entrada, use Criar ou atualizar uma entrada, que também oferece create_only e expected_hash.

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

summarystringlength: ≤ 200 chars

Uma frase para o histórico.

changesobject[]requireditems: 1–200 items

Show child attributes

changes.collectionstringrequired

changes.slugstringrequired

Letras minúsculas, dígitos e hífens.

changes.dataRecord<string, object>

Os campos, conforme definidos pelo esquema da coleção (não se aplica à exclusão).

changes.bodystringlength: ≤ 500000 chars

Corpo em Markdown, para coleções de conteúdo.

changes.deleteboolean

true para excluir esta entrada.

Resposta

application/json

Criar, atualizar ou excluir vários itens

dataRecord<string, object>required

Show child attributes

data.savednumberrequired

data.deletednumberrequired

request_idstringrequired

curl --request POST \ --url 'https://api.atelier201.com/v1/sites/<site_id>/content:batch' \ --header 'Authorization: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "changes": [ { "collection": "<string>", "slug": "<string>" } ] }'

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

Salvar várias entradas

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