İçeriğe geç
Doğrulandı

Alan adı bağlayın

Hesabın kendi alan adlarından birini, Uygulama kapsamlı bir anahtarla bu anahtarın projesine DNS üzerinden yönlendirin.

agent_domain_connect projeye kapsamlı bir çağrıdır: bu bölümdeki diğer tüm yazma çağrılarından farklı olarak app_id almaz. Bir alan adını yönlendirdiği proje, API anahtarının kendisinin oluşturulduğu projedir. Bu yüzden bu tarif bir Hesap anahtarı değil, bir Uygulama anahtarı (bir projenin kendi API sekmesinden oluşturulur) gerektirir. agent_domain_list eşlik eden okumadır, hesabın kendi alan adlarını verir. Böylece her zaman hesabın gerçekten sahip olduğu bir ad gönderirsiniz.

Yöntemler

POST/cpi/agent_domain_list
user

Domains: list

List the account's registered domains (name, status, which app each is attached to). Use this BEFORE asking the user to type a domain: if they say 'connect one of my domains', call this and present the options.

POST/cpi/agent_domain_connect
user

Domains: connect to this VPS

Point one of the account's own domains (from agent_domain_list) at THIS project's VPS via DNS. Optional subdomain (e.g. 'app' -> app.example.com); omit to use the apex. Prefer a subdomain unless the user explicitly wants the apex. Attaching replaces any existing record on that exact hostname.

Bunun için Hesap anahtarı değil, Uygulama anahtarı gerekir

İki yöntem de her yerde olduğu gibi uid değerini gönderdiğiniz anahtardan çözer, ancak agent_domain_connect app_id değerini de ondan çözer ve yalnızca bir projenin API sekmesinden oluşturulan anahtar birini taşır. Bunu bir Hesap anahtarıyla çağırırsanız, alan adına hiç bakmadan -1, 'no app is bound to this action' yanıtı verir. Üç anahtar kapsamı için Kimlik doğrulama sayfasına bakın.

Anlatım

Hesabın alan adlarını listeleyin

Anahtarınız dışında alan yok. Her satır, hesabın Xuda üzerinden kaydettiği ya da ad sunucularını devrederek bağladığı bir alan adıdır. Şu anda hangi projeye yönlendiği (varsa) ve kendi status değeri de yer alır.

curl -s https://xuda.ai/cpi/agent_domain_list \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_API_KEY"}'
const res = await fetch('https://xuda.ai/cpi/agent_domain_list', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({ api_key: 'YOUR_API_KEY' }),
});
const { code, data } = await res.json();
if (code > 0) for (const d of data.domains) console.log(d.domain, d.status, d.attached_app_id);
import requests

res = requests.post(
    'https://xuda.ai/cpi/agent_domain_list',
    json={'api_key': 'YOUR_API_KEY'},
)
body = res.json()
if body['code'] > 0:
    for d in body['data']['domains']:
        print(d['domain'], d['status'], d['attached_app_id'])

2. Birini bu anahtarın projesine yönlendirin

domain, önceki çağrının döndürdüğü adlardan biri olmalıdır. subdomain isteğe bağlıdır ve uygulama anahtarının kendi proje adıyla ilgisi yoktur: alan adı üzerinde bir etikettir (app.example.com için "app"). Bunun yerine alan adının kökünü yönlendirmek için bırakın. Bunu farklı bir subdomain ile yeniden çalıştırmak, daha önce bağladığınız bir ana bilgisayar adını bozmaz, yalnızca tam o ana bilgisayar adının kaydı değiştirilir.

curl -s https://xuda.ai/cpi/agent_domain_connect \
  -H 'content-type: application/json' \
  -d '{"api_key":"YOUR_APP_API_KEY","domain":"example.com","subdomain":"app"}'
const res = await fetch('https://xuda.ai/cpi/agent_domain_connect', {
  method: 'POST',
  headers: { 'content-type': 'application/json' },
  body: JSON.stringify({
    api_key: 'YOUR_APP_API_KEY',
    domain: 'example.com',
    subdomain: 'app',
  }),
});
const { code, data } = await res.json();
if (code > 0) console.log(data.record.type, data.record.name, data.record.target);
import requests

res = requests.post(
    'https://xuda.ai/cpi/agent_domain_connect',
    json={'api_key': 'YOUR_APP_API_KEY', 'domain': 'example.com', 'subdomain': 'app'},
)
body = res.json()
if body['code'] > 0:
    print(body['data']['record']['type'], body['data']['record']['name'], body['data']['record']['target'])

Yanıt

agent_domain_list, saklanan her alan adı belgesini dört alana indirger:

json
{
  "code": 1,
  "data": {
    "count": 2,
    "domains": [
      {
        "domain": "example.com",
        "status": "active",
        "connection_type": "registered",
        "attached_app_id": null
      },
      {
        "domain": "example.org",
        "status": "active",
        "connection_type": "connected",
        "attached_app_id": "app_5d9e21"
      }
    ]
  }
}

connection_type, Xuda üzerinden satın alınan bir alan adı için registered (kayıt kuruluşu ve DNS Xuda'dır), ad sunucuları Xuda'ya devredilmiş olarak başka yerde kaydedilmiş bir alan adı için connected değerindedir (yalnızca DNS, kayıt olduğu yerde kalır). agent_domain_connect için ikisi de aynı şekilde çalışır.

agent_domain_connect, gerçekten yazdığı DNS kaydıyla yanıt verir:

json
{
  "code": 1,
  "data": {
    "ok": true,
    "record": {
      "type": "A",
      "name": "app.example.com",
      "target": "203.0.113.42",
      "proxied": true,
      "ssl_mode": "full"
    }
  }
}

type, anahtarın kapsamlandığı proje türüne bağlıdır, sizin gönderdiğiniz hiçbir şeye değil: bir VPS projesi IP'sine bir A kaydı alır (genel IPv4'ü olmayan bir farm VM'inde AAAA), diğer her şey projenin kendi erişim URL'sine bir CNAME alır. Her kayıt Cloudflare üzerinden vekillenir (proxied: true), böylece ziyaretçi her iki durumda da uçta HTTPS alır. ssl_mode yalnızca Xuda'nın bölgenin kaynak SSL kipini de yokladığı ve ayarladığı VPS yolunda ayarlanır (full, strict veya flexible). Bir CNAME hedefi için null döner, o durumu Cloudflare'in kendi Universal SSL'i bildirilecek bir bölge ayarı olmadan karşılar.

Hatalar

Sonraki