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 todas as extensões disponíveis

GET https://api.lws.net/v1/domain/0/tlds

operationIdgetDomainTlds

Obtém a lista de todas as extensões (TLD) disponíveis, as suas informações de preços e outros parâmetros. Contém todas as extensões que podem ser adquiridas através dos nossos serviços.

Respostas

200

Lista de extensões obtida como um array associativo.

 
{
  "code": 200,
  "info": "All TLDs fetched",
  "data": [
    {
      "tld": ".fr",
      "transfer_possible": "oui",
      "local_country": "oui",
      "restore_possible": "oui",
      "price_purchase": "6.99",
      "price_purchase_offer": "6.99",
      "price_renew": "8.99",
      "price_restore": "19.99",
      "price_transfer": "4.99",
      "length": "3-63",
      "minimum_period": "1"
    }
  ]
}
Campos da resposta 14 Estende ApiEnvelope
  • code integer

    Código de estado/erro ao nível da aplicação (nem sempre igual ao código de estado HTTP)

    Exemplo: 200

  • info string

    Mensagem legível que descreve o resultado do pedido

    Exemplo: All TLDs fetched

  • data object[]
  • tld string

    Extensão de domínio (TLD)

    Exemplo: .fr

  • transfer_possible string

    Indica se a extensão pode ser transferida para outro registrador. 'oui' significa que a transferência é possível, 'non' significa que a transferência está proibida.

    Exemplo: oui

  • local_country string

    Indica se a extensão está reservada para um país específico. 'oui' significa que a extensão está reservada para um país específico, 'non' significa que não está.

    Exemplo: oui

  • restore_possible string

    Indica se a extensão pode ser restaurada após expiração. 'oui' significa que a restauração é possível, 'non' significa que a restauração está proibida.

    Exemplo: oui

  • price_purchase string

    Preço de compra da extensão

    Exemplo: 6.99

  • price_purchase_offer string

    Preço de compra da extensão com uma oferta

    Exemplo: 6.99

  • price_renew string

    Preço de renovação da extensão

    Exemplo: 8.99

  • price_restore string

    Preço de restauro da extensão após expiração

    Exemplo: 19.99

  • price_transfer string

    Preço de transferência da extensão para outro registrador

    Exemplo: 4.99

  • length string

    Comprimento do nome da extensão. Varia consoante cada extensão mas tem um máximo de 63 caracteres

    Exemplo: 3-63

  • minimum_period string

    Período mínimo de compra da extensão (em anos)

    Exemplo: 1

404

Extensões não encontradas

 
{
  "code": 404,
  "info": "No TLDs found"
}
Campos da resposta 2 Estende ApiEnvelope
  • code integer

    Código de estado/erro ao nível da aplicação (nem sempre igual ao código de estado HTTP)

    Exemplo: 404

  • info string

    Mensagem legível que descreve o resultado do pedido

    Exemplo: No TLDs found

500

Erro interno do servidor

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

    Código de estado/erro ao nível da aplicação (nem sempre igual ao código de estado HTTP)

    Exemplo: 500

  • info string

    Mensagem legível que descreve o resultado do pedido

    Exemplo: Internal Server Error

  • data string

    Mensagem detalhada sobre o erro

502

Gateway inválido

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

    Código de estado/erro ao nível da aplicação (nem sempre igual ao código de estado HTTP)

    Exemplo: 502

  • info string

    Mensagem legível que descreve o resultado do pedido

    Exemplo: Invalid response from upstream server

  • data object

    Resposta inválida devolvida pelo servidor

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.

GET /domain/0/tlds 
LWS_AUTH_LOGIN='…'LWS_AUTH_PASS='…'curl -X GET \  "https://api.lws.net/v1/domain/0/tlds" \  -H "X-Auth-Login: $LWS_AUTH_LOGIN" \  -H "X-Auth-Pass: $LWS_AUTH_PASS"
$lwsAuthLogin = '…';$lwsAuthPass = '…';$ch = curl_init("https://api.lws.net/v1/domain/0/tlds");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/domain/0/tlds",    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/domain/0/tlds", {  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/domain/0/tlds", nil)req.Header.Set("X-Auth-Login", lwsAuthLogin)req.Header.Set("X-Auth-Pass", lwsAuthPass)resp, err := http.DefaultClient.Do(req)