Hacer tu primera llamada a la API

La forma más rápida de comprobar si todo funciona es consultar tus listas. Esa llamada no modifica nada en tu cuenta y da una respuesta inmediata. Puedes hacer esta llamada desde este mismo sitio web o desde tu propio ordenador.

Hacer la llamada desde este sitio web

Hacer la llamada desde tu propio sistema

Puedes consultar cómo enviar tu clave en Autenticación con tu clave API.

curl https://api.laposta.nl/v2/list \
  -u TU_CLAVE_API:

Con la biblioteca PHP sería así:

$laposta = new Laposta('TU_CLAVE_API');
$listas = $laposta->listApi()->all();

Una respuesta tiene este aspecto, abreviada a una sola lista:

{
  "data": [
    {
      "list": {
        "list_id": "BaImMu3JZA",
        "name": "Boletín",
        "state": "active",
        "members": { "active": 1232, "unsubscribed": 113, "cleaned": 14 }
      }
    }
  ]
}

Añadir un suscriptor

La llamada que probablemente necesitarás después es la de añadir un suscriptor. Además de la dirección de correo electrónico, la dirección IP es obligatoria, ya que con ella registras desde dónde se realizó la suscripción.

curl https://api.laposta.nl/v2/member \
  -u TU_CLAVE_API: \
  -d list_id=BaImMu3JZA \
  -d ip=198.51.100.10 \
  -d email=nuevo.suscriptor@example.net \
  -d custom_fields[nombre]=Lucía

$laposta->memberApi()->create('BaImMu3JZA', [
    'ip' => '198.51.100.10',
    'email' => 'nuevo.suscriptor@example.net',
    'custom_fields' => ['nombre' => 'Lucía'],
]);

Las claves dentro de custom_fields corresponden al custom_name de tus propios campos. Puedes obtenerlas una sola vez mediante Obtener todos los campos y guardarlas en tu propio código.

Artículos relacionados