NAME StartCom::API - a connector for StartAPI VERSION 0.2 SYNOPSIS use StartCom::API; $api = new StartCom::API; $api->tokenID($mytokenID); $api->client_cert($pathtoclientcert); $api->client_key($pathtoclientkey); $rc = $api->retrieve($myOrderID); $rc = $api->apply(...); $rc = $api->success; $msg = $api->errormsg; $cert = $api->certificate; $intermed = $api->intermediate; $myOrderID = $api->orderID; $myOrderNum = $api->orderNo; DESCRIPTION This module allows to connect to the api of StartCom in order to generate or retrieve certificates. Please see also the StartAPI documentation . METHODS "$api = new StartCom::API" The constructor. Returns a "StartCom::API" object. "$api->tokenID($key)" Sets or gets the API key. "$api->client_cert($pathtoclientcert)" Sets or gets the path to the client certificate file (PEM). "$api->client_key($pathtoclientkey)" Sets or gets the path to the client key file. "$api->retrieve($orderID)" Retrieves the certificate corresponding to the "orderID" and stores it in this object. Returns 1 on success, 0 or undef on failure. "$api->apply({'certType' => '...', 'CSR' => '...', ...})" Applies for a new certificate and, if successful, stores it in this object. See StartAPI documentation for parameters. Returns 1 on success, 0 or undef on failure. "$api->success" Checks whether or not the last call was successful. "$api->errormsg" Returns the error message if the last call was unsuccessful. "$api->certificate" If the last call was successful and the certificate was issued, this method returns the certificate. "$api->intermediate" If the last call was successful and the certificate was issued, this method returns the intermediate certificate. "$api->orderID" If the last call was successful and the certificate was issued, this method returns the certificate order ID which can be used in conjunction with "$api->retrieve". "$api->orderNo" If the last call was successful and the certificate was issued, this method returns the certificate ordering number which is shown in StartCom's web interface. "$api->testmode" When set to 0, which is the default, the api calls , else . DEPENDENCIES * LWP::UserAgent * IO::Socket::SSL * JSON * MIME::Base64 AUTHOR Philippe Kueck