A resposta curta: com catalog:read, a API devolve os produtos à venda, as extensões de domínio, as moedas e os ciclos, com os preços, na moeda da sua conta ou na que pedir em currency. Com extras:read vê os extras da conta e o que está à venda; com extras:write e billing:purchase compra alguns com o saldo.
O catálogo
| Operação |
O que devolve |
| GET /v1/catalog/products |
Os produtos à venda, com o preço de cada ciclo, em páginas. Filtro group_id. |
| GET /v1/catalog/tlds |
Os preços de registro, renovação e transferência, por número de anos. Um número de anos que não aparece não está disponível. Uma extensão só: ?extension=com. |
| GET /v1/catalog/currencies |
As moedas aceites em currency. |
| GET /v1/catalog/billing-cycles |
Os nomes dos ciclos usados nos preços e nos serviços. |
Mostrar os preços no seu site
| 1 |
O seu servidor pede o catálogo à API, com uma chave que só tem catalog:read.
|
|
| 2 |
Guarda a resposta durante algum tempo (por exemplo, uma hora), em vez de perguntar a cada visita.
|
|
| 3 |
As páginas do site lêem a cópia guardada, nunca a API diretamente.
|
|
|
Não chame a API a partir do navegador. Os navegadores só podem chamar a API a partir da própria documentação, por isso o JavaScript de uma página do seu site recebe um erro de CORS. E mesmo que funcionasse, a chave ficava à vista de qualquer visitante. O pedido sai sempre do seu servidor: veja o erro de CORS.
|
Os extras da conta
GET /v1/extras devolve os certificados SSL, o SiteLock e outros produtos, a rádio com os seus adicionais, e o IP e o disco extra dos servidores, em páginas (filtro ?kind=ssl). GET /v1/extras/{id} mostra um deles. Os dados de acesso, como os da rádio, nunca vêm na API: vêem-se no My MozOut, em manage_url.
Comprar com o saldo
GET /v1/extras/catalog devolve os produtos, com os períodos e os preços na moeda da conta; purchasable diz se se pode comprar pela API. Hoje são três certificados SSL (RapidSSL, GeoTrust QuickSSL Premium e DigiCert Secure Site) e o SiteLock Find, Fix e Defend.
curl https://api.mozout.com/v1/extras/purchase -X POST \
-H "Authorization: Bearer $RLX_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 7a2b9c1d-3e4f-4a5b-8c6d-9e0f1a2b3c4d" \
-d '{"product_id": 96, "billing_cycle": "annually", "site": "yourcompany.com"}'
| Produto |
O que indicar |
| SiteLock |
site, o domínio do site. Só tem os períodos que aparecem no catálogo: nunca 3 nem 6 meses. |
| Certificados |
Sem site. O certificado configura-se no My MozOut depois da compra, em manage_url, e o estado vem em certificate. |
A compra paga-se só com o saldo, dentro do limite de gastos da chave, e precisa de Idempotency-Key. Se faltar saldo, o preço mudar ou o perfil da conta estiver por completar, nada é cobrado. A resposta é 202: a ação acaba com o pagamento, e a entrega acompanha-se em GET /v1/extras/{id}, com o extra_id da resposta.
|
O que se compra no My MozOut: o IP e o disco extra de um servidor (na página do servidor), a rádio e os outros produtos do catálogo, que pedem escolhas que só lá existem. Para esses, a API responde 422 com portal_only e portal_url. Os preços de tudo estão também na página de preços.
|
|
Quer mostrar os nossos preços no seu site ou comprar extras a partir do seu sistema? Veja a página da API.
Ver a página da API
|
Angola
Brasil
Kenya
Moçambique
Nigeria
Portugal
South Africa
United Kingdom
United States
International
