Este documento es un subconjunto del documento de la API de licencias de software que enumera todas las funciones disponibles a través de la API. La siguiente información explica cómo implementar esas funciones con cURL.
cURL es una herramienta de línea de comandos y una biblioteca de código abierto para transferir datos con sintaxis de URL. cURL viene preinstalado en las versiones modernas de Mac OS X y, por defecto, en la mayoría de las distribuciones de Linux. Puedes probarlo simplemente escribiendo
curl
en la línea de comandos y presionando Intro. Si cURL está instalado, verás un mensaje similar a este:
curl: try 'curl --help' or 'curl --manual' for more information
Para pedirle a cURL que realice una solicitud HTTP por ti, indícale tus variables y la URL a la que deseas enviarla, de esta manera:
curl
-d edd_action=check_license
-d item_id=123
-d license=cc22c1ec86304b36883440e2e84cddff
-d url=https://licensedsite.com
https://YOURSITE.com/
En el ejemplo anterior, prefijamos cada variable con -d para que el contenido se codifique en la URL. Una respuesta a la consulta anterior sería una cadena con formato JSON que se vería algo así:
{
"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]"
}
Indicadores
cURL acepta muchos indicadores para cambiar su comportamiento. Un tutorial completo de cURL está fuera del alcance de este documento, pero echa un vistazo a estos indicadores que podrían interesarte:
- -u, –user USUARIO[:CONTRASEÑA] Usuario y contraseña del servidor
- -A, –user-agent CADENA Enviar CADENA User-Agent al servidor (H)
- -d, –data DATOS Datos POST HTTP (H)
- -s, –silent Modo silencioso (no mostrar nada)
- -o, –output ARCHIVO Escribir en ARCHIVO en lugar de stdout
- -k, –insecure Permitir conexiones a sitios SSL sin certificados (H)
- -K, –config ARCHIVO Leer configuración de ARCHIVO
scripting bash
bash es un shell de Unix común y permite la creación de scripts para acciones. Lo siguiente es un script simple de bash que solicitará varias cosas y luego ejecutará la solicitud cURL y mostrará la salida en la pantalla.
#!/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/;
El ejemplo anterior podría modificarse para hacer más preguntas, tener diferentes indicadores de cURL o cualquier cosa que desees.
