sites

Viele Einträge speichern

Bis zu 200 Einträge aus mehreren Collections in einem Verlaufseintrag: für einen Import oder eine Bereinigung. Die Validierung erfolgt als Ganzes: Wird ein Eintrag abgelehnt, wird nichts geschrieben und der 400-Fehler listet alle zu korrigierenden Einträge auf. Neue Einträge in Collections mit einem Entwurfsfeld beginnen als Entwürfe.

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

Erfordert sites:write. Kostet keine Credits. Der Pfad endet mit /content:batch. Änderungen betreffen nur den Entwurf. Besucher sehen sie erst, wenn Sie veröffentlichen.

Für einen Import oder zum Aufräumen. changes enthält 1 bis 200 Elemente, jeweils mit collection und slug (Kleinbuchstaben, Ziffern und Bindestriche). Geben Sie data für die Felder und bei einer Inhaltssammlung body für den Markdown-Text an (höchstens 500000 Zeichen) oder setzen Sie delete: true, um den Eintrag zu entfernen. summary darf höchstens 200 Zeichen lang sein und wird als Beschreibung im Verlauf angezeigt.

Der gesamte Stapel wird gemeinsam validiert. Wird eine Änderung abgelehnt, wird nichts geschrieben. Die Antwort 400 listet alle zu korrigierenden Einträge auf, damit Sie sie in einem Durchgang berichtigen können. Bei Erfolg entsteht ein Verlaufseintrag, und die Antwort enthält die Anzahl unter saved und deleted. Ein neuer Eintrag in einer Sammlung mit einem Entwurfsfeld wird zunächst als Entwurf angelegt.

Um einen einzelnen Eintrag zu ändern, verwenden Sie Eintrag erstellen oder aktualisieren. Dort stehen auch create_only und expected_hash zur Verfügung.

Autorisierung

Authorizationbearerin headerrequired

Pfadparameter

site_idstringrequired

ID der Website oder ihr Slug (die Adresse vor .atelier201.page).

Body

application/jsonrequired

summarystringlength: ≤ 200 chars

Ein Satz für den Änderungsverlauf.

changesobject[]requireditems: 1–200 items

Show child attributes

changes.collectionstringrequired

changes.slugstringrequired

Kleinbuchstaben, Ziffern und Bindestriche.

changes.dataRecord<string, object>

Felder gemäß dem Schema der Collection (nicht bei delete).

changes.bodystringlength: ≤ 500000 chars

Markdown-Text für Content-Collections.

changes.deleteboolean

true, um diesen Eintrag zu löschen.

Antwort

application/json

Mehrere Einträge erstellen, aktualisieren oder löschen

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

Viele Einträge speichern

Autorisierung

Pfadparameter

Body

Antwort

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies