sites

Enregistrer plusieurs entrées

Jusqu’à 200 entrées de plusieurs collections dans une seule entrée d’historique : pour un import ou un nettoyage. La validation porte sur l’ensemble : si une entrée est refusée, aucune donnée n’est écrite et la réponse 400 répertorie toutes les entrées à corriger. Les nouvelles entrées des collections comportant un champ de brouillon sont créées en tant que brouillons.

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

Nécessite sites:write. Ne coûte aucun crédit. Le chemin se termine par /content:batch. La modification ne concerne que le brouillon. Les visiteurs ne voient rien tant que vous n’avez pas publié.

Pour un import ou un nettoyage. changes contient de 1 à 200 éléments, chacun avec un collection et un slug (lettres minuscules, chiffres et traits d’union). Indiquez data pour les champs et body pour le Markdown d’une collection de contenu (500000 caractères maximum), ou delete: true pour supprimer l’entrée. summary, limité à 200 caractères, correspond à la phrase affichée dans l’historique.

Le lot est validé dans son ensemble. Si une modification est refusée, rien n’est écrit et le 400 répertorie toutes les entrées à corriger, afin que vous puissiez tout rectifier en une seule fois. En cas de réussite, une seule entrée est ajoutée à l’historique et la réponse indique le nombre d’entrées saved et deleted. Dans une collection comportant un champ de brouillon, une nouvelle entrée est créée en tant que brouillon.

Pour modifier une seule entrée, utilisez Créer ou modifier une entrée, qui propose également create_only et expected_hash.

Autorisations

Authorizationbearerin headerrequired

Paramètres de chemin

site_idstringrequired

L’identifiant du site ou son slug (l’adresse avant .atelier201.page).

Corps

application/jsonrequired

summarystringlength: ≤ 200 chars

Une phrase pour l’historique.

changesobject[]requireditems: 1–200 items

Show child attributes

changes.collectionstringrequired

changes.slugstringrequired

Lettres minuscules, chiffres et traits d’union.

changes.dataRecord<string, object>

Les champs définis par le schéma de la collection (à omettre en cas de suppression).

changes.bodystringlength: ≤ 500000 chars

Corps en Markdown, pour les collections de contenu.

changes.deleteboolean

true pour supprimer cette entrée.

Réponse

application/json

Créer, mettre à jour ou supprimer plusieurs entrées

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

Enregistrer plusieurs entrées

Autorisations

Paramètres de chemin

Corps

Réponse

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies