Se necesita disponer de una API Key para hacer uso de la misma
Una vez desplegado el cliente de Viafirma, los métodos del API ya están disponibles desde cualquier PHP a través de las siguientes instrucciones:
<?php
try {
// 1) Importación de clases necesarias
include_once("./viafirma/includes.php");
// 2) Inicialización del cliente, indicando la Url de su aplicación como último parámetro
ViafirmaClientFactory::init($VIAFIRMA_SERVICE_URL,
$VIAFIRMA_SERVICE_URL,"http://<url_servidor_local>/<aplicacion>»,»API_KEY»,»API_PASS");
// 3) Obtener instancia del Cliente de Viafirma
$viafirmaClient = ViafirmaClientFactory::getInstance();
// 4) Invocación de método concreto
$viafirmaClient->metodoConcreto(xxxxx);
}catch(Exception $exception){
echo "<pre>".$exception."</pre>";
}
?>
En la mayoría de métodos que ofrece el API hay que indicar un parámetro que se corresponde con la URL a la cual se le devolverá el resultado de la operación.
En el SDK de ejemplo, las respuestas se mandan a la página “openidReturn.php” , la cual contiene la implementación de una clase que gestiona la respuesta. En el caso del ejemplo únicamente las muestra por pantalla, pero según su necesidad podría registrarla en una BD, guardarlo en un gestor de documental o almacenarla en sesión para procesarlo posteriormente. En el siguiente apartado se detalla más el proceso de respuesta de Viafirma.