SDK y Uso del API directamente

SDK

El SDK esconde la implementación de las solicitudes y la autenticación, haciendo que te sea más fácil usar nuestros servicios. Actualmente está disponible en: Java, PHP, .NET2, .NET4, Python y Node

Los ejemplos de este documento están en Node pero son muy parecidos para los demás lenguajes, te proporcionaremos varios ejemplos para que puedas comenzar a probar rápidamente.

//esto es sólo para pruebas
//te recomendamos que cargues tus credenciales
//desde un archivo externo o desde el ambiente
//de producción
const webId = "mBS73C5TdTjthjF0"
const apiKey = "521026f468b9dadc2419e476356934d0"

const AcertiaServices = AcertiaServices(webId, apiKey);

Si el SDK no está implementado en el lenguaje de programación que utilizas, puedes llamar al API directamente (ve "Usando el API directamente"), o contáctanos en [e-mail] para más información.

Uso del API directamente

Si el SDK no está implementado en el lenguaje de programación que utilizas, puedes mandar llamar al API directamente. El API es un grupo de endpoints que aceptan solicitudes JSON que contienen un encabezado de autenticación. Abajo se encuentra una descripción básica de como trabaja, pero nos puedes contactar en [e-mail] para cualquier duda que tengas

Encabezado de autenticación

Cada solicitud al API debe tener un Content-Type:application/json y un encabezado de autenticación que nos permite verificar que eres un usuario autorizado y que la solicitud no ha sido cambiada por un tercero. El encabezado está formado de la siguiente manera:

1. Identificador: el encabezado tiene que iniciar con "Authorization: signmage".

2. WebId: el WebId que te fue asignado como desarrollador.

3. Separador: entre el WebId y el HMAC tiene que haber un símbolo ":".

4. HMAC: un SHA-256 HMAC en base64 generado con los parámetros JSON de la solicitud y el API Key como el secreto. El JSON debe ser válido y sin espacios.

API endpoints

1. https://acertia.mx/developers/button: Para todas las solicitudes que resulten en un documento para ser firmado.

2. https://acertia.mx/developers/template/save: Para guardar un template y poder utilizarlo después para generar un documento.

3. https://acertia.mx/developers/webhook: Para solicitar más información al momento de recibir una notificación a un webhook.

4. https://acertia.mx/developers/docs: Para acciones que apliquen sobre un documento en específico.