Provisionner un site
curl --request POST \
--url https://api.athenahq.ai/api/v1/websites/provision \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"url": "acme.com",
"name": "Acme Corp",
"description": "Enterprise widgets company",
"country": "United States",
"language": "English",
"industry": "SaaS & Software",
"identifiers": [
"Acme",
"Acme Corp"
],
"competitors": [],
"prompts": [],
"schedule": {
"days": {
"Monday": true,
"Wednesday": true,
"Friday": true
},
"models": {
"chatgpt": true,
"gemini": true,
"perplexity": true
},
"isActive": true,
"processingHour": 11
},
"external_id": "ws_a7f3b2c9"
}
'import requests
url = "https://api.athenahq.ai/api/v1/websites/provision"
payload = {
"url": "acme.com",
"name": "Acme Corp",
"description": "Enterprise widgets company",
"country": "United States",
"language": "English",
"industry": "SaaS & Software",
"identifiers": ["Acme", "Acme Corp"],
"competitors": [],
"prompts": [],
"schedule": {
"days": {
"Monday": True,
"Wednesday": True,
"Friday": True
},
"models": {
"chatgpt": True,
"gemini": True,
"perplexity": True
},
"isActive": True,
"processingHour": 11
},
"external_id": "ws_a7f3b2c9"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
url: 'acme.com',
name: 'Acme Corp',
description: 'Enterprise widgets company',
country: 'United States',
language: 'English',
industry: 'SaaS & Software',
identifiers: ['Acme', 'Acme Corp'],
competitors: [],
prompts: [],
schedule: {
days: {Monday: true, Wednesday: true, Friday: true},
models: {chatgpt: true, gemini: true, perplexity: true},
isActive: true,
processingHour: 11
},
external_id: 'ws_a7f3b2c9'
})
};
fetch('https://api.athenahq.ai/api/v1/websites/provision', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.athenahq.ai/api/v1/websites/provision",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'url' => 'acme.com',
'name' => 'Acme Corp',
'description' => 'Enterprise widgets company',
'country' => 'United States',
'language' => 'English',
'industry' => 'SaaS & Software',
'identifiers' => [
'Acme',
'Acme Corp'
],
'competitors' => [
],
'prompts' => [
],
'schedule' => [
'days' => [
'Monday' => true,
'Wednesday' => true,
'Friday' => true
],
'models' => [
'chatgpt' => true,
'gemini' => true,
'perplexity' => true
],
'isActive' => true,
'processingHour' => 11
],
'external_id' => 'ws_a7f3b2c9'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.athenahq.ai/api/v1/websites/provision"
payload := strings.NewReader("{\n \"url\": \"acme.com\",\n \"name\": \"Acme Corp\",\n \"description\": \"Enterprise widgets company\",\n \"country\": \"United States\",\n \"language\": \"English\",\n \"industry\": \"SaaS & Software\",\n \"identifiers\": [\n \"Acme\",\n \"Acme Corp\"\n ],\n \"competitors\": [],\n \"prompts\": [],\n \"schedule\": {\n \"days\": {\n \"Monday\": true,\n \"Wednesday\": true,\n \"Friday\": true\n },\n \"models\": {\n \"chatgpt\": true,\n \"gemini\": true,\n \"perplexity\": true\n },\n \"isActive\": true,\n \"processingHour\": 11\n },\n \"external_id\": \"ws_a7f3b2c9\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.athenahq.ai/api/v1/websites/provision")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"url\": \"acme.com\",\n \"name\": \"Acme Corp\",\n \"description\": \"Enterprise widgets company\",\n \"country\": \"United States\",\n \"language\": \"English\",\n \"industry\": \"SaaS & Software\",\n \"identifiers\": [\n \"Acme\",\n \"Acme Corp\"\n ],\n \"competitors\": [],\n \"prompts\": [],\n \"schedule\": {\n \"days\": {\n \"Monday\": true,\n \"Wednesday\": true,\n \"Friday\": true\n },\n \"models\": {\n \"chatgpt\": true,\n \"gemini\": true,\n \"perplexity\": true\n },\n \"isActive\": true,\n \"processingHour\": 11\n },\n \"external_id\": \"ws_a7f3b2c9\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.athenahq.ai/api/v1/websites/provision")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"url\": \"acme.com\",\n \"name\": \"Acme Corp\",\n \"description\": \"Enterprise widgets company\",\n \"country\": \"United States\",\n \"language\": \"English\",\n \"industry\": \"SaaS & Software\",\n \"identifiers\": [\n \"Acme\",\n \"Acme Corp\"\n ],\n \"competitors\": [],\n \"prompts\": [],\n \"schedule\": {\n \"days\": {\n \"Monday\": true,\n \"Wednesday\": true,\n \"Friday\": true\n },\n \"models\": {\n \"chatgpt\": true,\n \"gemini\": true,\n \"perplexity\": true\n },\n \"isActive\": true,\n \"processingHour\": 11\n },\n \"external_id\": \"ws_a7f3b2c9\"\n}"
response = http.request(request)
puts response.read_body{
"website": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"url": "acme.com",
"name": "Acme Corp",
"orgId": "987e6543-e21b-12d3-a456-426614174000",
"promptCount": 2,
"competitorCount": 1,
"hasSchedule": true
},
"billingEntityCreated": true
}Sites web
Provisionner un site
Crée un site entièrement configuré en un appel, sans assistant initial. Configure éventuellement concurrents, prompts et planification de traitement. Clé globale requise. Les intégrations partenaires peuvent associer leur identifiant avec external_id. La création réussie provisionne aussi la planification Par défaut dans la même transaction.
Bêta : ce point est en bêta ; les schémas peuvent évoluer. Les motifs de suivi conservent hôte soumis, casse du chemin et contraintes de requête. Les domaines apex incluent leur forme www ; les hôtes www explicites restent distincts. Les chemins correspondent par sections délimitées par des barres obliques.
POST
/
api
/
v1
/
websites
/
provision
Provisionner un site
curl --request POST \
--url https://api.athenahq.ai/api/v1/websites/provision \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"url": "acme.com",
"name": "Acme Corp",
"description": "Enterprise widgets company",
"country": "United States",
"language": "English",
"industry": "SaaS & Software",
"identifiers": [
"Acme",
"Acme Corp"
],
"competitors": [],
"prompts": [],
"schedule": {
"days": {
"Monday": true,
"Wednesday": true,
"Friday": true
},
"models": {
"chatgpt": true,
"gemini": true,
"perplexity": true
},
"isActive": true,
"processingHour": 11
},
"external_id": "ws_a7f3b2c9"
}
'import requests
url = "https://api.athenahq.ai/api/v1/websites/provision"
payload = {
"url": "acme.com",
"name": "Acme Corp",
"description": "Enterprise widgets company",
"country": "United States",
"language": "English",
"industry": "SaaS & Software",
"identifiers": ["Acme", "Acme Corp"],
"competitors": [],
"prompts": [],
"schedule": {
"days": {
"Monday": True,
"Wednesday": True,
"Friday": True
},
"models": {
"chatgpt": True,
"gemini": True,
"perplexity": True
},
"isActive": True,
"processingHour": 11
},
"external_id": "ws_a7f3b2c9"
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
url: 'acme.com',
name: 'Acme Corp',
description: 'Enterprise widgets company',
country: 'United States',
language: 'English',
industry: 'SaaS & Software',
identifiers: ['Acme', 'Acme Corp'],
competitors: [],
prompts: [],
schedule: {
days: {Monday: true, Wednesday: true, Friday: true},
models: {chatgpt: true, gemini: true, perplexity: true},
isActive: true,
processingHour: 11
},
external_id: 'ws_a7f3b2c9'
})
};
fetch('https://api.athenahq.ai/api/v1/websites/provision', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.athenahq.ai/api/v1/websites/provision",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'url' => 'acme.com',
'name' => 'Acme Corp',
'description' => 'Enterprise widgets company',
'country' => 'United States',
'language' => 'English',
'industry' => 'SaaS & Software',
'identifiers' => [
'Acme',
'Acme Corp'
],
'competitors' => [
],
'prompts' => [
],
'schedule' => [
'days' => [
'Monday' => true,
'Wednesday' => true,
'Friday' => true
],
'models' => [
'chatgpt' => true,
'gemini' => true,
'perplexity' => true
],
'isActive' => true,
'processingHour' => 11
],
'external_id' => 'ws_a7f3b2c9'
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.athenahq.ai/api/v1/websites/provision"
payload := strings.NewReader("{\n \"url\": \"acme.com\",\n \"name\": \"Acme Corp\",\n \"description\": \"Enterprise widgets company\",\n \"country\": \"United States\",\n \"language\": \"English\",\n \"industry\": \"SaaS & Software\",\n \"identifiers\": [\n \"Acme\",\n \"Acme Corp\"\n ],\n \"competitors\": [],\n \"prompts\": [],\n \"schedule\": {\n \"days\": {\n \"Monday\": true,\n \"Wednesday\": true,\n \"Friday\": true\n },\n \"models\": {\n \"chatgpt\": true,\n \"gemini\": true,\n \"perplexity\": true\n },\n \"isActive\": true,\n \"processingHour\": 11\n },\n \"external_id\": \"ws_a7f3b2c9\"\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.athenahq.ai/api/v1/websites/provision")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"url\": \"acme.com\",\n \"name\": \"Acme Corp\",\n \"description\": \"Enterprise widgets company\",\n \"country\": \"United States\",\n \"language\": \"English\",\n \"industry\": \"SaaS & Software\",\n \"identifiers\": [\n \"Acme\",\n \"Acme Corp\"\n ],\n \"competitors\": [],\n \"prompts\": [],\n \"schedule\": {\n \"days\": {\n \"Monday\": true,\n \"Wednesday\": true,\n \"Friday\": true\n },\n \"models\": {\n \"chatgpt\": true,\n \"gemini\": true,\n \"perplexity\": true\n },\n \"isActive\": true,\n \"processingHour\": 11\n },\n \"external_id\": \"ws_a7f3b2c9\"\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.athenahq.ai/api/v1/websites/provision")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"url\": \"acme.com\",\n \"name\": \"Acme Corp\",\n \"description\": \"Enterprise widgets company\",\n \"country\": \"United States\",\n \"language\": \"English\",\n \"industry\": \"SaaS & Software\",\n \"identifiers\": [\n \"Acme\",\n \"Acme Corp\"\n ],\n \"competitors\": [],\n \"prompts\": [],\n \"schedule\": {\n \"days\": {\n \"Monday\": true,\n \"Wednesday\": true,\n \"Friday\": true\n },\n \"models\": {\n \"chatgpt\": true,\n \"gemini\": true,\n \"perplexity\": true\n },\n \"isActive\": true,\n \"processingHour\": 11\n },\n \"external_id\": \"ws_a7f3b2c9\"\n}"
response = http.request(request)
puts response.read_body{
"website": {
"id": "123e4567-e89b-12d3-a456-426614174000",
"url": "acme.com",
"name": "Acme Corp",
"orgId": "987e6543-e21b-12d3-a456-426614174000",
"promptCount": 2,
"competitorCount": 1,
"hasSchedule": true
},
"billingEntityCreated": true
}Corps
application/json
Corps de provisionnement d’un site entièrement configuré
URL du site. Le protocole (https://) est retiré automatiquement. Les e-mails et URL avec nom d’utilisateur (name@example.com) sont refusés avec 400.
Maximum string length:
2048Exemple:
"acme.com"
Nom de marque
Maximum string length:
255Exemple:
"Acme Corp"
Description de marque
Exemple:
"Enterprise widgets company"
Pays de base du site web
Exemple:
"United States"
Langue par défaut, déduite du pays si omise (Allemagne → allemand, par exemple), puis anglais en repli.
Exemple:
"English"
Catégorie sectorielle. Valeurs courantes : SaaS & Software, E-commerce & Retail, Healthcare & Medical, Information Technology, Banking & Financial Services, Education & E-learning, Consulting, Manufacturing, Hospitality & Travel, Real Estate, etc. Accepte toute chaîne.
Exemple:
"SaaS & Software"
Noms, alias et abréviations de marque pour détecter les mentions. Si vide, générés par IA lors du premier traitement.
Maximum array length:
200Maximum string length:
500Exemple:
["Acme", "Acme Corp"]
Concurrents à suivre, dédupliqués par URL. L’URL du site lui-même et ses sous-chemins sont ignorés.
Maximum array length:
500Show child attributes
Show child attributes
Prompts (requêtes) à suivre sur les modèles IA, dédupliqués par texte.
Maximum array length:
10000Show child attributes
Show child attributes
Configuration de planification du traitement. Si entièrement omise, aucune planification créée ; l’utilisateur peut la configurer dans l’interface. Tous ses champs sont facultatifs avec des valeurs par défaut adaptées.
Show child attributes
Show child attributes
Partenaires uniquement. Un identifiant de votre propre système à associer à ce site Athena. Accepté uniquement avec une clé API d’une organisation marquée comme partenaire. L’envoi de ce champ par un client direct renvoie 403 Forbidden. Doit être unique par type de ressource dans votre organisation — les doublons renvoient 409 avec la ressource existante dans la charge utile.
Minimum string length:
1Exemple:
"ws_a7f3b2c9"
Réponse
Site web provisionné
Réponse du site provisionné
Show child attributes
Show child attributes
Indique si l’entité de facturation existe après provisionnement. Si faux, sa création a échoué même après une nouvelle tentative : le site existe mais n’a pas de crédits, et leur définition échoue avec un statut 400 jusqu’à réparation. Contactez alors l’assistance AthenaHQ.
Cette page vous a-t-elle été utile ?