content

Creare o aggiornare una voce

Prima viene convalidata in base allo schema della raccolta: un campo non valido genera un errore 400 che indica il campo e non viene scritto nulla. Una nuova voce creata tramite API è inizialmente una bozza se la raccolta ha un campo bozza. Una voce nella cronologia.

PUT/v1/sites/{site_id}/content/{collection}/{slug}

Request

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

import json
import requests

url = "https://api.atelier201.com/v1/sites/<site_id>/content/<collection>/<slug>"
headers = {
  "Authorization": "<api-key>",
  "Content-Type": "application/json"
}
payload = json.loads("{\"data\":{}}")

response = requests.request("PUT", url, headers=headers, json=payload)
print(response.json())

const response = await fetch("https://api.atelier201.com/v1/sites/<site_id>/content/<collection>/<slug>", {
  method: "PUT",
  headers: {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "data": {}
  }),
});

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/<collection>/<slug>");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "PUT");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
    "Content-Type: application/json",
]);
curl_setopt($client, CURLOPT_POSTFIELDS, "{\"data\":{}}");
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("PUT", "https://api.atelier201.com/v1/sites/<site_id>/content/<collection>/<slug>", bytes.NewBuffer([]byte("{\"data\":{}}")))
  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/<collection>/<slug>"))
    .header("Authorization", "<api-key>")
    .header("Content-Type", "application/json")
    .method("PUT", HttpRequest.BodyPublishers.ofString("{\"data\":{}}"))
    .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/<collection>/<slug>")
request = Net::HTTP::Put.new(uri)
request["Authorization"] = "<api-key>"
request["Content-Type"] = "application/json"
request.body = "{\"data\":{}}"

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": {
    "collection": "<string>",
    "slug": "<string>",
    "path": "<string>",
    "created": true,
    "draft": true,
    "revision": "<string>",
    "changed": true,
    "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>"
}

Richiede sites:write. Non costa crediti. Modifica solo la bozza. I visitatori non vedranno nulla finché non pubblicherai.

Un campo non valido viene rifiutato con 400 e il nome del campo; non viene scritto nulla. Se la raccolta ha un campo bozza, una nuova voce viene creata come bozza, così una persona può decidere se pubblicarla.

Invia create_only: true per rifiutare la richiesta anziché sovrascrivere una voce esistente, oppure expected_hash per sovrascrivere solo la versione che hai letto.

Autorizzazioni

Authorizationbearerin headerrequired

Parametri di percorso

site_idstringrequired

L'ID del sito o il suo slug (l'indirizzo prima di .atelier201.page).

collectionstringrequired

slugstringrequired

Corpo

application/jsonrequired

dataRecord<string, object>required

I campi della voce, secondo la definizione dello schema della raccolta (get_content_model).

bodystringlength: ≤ 500000 chars

Corpo in Markdown, per le raccolte di contenuti.

expected_hashstringnull

create_onlyboolean

Rifiuta l'operazione invece di sovrascrivere la voce, se esiste già.

Risposta

application/json

Crea o aggiorna una voce

dataRecord<string, object>required

Show child attributes

data.collectionstringrequired

data.slugstringrequired

data.pathstringrequired

data.createdbooleanrequired

data.draftbooleanrequired

data.revisionstringrequiredlength: 40–40 chars

ID di un commit Git (40 caratteri esadecimali) del repository del sito.

data.changedbooleanrequired

data.next_actionstringrequired

request_idstringrequired

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

{ "data": { "collection": "<string>", "slug": "<string>", "path": "<string>", "created": true, "draft": true, "revision": "<string>", "changed": true, "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>" }

Creare o aggiornare una voce

Autorizzazioni

Parametri di percorso

Corpo

Risposta

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookie