content

Criar ou atualizar uma entrada

Primeiro, os dados são validados com base no esquema da coleção: um campo inválido gera um erro 400 que identifica o campo, e nada é gravado. Um item novo criado pela API começa como rascunho quando a coleção tem um campo de rascunho. Um registro no histórico.

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

Requer sites:write. Não custa créditos. Altera apenas o rascunho. Os visitantes não veem nada até você publicar.

Um campo inválido é rejeitado com 400 e o nome do campo, e nada é gravado. Se a coleção tiver um campo de rascunho, uma nova entrada começa como rascunho, para que alguém decida publicá-la.

Envie create_only: true para rejeitar a solicitação em vez de sobrescrever uma entrada existente, ou expected_hash para sobrescrever somente a versão que você leu.

Autorizações

Authorizationbearerin headerrequired

Parâmetros de caminho

site_idstringrequired

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

collectionstringrequired

slugstringrequired

Corpo

application/jsonrequired

dataRecord<string, object>required

Os campos do item, conforme definidos pelo esquema da coleção (get_content_model).

bodystringlength: ≤ 500000 chars

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

expected_hashstringnull

create_onlyboolean

Recusar a gravação em vez de sobrescrever quando o item já existe.

Resposta

application/json

Criar ou atualizar um item

dataRecord<string, object>required

Show child attributes

data.collectionstringrequired

data.slugstringrequired

data.pathstringrequired

data.createdbooleanrequired

data.draftbooleanrequired

data.revisionstringrequiredlength: 40–40 chars

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

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

Criar ou atualizar uma entrada

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