guest

Website vor der Anmeldung vorbereiten

Für einen Agenten, der für jemanden arbeitet, der noch kein Konto hat. Erstellt anhand des Starter eine Website und gibt ein Schreib-Token (2 Stunden: Dateien importieren und erstellen, 3 Builds) sowie eine private URL zur Übernahme (7 Tage) zurück. Die Person öffnet die URL, um die Website zu übernehmen. Die erstellte Demo wird in einer Sandbox bereitgestellt, niemals indexiert und kann vor der Übernahme weder veröffentlicht noch mit einer Domain verbunden werden. Keine Credits, keine KI.

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

Kein Bearer-Token erforderlich. Der Aufrufer ist anonym und wird anhand seiner Adresse ratenbegrenzt.

Die Antwort enthält write_token (2 Stunden), claim_url (7 Tage) und next_action. Übergeben Sie device_code und client_id aus einer OAuth-Geräteanfrage, wenn die Person den Agenten verbinden können soll, sobald sie die Website beansprucht. Den vollständigen Ablauf finden Sie in den Anweisungen für Agenten.

Es kann nichts veröffentlicht, keine Domain verbunden und kein Guthaben verbraucht werden; außerdem wird kein Modell aufgerufen. Halten Sie das Schreib-Token und den Beanspruchungslink geheim: siehe Gast-Websites. Bieten Sie bei einer Ablehnung die normale Registrierung an. Versuchen Sie es nicht mit neuen Identitäten erneut.

Body

application/jsonrequired

namestringrequiredlength: 1–80 chars

slugstringlength: 3–40 chars

device_codestringlength: 8–200 chars

Von POST /oauth/device_authorization, damit die Person diesen Agenten verbinden kann, wenn sie die Website übernimmt.

client_idstringlength: 1–512 chars

Antwort

application/json

Eine Website vor der Anmeldung vorbereiten

dataobjectrequired

Show child attributes

data.site_idstringrequired

data.addressstringrequired

data.write_tokenstringrequired

Authorization: Guest <write_token> für Import, Builds und Status. 2 Stunden gültig. Nicht in Logs oder Chats weitergeben.

data.write_expires_atstringrequired

data.claim_urlstringrequired

Gib dies der Person: Sie meldet sich an und übernimmt die Website. 7 Tage gültig.

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

Website vor der Anmeldung vorbereiten

Body

Antwort

Use these docs with your AI tools

Query these docs via MCP

Query these docs over HTTP

Read these docs as Markdown

Cookies