Documentação da API Alojamento web acessível a todos
PT

Idioma

Français English Deutsch Español Português
Visitar a LWS
API de Domínios e E-mail

Documentação

API de Domínios e E-mail
Início da documentação

Obter informações de um alojamento

GET https://api.lws.net/v1/hosting/{hosting}

operationIdgetHosting

Obtém informações detalhadas sobre o alojamento especificado. Deve ser gerido pelo utilizador.

Parâmetros do caminho

hosting string obrigatório

O nome de domínio cujas informações de alojamento pretende obter

Exemplo: example.com

Respostas

200

Informações do alojamento obtidas com sucesso

 
{
  "code": 200,
  "info": "Retrieved hosting info",
  "data": {
    "domain": "example.com",
    "date_purchase": "2023-01-01",
    "date_expiration": "2024-01-01",
    "ns1": "ns1.lwsdns.com",
    "ns2": "ns2.lwsdns.com",
    "ns3": "ns3.lwsdns.com",
    "ns4": "ns4.lwsdns.com",
    "owner": 547645,
    "package": "LWS Perso",
    "lws_domain": true,
    "autorenew": {
      "payment": "aucun",
      "account": ""
    }
  }
}
Campos da resposta 16
  • code integer

    Exemplo: 200

  • info string

    Exemplo: Retrieved hosting info

  • data object

    HostingGet

  • domain any

    Nome do domínio

    Exemplo: example.com

  • date_purchase any

    Data de compra do alojamento

    Exemplo: 2023-01-01

  • date_expiration any

    Data de expiração do alojamento

    Exemplo: 2024-01-01

  • ns1 any

    Primeiro servidor de nomes

    Exemplo: ns1.lwsdns.com

  • ns2 any

    Segundo servidor de nomes

    Exemplo: ns2.lwsdns.com

  • ns3 any

    Terceiro servidor de nomes

    Exemplo: ns3.lwsdns.com

  • ns4 any

    Quarto servidor de nomes

    Exemplo: ns4.lwsdns.com

  • owner any

    Proprietário do alojamento

    Exemplo: 547645

  • package any

    Tipo de pacote de alojamento

    Exemplo: LWS Perso

  • lws_domain any

    Indica se o domínio foi comprado na LWS.fr ou não

    Exemplo: true

  • autorenew object

    Informações sobre a renovação automática do domínio

  • payment string

    Exemplo: aucun

  • account string

    Exemplo:

314

Domínio não encontrado na conta

314 não é um código de estado HTTP registado. É específico desta API.

{
  "code": 314,
  "info": "Provided domain has not been found on your account. You must own this domain to manage it."
}
Campos da resposta 2
  • code integer

    Exemplo: 314

  • info string

    Exemplo: Provided domain has not been found on your account. You must own this domain to manage it.

400

Entrada inválida

 
{
  "code": 400,
  "info": "No hosting provided",
  "data": []
}
Campos da resposta 3
  • code integer

    Exemplo: 400

  • info string

    Exemplo: No hosting provided

  • data any[]
401

Não autorizado - Faltam os cabeçalhos de autenticação

 
{
  "code": 401,
  "info": "Unauthorized access to the API. Please specify X-Auth-Pass and X-Auth-Login to proceed."
}
Campos da resposta 2
  • code integer

    Exemplo: 401

  • info string

    Exemplo: Unauthorized access to the API. Please specify X-Auth-Pass and X-Auth-Login to proceed.

429

Limite de pedidos excedido

 
{
  "code": 429,
  "info": "Rate limit exceeded. Please try again later."
}
Campos da resposta 2
  • code integer

    Exemplo: 429

  • info string

    Exemplo: Rate limit exceeded. Please try again later.

500

Erro interno do servidor

 
{
  "code": 500,
  "info": "Internal Server Error",
  "data": "Error message"
}
Campos da resposta 3
  • code integer

    Exemplo: 500

  • info string

    Exemplo: Internal Server Error

  • data string

    Exemplo: Error message

502

Gateway inválido

 
{
  "code": 502,
  "info": "Invalid response from upstream server",
  "data": []
}
Campos da resposta 3
  • code integer

    Exemplo: 502

  • info string

    Exemplo: Invalid response from upstream server

  • data object
GET /hosting/{hosting} 
LWS_AUTH_LOGIN='…'LWS_AUTH_PASS='…'curl -X GET \  "https://api.lws.net/v1/hosting/example.com" \  -H "X-Auth-Login: $LWS_AUTH_LOGIN" \  -H "X-Auth-Pass: $LWS_AUTH_PASS"
$lwsAuthLogin = '…';$lwsAuthPass = '…';$ch = curl_init("https://api.lws.net/v1/hosting/example.com");curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "GET");curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);curl_setopt($ch, CURLOPT_HTTPHEADER, [    "X-Auth-Login: " . $lwsAuthLogin,    "X-Auth-Pass: " . $lwsAuthPass,]);$res = json_decode(curl_exec($ch), true);
import requestsLWS_AUTH_LOGIN = "…"LWS_AUTH_PASS = "…"res = requests.get(    "https://api.lws.net/v1/hosting/example.com",    headers={        "X-Auth-Login": LWS_AUTH_LOGIN,        "X-Auth-Pass": LWS_AUTH_PASS,    },)print(res.json())
const LWS_AUTH_LOGIN = "…";const LWS_AUTH_PASS = "…";const res = await fetch("https://api.lws.net/v1/hosting/example.com", {  method: "GET",  headers: {    "X-Auth-Login": LWS_AUTH_LOGIN,    "X-Auth-Pass": LWS_AUTH_PASS,  },});const data = await res.json();
lwsAuthLogin := "…"lwsAuthPass := "…"req, _ := http.NewRequest("GET",    "https://api.lws.net/v1/hosting/example.com", nil)req.Header.Set("X-Auth-Login", lwsAuthLogin)req.Header.Set("X-Auth-Pass", lwsAuthPass)resp, err := http.DefaultClient.Do(req)