Este documento é um subconjunto do documento da API de Licenciamento de Software que lista todos os recursos disponíveis através da API. As informações a seguir mostram como implementar esses recursos com cURL.
cURL é uma ferramenta de linha de comando e biblioteca de código aberto para transferir dados com sintaxe de URL. O cURL vem instalado em versões modernas do Mac OS X e, por padrão, na maioria das distribuições Linux. Você pode testar simplesmente digitando
curl
na linha de comando e pressionando Enter. Se o cURL estiver instalado, você verá uma mensagem semelhante a esta:
curl: try 'curl --help' or 'curl --manual' for more information
Para pedir ao cURL para fazer uma solicitação HTTP para você, informe suas variáveis e a URL para a qual você deseja enviá-la, assim:
curl
-d edd_action=check_license
-d item_id=123
-d license=cc22c1ec86304b36883440e2e84cddff
-d url=https://licensedsite.com
https://YOURSITE.com/
No exemplo acima, prefixamos cada variável com -d para que o conteúdo seja codificado em URL. Uma resposta à consulta acima seria uma string formatada em JSON que se pareceria com isto:
{
"license": "valid",
"item_name": "EDD Product name",
"expires": "2014-10-23 00:00:00",
"payment_id": 54224,
"customer_name": "John Doe",
"customer_email": "[email protected]"
}
Flags
O cURL aceita muitas flags para alterar seu comportamento. Um tutorial completo de cURL está fora do escopo deste documento, mas dê uma olhada nestas flags que podem lhe interessar:
- -u, –user USUÁRIO[:SENHA] Usuário e senha do servidor
- -A, –user-agent STRING Envia STRING User-Agent para o servidor (H)
- -d, –data DADOS Dados POST HTTP (H)
- -s, –silent Modo silencioso (não exibe nada)
- -o, –output ARQUIVO Escreve em ARQUIVO em vez de stdout
- -k, –insecure Permite conexões a sites SSL sem certificados (H)
- -K, –config ARQUIVO Lê a configuração de ARQUIVO
scripting bash
Bash é um shell Unix comum e permite a criação de scripts para ações. O seguinte é um script bash simples que solicitará várias coisas e, em seguida, executará a solicitação cURL e exibirá a saída na tela.
#!/bin/bash
# This script accepts arguments for accessing the Easy Digital Downloads
# Software Licensing REST API, then runs cURL to get the results.
read -p "Item ID: " item_id;
read -p "EDD Action: " edd_action;
read -p "License: " license;
read -p "URL: " url;
exec curl --data-urlencode "item_id=$item_id" --data-urlencode "edd_action=$edd_action" --data-urlencode "license=$license" --data-urlencode "url=$url" https://YOURSITE.com/;
O exemplo acima pode ser alterado para fazer mais perguntas, ter diferentes flags de cURL ou qualquer outra coisa que você desejar.
