files

Modifier des fichiers

Applique les opérations put, delete et move en UNE seule entrée d’historique. Chaque opération peut inclure le expected_hash que vous avez lu ; si un fichier a été modifié depuis, une erreur 409 est renvoyée avec la révision actuelle et aucune modification n’est écrite. Pour les textes, les entrées et les informations métier, privilégiez les endpoints de contenu : ils valident les données selon le modèle de contenu du site et ne peuvent pas en casser la mise en page.

POST/v1/sites/{site_id}/commits

Request

curl --request POST \
  --url 'https://api.atelier201.com/v1/sites/<site_id>/commits' \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "summary": "<string>",
  "operations": [
    {
      "op": "<string>",
      "path": "<string>",
      "content": "<string>"
    }
  ]
}'

import json
import requests

url = "https://api.atelier201.com/v1/sites/<site_id>/commits"
headers = {
  "Authorization": "<api-key>",
  "Content-Type": "application/json"
}
payload = json.loads("{\"summary\":\"<string>\",\"operations\":[{\"op\":\"<string>\",\"path\":\"<string>\",\"content\":\"<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>/commits", {
  method: "POST",
  headers: {
    "Authorization": "<api-key>",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "summary": "<string>",
    "operations": [
      {
        "op": "<string>",
        "path": "<string>",
        "content": "<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>/commits");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
    "Content-Type: application/json",
]);
curl_setopt($client, CURLOPT_POSTFIELDS, "{\"summary\":\"<string>\",\"operations\":[{\"op\":\"<string>\",\"path\":\"<string>\",\"content\":\"<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>/commits", bytes.NewBuffer([]byte("{\"summary\":\"<string>\",\"operations\":[{\"op\":\"<string>\",\"path\":\"<string>\",\"content\":\"<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>/commits"))
    .header("Authorization", "<api-key>")
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"summary\":\"<string>\",\"operations\":[{\"op\":\"<string>\",\"path\":\"<string>\",\"content\":\"<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>/commits")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "<api-key>"
request["Content-Type"] = "application/json"
request.body = "{\"summary\":\"<string>\",\"operations\":[{\"op\":\"<string>\",\"path\":\"<string>\",\"content\":\"<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": {
    "revision": "<string>",
    "parent": "<string>",
    "changed": true,
    "changes": [
      {
        "path": "<string>",
        "action": "<string>"
      }
    ],
    "build": {
      "id": "<string>",
      "state": "<string>",
      "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>"
}

Nécessite sites:write. Ne consomme aucun crédit. Modifie uniquement le brouillon. Les visiteurs ne verront rien tant que vous n’aurez pas publié.

Utilisez ce point de terminaison pour modifier le code : une mise en page, un composant ou le modèle de contenu. Pour les textes, les entrées et les informations de l’entreprise, utilisez les points de terminaison de contenu : ils valident les modifications par rapport au modèle de contenu et ne peuvent pas casser la mise en page.

Éviter d’écraser les modifications d’une autre personne

Indiquez le hash que vous avez lu dans expected_hash pour chaque opération. Si l’un des fichiers a été modifié depuis, l’ensemble de la modification est refusé avec une erreur 409 conflict et rien n’est écrit. L’erreur details contient la révision actuelle :

JSON{
  "error": {
    "code": "conflict",
    "details": {
      "reason": "revision_conflict",
      "current_revision": "9f2c...",
      "paths": [
        { "path": "src/pages/index.astro", "expected": "a1b2...", "found": "c3d4..." }
      ]
    }
  },
  "request_id": "req_01K9X7"
}

Relisez les fichiers répertoriés dans paths (chacun indique le hachage attendu et celui trouvé), appliquez votre modification par-dessus, puis réessayez. base_revision indique la révision que vous avez lue : la modification s’applique toujours si les fichiers concernés n’ont pas changé.

Gardez le site en Astro statique : pas d’adaptateur serveur ni de rendu côté serveur.

Autorisations

Authorizationbearerin headerrequired

Paramètres de chemin

site_idstringrequired

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

Corps

application/jsonrequired

summarystringrequiredlength: 1–500 chars

Ce que fait la modification, en une phrase : le texte de l’entrée d’historique que les utilisateurs consultent.

base_revisionstringlength: 40–40 chars

La révision que vous avez consultée. La modification est appliquée si les fichiers concernés n’ont pas changé depuis. Sinon, une réponse 409 indique la révision actuelle.

operationsobject | object | object[]requireditems: 1–500 items

Show child attributes

operations.opstringrequired

operations.pathstringrequiredlength: 1–600 chars

operations.contentstringrequired

operations.encodingenum<string>one of: utf8, base64

operations.expected_hashstringnull

Le hachage que vous avez consulté (null : le fichier ne doit pas encore exister). En cas de différence, toute la modification est rejetée.

Réponse

application/json

Modifier des fichiers (un seul commit)

dataobjectrequired

Show child attributes

data.revisionstringrequiredlength: 40–40 chars

Un identifiant de commit Git (40 caractères hexadécimaux) du dépôt du site.

data.parentstring | nullrequired

data.changedbooleanrequired

data.changesobject[]required

Show child attributes

data.changes.pathstringrequired

data.changes.actionstringrequired

data.buildobject | nullrequired

La génération démarrée (ou rejointe) par cette modification : l’aperçu la suit. Aucun appel à build_site n’est nécessaire.

Show child attributes

data.build.idstringrequired

data.build.statestringrequired

data.build.next_actionstringrequired

request_idstringrequired

curl --request POST \ --url 'https://api.atelier201.com/v1/sites/<site_id>/commits' \ --header 'Authorization: <api-key>' \ --header 'Content-Type: application/json' \ --data '{ "summary": "<string>", "operations": [ { "op": "<string>", "path": "<string>", "content": "<string>" } ] }'

{ "data": { "revision": "<string>", "parent": "<string>", "changed": true, "changes": [ { "path": "<string>", "action": "<string>" } ], "build": { "id": "<string>", "state": "<string>", "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>" }

Modifier des fichiers

Éviter d’écraser les modifications d’une autre personne

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