Record DNS del dominio personalizzato

GET

apps

{app_id}

network

dns

Record DNS del dominio personalizzato

curl --request GET \
  --url https://api.squarecloud.app/v2/apps/{app_id}/network/dns \
  --header 'Authorization: <authorization>'

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.squarecloud.app/v2/apps/{app_id}/network/dns', 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.squarecloud.app/v2/apps/{app_id}/network/dns",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.squarecloud.app/v2/apps/{app_id}/network/dns"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.squarecloud.app/v2/apps/{app_id}/network/dns")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "response": [
    {
      "type": "txt",
      "name": "_acme-challenge.example.com",
      "value": "hmo-jMx_KCWQU5CWG6xmrkI4AOZOJXlQtjEtc7zI1PA",
      "status": "pending_validation"
    },
    {
      "type": "cname",
      "name": "example.com",
      "value": "cname.squareweb.app",
      "status": "pending"
    }
  ]
}

Un dominio personalizzato deve essere già collegato all’applicazione per usare questa route. I domini personalizzati sono disponibili a partire dal piano Standard. Questa route ha un limite di frequenza di 3 richieste ogni 10 secondi.

string

obbligatorio

La chiave API del tuo account. Puoi trovarla nelle impostazioni del tuo account.

Richiede una chiave API con lo scope apps:read. Questi sono i record di cui Cloudflare ha bisogno per validare la proprietà del dominio personalizzato ed emettere il relativo certificato SSL: tipicamente uno o due record txt (validazione del dominio e della challenge ACME) più un record cname che punta a cname.squareweb.app, che è ciò che instrada effettivamente il traffico verso l’applicazione. Aggiungili presso il tuo registrar del dominio; Cloudflare li rileva automaticamente tramite polling, senza bisogno di rieseguire la richiesta. La risposta viene memorizzata nella cache per 30 secondi per proprietario e applicazione, e la stessa cache alimenta l’agente Cubic AI quando ispeziona la configurazione del dominio di un’applicazione. Se l’hostname personalizzato non è ancora stato registrato all’edge, la risposta è un array vuoto anziché un errore. Per collegare innanzitutto un dominio personalizzato, vedi Imposta dominio personalizzato. Vedi anche Elenca Domini per ogni hostname configurato tra le tue applicazioni.

Parametri

string

obbligatorio

L’ID dell’applicazione. Puoi trovarlo nell’URL della dashboard della tua applicazione.

Risposta

string

Indica se la chiamata è andata a buon fine: success in caso affermativo, error in caso contrario.

array

Il contenuto della risposta.

Mostra Mostra oggetto

string

Il tipo del record DNS.

string

Il nome del record DNS.

string

Il valore del record DNS.

string

Lo stato del record DNS. Può essere pending_validation, pending o active.

{
  "status": "success",
  "response": [
    {
      "type": "txt",
      "name": "_acme-challenge.example.com",
      "value": "hmo-jMx_KCWQU5CWG6xmrkI4AOZOJXlQtjEtc7zI1PA",
      "status": "pending_validation"
    },
    {
      "type": "cname",
      "name": "example.com",
      "value": "cname.squareweb.app",
      "status": "pending"
    }
  ]
}

Errori comuni

Codice	HTTP	Significato
`NO_CUSTOM_DOMAIN`	400	L’applicazione non ha un dominio personalizzato collegato.

Vedi anche

CLI: squarecloud app network dns
SDK: api.apps.network.dns() (JavaScript), client.apps.network.dns() (Python), c.Apps.Network.DNS() (Go)

Record DNS del dominio personalizzato

curl --request GET \
  --url https://api.squarecloud.app/v2/apps/{app_id}/network/dns \
  --header 'Authorization: <authorization>'

const options = {method: 'GET', headers: {Authorization: '<authorization>'}};

fetch('https://api.squarecloud.app/v2/apps/{app_id}/network/dns', 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.squarecloud.app/v2/apps/{app_id}/network/dns",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: <authorization>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

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

func main() {

	url := "https://api.squarecloud.app/v2/apps/{app_id}/network/dns"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "<authorization>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.squarecloud.app/v2/apps/{app_id}/network/dns")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = '<authorization>'

response = http.request(request)
puts response.read_body

{
  "status": "success",
  "response": [
    {
      "type": "txt",
      "name": "_acme-challenge.example.com",
      "value": "hmo-jMx_KCWQU5CWG6xmrkI4AOZOJXlQtjEtc7zI1PA",
      "status": "pending_validation"
    },
    {
      "type": "cname",
      "name": "example.com",
      "value": "cname.squareweb.app",
      "status": "pending"
    }
  ]
}

Primi passi

Account

Applicazioni

Database

Workspace

IA

Record DNS del dominio personalizzato

Parametri

Risposta

Errori comuni

Vedi anche

​Parametri

​Risposta

​Errori comuni

​Vedi anche

Parametri

Risposta

Errori comuni

Vedi anche