guest

Preparar um site antes do cadastro

Para um agente que trabalha para alguém que ainda não tem uma conta. Cria um site a partir do starter e retorna um token de gravação (2 horas: importar arquivos e compilar, 3 compilações) e um URL privado de reivindicação (7 dias), que a pessoa acessa para tornar o site seu. A demonstração gerada é servida em sandbox, nunca é indexada e não pode ser publicada nem associada a um domínio antes da reivindicação. Sem créditos, sem IA.

POST/v1/guest/sites

Request

curl --request POST \
  --url 'https://api.atelier201.com/v1/guest/sites' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>"
}'

import json
import requests

url = "https://api.atelier201.com/v1/guest/sites"
headers = {
  "Content-Type": "application/json"
}
payload = json.loads("{\"name\":\"<string>\"}")

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

const response = await fetch("https://api.atelier201.com/v1/guest/sites", {
  method: "POST",
  headers: {
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "name": "<string>"
  }),
});

const data = await response.json();
console.log(data);

<?php
$client = curl_init();

curl_setopt($client, CURLOPT_URL, "https://api.atelier201.com/v1/guest/sites");
curl_setopt($client, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($client, CURLOPT_HTTPHEADER, [
    "Content-Type: application/json",
]);
curl_setopt($client, CURLOPT_POSTFIELDS, "{\"name\":\"<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/guest/sites", bytes.NewBuffer([]byte("{\"name\":\"<string>\"}")))
  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/guest/sites"))
    .header("Content-Type", "application/json")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"name\":\"<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/guest/sites")
request = Net::HTTP::Post.new(uri)
request["Content-Type"] = "application/json"
request.body = "{\"name\":\"<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": {
    "site_id": "<string>",
    "address": "<string>",
    "write_token": "<string>",
    "write_expires_at": "<string>",
    "claim_url": "<string>",
    "claim_expires_at": "<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ão é necessária uma credencial bearer. Quem faz a chamada é anônimo e está sujeito a limites de requisições por endereço.

A resposta contém write_token (2 horas), claim_url (7 dias) e next_action. Passe device_code e client_id de uma solicitação de dispositivo OAuth se quiser que a pessoa possa conectar o agente ao reivindicar o site. Leia as instruções do agente para ver o fluxo completo.

Nada pode ser publicado, nenhum domínio é conectado, nenhum crédito é gasto e nenhum modelo é chamado. Mantenha o token de escrita e o link de reivindicação em sigilo: consulte Sites de visitante. Se a solicitação for recusada, ofereça o cadastro normal. Não tente novamente usando novas identidades.

Corpo

application/jsonrequired

namestringrequiredlength: 1–80 chars

slugstringlength: 3–40 chars

device_codestringlength: 8–200 chars

Obtido de POST /oauth/device_authorization, para permitir que a pessoa conecte este agente ao reivindicar o site.

client_idstringlength: 1–512 chars

Resposta

application/json

Preparar um site antes do login

dataobjectrequired

Show child attributes

data.site_idstringrequired

data.addressstringrequired

data.write_tokenstringrequired

Authorization: Guest <write_token> para importação, compilações e status. Válido por 2 horas. Não o inclua em logs nem em conversas.

data.write_expires_atstringrequired

data.claim_urlstringrequired

Envie isto à pessoa: ela faz login e o site passa a ser dela. Válido por 7 dias.

data.claim_expires_atstringrequired

data.next_actionstringrequired

request_idstringrequired

{ "data": { "site_id": "<string>", "address": "<string>", "write_token": "<string>", "write_expires_at": "<string>", "claim_url": "<string>", "claim_expires_at": "<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>" }

Preparar um site antes do cadastro

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