Lijst synchroniseren (bulk)
Voegt in een keer meerdere relaties toe, werkt ze bij of meldt ze af. Je stuurt hier JSON, geen formuliervelden, met maximaal 500.000 relaties per aanroep. In het antwoord zie je per relatie of hij is toegevoegd, gewijzigd, overgeslagen of geweigerd.
Dit endpoint staat niet standaard aan. Krijg je een 401 met “Not permitted to issue bulk requests (1)”, neem dan contact op met Laposta om het voor je account te laten activeren. Adds, updates or unsubscribes multiple subscribers in one request. This endpoint is off by default: an account without access gets a 401 with the message “Not permitted to issue bulk requests (1)”. Contact Laposta to have it enabled for your account. Fügt in einem Durchgang mehrere Abonnenten hinzu, aktualisiert sie oder meldet sie ab. Du schickst hier JSON, keine Formularfelder, mit maximal 500.000 Abonnenten pro Aufruf. In der Antwort siehst du pro Abonnent, ob er hinzugefügt, geändert, übersprungen oder abgelehnt wurde.
Dieser Endpunkt ist standardmäßig nicht aktiv. Bekommst du einen 401 mit “Not permitted to issue bulk requests (1)”, nimm Kontakt mit Laposta auf, um ihn für dein Konto aktivieren zu lassen. Añade, actualiza o da de baja varios contactos de una sola vez. Aquí envías JSON, no campos de formulario, con un máximo de 500.000 contactos por llamada. En la respuesta ves por contacto si se ha añadido, modificado, omitido o rechazado.
Este endpoint no está activado de forma predeterminada. Si recibes un 401 con “Not permitted to issue bulk requests (1)”, ponte en contacto con Laposta para que lo activen en tu cuenta.
Dit endpoint staat niet standaard aan. Krijg je een 401 met “Not permitted to issue bulk requests (1)”, neem dan contact op met Laposta om het voor je account te laten activeren. Adds, updates or unsubscribes multiple subscribers in one request. This endpoint is off by default: an account without access gets a 401 with the message “Not permitted to issue bulk requests (1)”. Contact Laposta to have it enabled for your account. Fügt in einem Durchgang mehrere Abonnenten hinzu, aktualisiert sie oder meldet sie ab. Du schickst hier JSON, keine Formularfelder, mit maximal 500.000 Abonnenten pro Aufruf. In der Antwort siehst du pro Abonnent, ob er hinzugefügt, geändert, übersprungen oder abgelehnt wurde.
Dieser Endpunkt ist standardmäßig nicht aktiv. Bekommst du einen 401 mit “Not permitted to issue bulk requests (1)”, nimm Kontakt mit Laposta auf, um ihn für dein Konto aktivieren zu lassen. Añade, actualiza o da de baja varios contactos de una sola vez. Aquí envías JSON, no campos de formulario, con un máximo de 500.000 contactos por llamada. En la respuesta ves por contacto si se ha añadido, modificado, omitido o rechazado.
Este endpoint no está activado de forma predeterminada. Si recibes un 401 con “Not permitted to issue bulk requests (1)”, ponte en contacto con Laposta para que lo activen en tu cuenta.
Autenticación
AuthorizationBasic
Vul je API-sleutel in bij
api_key en laat leave_empty leeg. De API gebruikt basic auth, waarbij je sleutel de plaats van de gebruikersnaam inneemt. In curl schrijf je dat als -u JOUW_SLEUTEL:, met een dubbele punt en niets erachter.
Enter your API key at api_key and leave leave_empty empty. The API uses basic auth, with your key in place of the username. In curl that reads -u YOUR_KEY:, with a colon and nothing after it.
Trage deinen API-Schlüssel bei api_key ein und lass leave_empty leer. Die API nutzt Basic Auth, wobei dein Schlüssel an die Stelle des Benutzernamens tritt. In curl schreibst du das als -u DEIN_SCHLUESSEL:, mit einem Doppelpunkt und nichts dahinter.
Introduce tu clave API en api_key y deja leave_empty vacío. La API usa basic auth, con tu clave en lugar del nombre de usuario. En curl se escribe como -u TU_CLAVE:, con dos puntos y nada después.Parámetros de ruta
list_id
Het id van de lijst. Dat vind je in het antwoord van Alle lijsten opvragen, en in de applicatie in de URL van de lijst.
The id of the list. You find it in the response of Get all lists, and in the application in the URL of the list.
Die ID der Liste. Du findest sie in der Antwort von Alle Listen abrufen und in der Anwendung in der URL der Liste.
El id de la lista. Lo encuentras en la respuesta de Obtener todas las listas y en la aplicación, en la URL de la lista.
Solicitud
This endpoint expects an object.
actions
Een array met ten minste één van de volgende opties: add, update of unsubscribe_excluded. Hiermee bepaalt je of relaties toegevoegd, gewijzigd en/of afgemeld mogen worden (zie de details hieronder).
An array with at least one of the following options: add, update, or unsubscribe_excluded. These determine whether members may be added, updated and/or unsubscribed (read details below).
Ein Array mit mindestens einer der folgenden Optionen: add, update oder unsubscribe_excluded. Damit bestimmst du, ob Abonnenten hinzugefügt, geändert und/oder abgemeldet werden dürfen (siehe die Details unten).
Un array con al menos una de las siguientes opciones: add, update o unsubscribe_excluded. Con esto determinas si se pueden añadir, modificar o dar de baja contactos (consulta los detalles más abajo).
members
Een array met member objecten. Minimaal 1, maximaal 500.000.
An array with member objects. A minimum of 1, maximum of 500,000.
Ein Array mit member-Objekten. Mindestens 1, maximal 500.000.
Un array con objetos member. Mínimo 1, máximo 500.000.
member_id
Het id van de relatie, of gewoon haar e-mailadres. Allebei werken.
The id of the subscriber, or simply their email address. Both work.
Die ID des Abonnenten oder einfach seine E-Mail-Adresse. Beides funktioniert.
El id del contacto, o simplemente su dirección de correo. Ambos funcionan.
email
Het e-mailadres van de te wijzigen of toe te voegen relatie. Als member_id ook is opgegeven dan kan hier een nieuw e-mailadres worden opgegeven voor de bestaande relatie.
The email address of the relation to be changed or added. If the member_id is also specified, then a new email address can be specified here for the existing relation.
Die E-Mail-Adresse des zu ändernden oder hinzuzufügenden Abonnenten. Wenn member_id ebenfalls angegeben ist, kann hier eine neue E-Mail-Adresse für den bestehenden Abonnenten angegeben werden.
La dirección de correo electrónico del contacto que se va a modificar o añadir. Si también se indica member_id, aquí se puede indicar una dirección de correo electrónico nueva para el contacto existente.
custom_fields
Een JSON object waarbij de key de naam is van het extra veld en de value de waarde is van het extra veld. Labels geef je hier mee als array: “labels”: [“Klant”]. Alleen labels die de lijst al heeft worden geaccepteerd; een onbekend label geeft foutcode 203 en de hele relatie wordt geweigerd. Geef je een losse tekst in plaats van een array, dan meldt het antwoord de relatie als gewijzigd en worden haar labels leeggemaakt, zonder foutmelding.
A JSON object where the key is the name of the extra field and the value is the value of the extra field. You pass labels here as an array: “labels”: [“Customer”]. Only labels the list already has are accepted; an unknown label returns error code 203 and the whole subscriber is rejected. If you pass a plain string instead of an array, the response reports the subscriber as edited and their labels are emptied, without any error.
Ein JSON-Objekt, bei dem der key der Name des zusätzlichen Feldes ist und der value der Wert des zusätzlichen Feldes. Labels übergeben Sie hier als Array: “labels”: [“Kunde”]. Akzeptiert werden nur Labels, die die Liste bereits hat; ein unbekanntes Label führt zu Fehlercode 203, und der gesamte Abonnent wird abgelehnt. Übergeben Sie einen einzelnen Text statt eines Arrays, dann meldet die Antwort den Abonnenten als geändert und seine Labels werden geleert, ohne Fehlermeldung.
Un objeto JSON en el que la key es el nombre del campo adicional y el value es el valor del campo adicional. Las etiquetas las pasas aquí como array: “labels”: [“Cliente”]. Solo se aceptan etiquetas que la lista ya tiene; una etiqueta desconocida da el código de error 203 y el suscriptor entero se rechaza. Si pasas un texto suelto en lugar de un array, la respuesta indica el suscriptor como modificado y sus etiquetas se vacían, sin ningún mensaje de error.
mode (verouderd)
Voor achterwaartse compatibiliteit kun je nog steeds de modus edit, add of add_and_edit meegeven, maar deze parameter wordt uitgefaseerd. Gebruik mode niet in combinatie met actions.
For backwards compatibility you can still pass edit, add or add_and_edit, but this parameter is being phased out. Do not send mode together with actions.
Aus Gründen der Abwärtskompatibilität kannst du weiterhin den Modus edit, add oder add_and_edit mitgeben, aber dieser Parameter wird schrittweise abgeschafft. Verwende mode nicht zusammen mit actions.
Por compatibilidad con versiones anteriores todavía puedes enviar el modo edit, add o add_and_edit, pero este parámetro se está retirando. No uses mode junto con actions.
source_url
URL vanwaar de relatie is aangemeld.
The URL from which the relation was registered.
URL, von der aus der Abonnent angemeldet wurde.
URL desde la que se ha registrado el contacto.
Respuesta
De aanvraag is gelukt.
The request succeeded.
Die Anfrage war erfolgreich.
La solicitud se ha realizado correctamente.
report
added
edited
skipped
errors
Errores
400
Bad Request Error
401
Unauthorized Error
429
Too Many Requests Error