Clientes de la API

LibreDTE ofrece clientes oficiales y la comunidad ha creado otros no oficiales para facilitar el consumo de la API desde distintos lenguajes de programación.

¿Debo usar un cliente?

No. Puedes consumir la API directamente con HTTP, pero un cliente te puede ahorrar trabajo y errores.

Tipos de clientes

Clientes disponibles

¿Y si no hay cliente para mi lenguaje?

No hay problema. Puedes crear uno propio. Solo necesitas:

• Consumir GET y POST con JSON.
• Autenticación HTTP Basic.

Creación de un nuevo cliente de la API

Si estás interesado en crear o mantener un cliente de la API, puedes hacerlo. Puedes colaborar con LibreDTE para crear uno nuevo, o solicitar acceso a mantener uno existente. Solo necesitas cumplir con algunas condiciones básicas.

¿Qué necesitas?

• Tener conocimientos básicos de HTTP, JSON y autenticación HTTP Basic.
• Conocer el lenguaje en el que quieras crear el cliente.
• Seguir la interfaz estándar que usamos en nuestros clientes oficiales.

Requisitos

1. Licencia libre: el código debe estar bajo licencia LGPL.
2. Interfaz compatible: debe seguir la interfaz de nuestros clientes oficiales.
3. Casos de prueba: al menos los de facturación deben estar implementados.

Estructura mínima esperada

Orientado a objetos (ejemplo en PHP)

class LibreDTE
{
    public function __construct($hash, $url = 'https://libredte.cl')
    {
        // Inicializa la conexión.
    }

    public function post($resource, $data = null)
    {
        // Realiza POST a /recurso con datos JSON.
    }

    public function get($resource)
    {
        // Realiza GET a /recurso.
    }
}

Versión funcional (ejemplo en PHP)

function libredte_init($hash, $url = 'https://libredte.cl')
{
    // Retorna estructura para conexión.
}

function libredte_post($libredte, $resource, $data = null)
{
    // Realiza POST.
}

function libredte_get($libredte, $resource)
{
    // Realiza GET.
}

¡Con esto has terminado el módulo de Introducción! 🎉