builds

Leggi una pagina generata

Una pagina della build, così come la leggerebbe un visitatore, per un agente senza browser: titolo, descrizione, intestazioni, link, testo visibile e issues che emergerebbero da un controllo rapido (assenza di h1, immagini senza alt, testo segnaposto). Valore predefinito: la home page della build pronta più recente della bozza. Se hai un browser, getSiteBuild con preview=true restituisce invece un link per visualizzarla.

GET/v1/sites/{site_id}/pages

Request

curl --request GET \
  --url 'https://api.atelier201.com/v1/sites/<site_id>/pages' \
  --header 'Authorization: <api-key>'

import json
import requests

url = "https://api.atelier201.com/v1/sites/<site_id>/pages"
headers = {
  "Authorization": "<api-key>"
}

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

const response = await fetch("https://api.atelier201.com/v1/sites/<site_id>/pages", {
  method: "GET",
  headers: {
    "Authorization": "<api-key>"
  },
});

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>/pages");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "GET");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Authorization: <api-key>",
]);
curl_setopt($client, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($client);
curl_close($client);
echo $response;

package main

import (
  "fmt"
  "io"
  "net/http"
)

func main() {
  req, _ := http.NewRequest("GET", "https://api.atelier201.com/v1/sites/<site_id>/pages", nil)
  req.Header.Set("Authorization", "<api-key>")
  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>/pages"))
    .header("Authorization", "<api-key>")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .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>/pages")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "<api-key>"

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": {
    "build_id": "<string>",
    "revision": "<string>",
    "path": "<string>",
    "status": 123,
    "location": "<string>",
    "pages": [
      "<string>"
    ],
    "title": null,
    "description": null,
    "lang": null,
    "headings": [
      {
        "level": 123,
        "text": "<string>"
      }
    ],
    "links": [
      {
        "href": "<string>",
        "text": "<string>"
      }
    ],
    "images_without_alt": [
      "<string>"
    ],
    "og_image": null,
    "structured_data": [
      "<string>"
    ],
    "broken_targets": [
      "<string>"
    ],
    "text": "<string>",
    "text_truncated": true,
    "issues": [
      "<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:read. Non modifica nulla.

Restituisce il titolo, la descrizione, le intestazioni, i link e il testo visibile della pagina, le altre pages della build e i problemi issues che emergerebbero da un controllo rapido: assenza di <title> o h1, più elementi h1, immagini senza alt, link senza testo e testo segnaposto. Valore predefinito: / della build più recente dello stato bozza pronta.

Se hai un browser, Recupera una build con preview=true restituisce un link privato per visualizzare la pagina.

Autorizzazioni

Authorizationbearerin headerrequired

Parametri di percorso

site_idstringrequired

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

Parametri di query

pathstringlength: ≤ 600 chars

La pagina, nel formato che un visitatore inserirebbe: / o /about. Valore predefinito: /.

build_idstring<uuid>pattern: ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$

Una build. Valore predefinito: la build pronta più recente della bozza (quella mostrata nell'anteprima).

Risposta

application/json

Leggi una pagina compilata

dataobjectrequired

Show child attributes

data.build_idstringrequired

data.revisionstringrequiredlength: 40–40 chars

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

data.pathstringrequired

data.statusintegerrequiredrange: -9007199254740991–9007199254740991

200, 404 (la pagina di errore 404 del sito, se presente) oppure il codice di stato del reindirizzamento.

data.locationstring

Destinazione del reindirizzamento.

data.pagesstring[]required

Tutte le pagine della build, per leggere le altre.

data.titlestringnull

data.descriptionstringnull

data.langstringnull

data.headingsobject[]

Show child attributes

data.headings.levelintegerrequiredrange: -9007199254740991–9007199254740991

data.headings.textstringrequired

data.linksobject[]

Show child attributes

data.links.hrefstringrequired

data.links.textstringrequired

data.images_without_altstring[]

data.og_imagestringnull

L'immagine mostrata da un link condiviso alla pagina (og:image), oppure null.

data.structured_datastring[]

I tipi schema.org dichiarati dalla pagina in JSON-LD (LocalBusiness, Article...).

data.broken_targetsstring[]

Link interni e file (immagini, fogli di stile, script) usati dalla pagina ma assenti nella build.

data.textstring

Il testo visibile del contenuto principale della pagina, fino a un massimo di 20,000 caratteri.

data.text_truncatedboolean

data.issuesstring[]

Problemi che emergerebbero da un controllo rapido: titolo o h1 assente, più h1, immagini senza alt, link senza testo, testo segnaposto.

request_idstringrequired

{ "data": { "build_id": "<string>", "revision": "<string>", "path": "<string>", "status": 123, "location": "<string>", "pages": [ "<string>" ], "title": null, "description": null, "lang": null, "headings": [ { "level": 123, "text": "<string>" } ], "links": [ { "href": "<string>", "text": "<string>" } ], "images_without_alt": [ "<string>" ], "og_image": null, "structured_data": [ "<string>" ], "broken_targets": [ "<string>" ], "text": "<string>", "text_truncated": true, "issues": [ "<string>" ] }, "request_id": "<string>" }

{ "error": { "type": "<string>", "code": "<string>", "message": "<string>", "param": "<string>", "docs_url": "<string>", "action_url": "<string>", "details": {} }, "request_id": "<string>" }

Leggi una pagina generata

Autorizzazioni

Parametri di percorso

Parametri di query

Risposta

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookie