Denne handling er mulig at udføre for en API bruger med admin eller Brugerdefineret ruter rettigheder. |
Denne artikel beskriver, hvordan du importerer/opdaterer emner i bulk ved brug af /imports endpoint. Dette endpoint understøtter den udvidede importfunktionalitet, du kender fra manuelle uploads, såsom dublettjek og berigelse af eksisterende kontakter.
For at få en bedre forståelse for mulighederne for data-import, kan du med fordel kigge på følgende artikel, som beskriver, hvordan du uploader emner gennem platformen.
En import påbegyndes ved at sende en POST request til /imports endpoint, f.eks.:
{ "poolId": 25528, "match": { "fields": [ 2 ], "blacklist": [] }, "updateFields": [ 1, 2, 3 ], "callbackUrl": "https://your-custom-callback-url.dev"}I ovenstående eksempel beder vi importen om at indsætte kontakterne i puljen med ID 25528. Dette er det eneste nødvendige parameter, når du laver et upload. Hvis du ønsker at benytte flere funktioner, såsom dublettjek, skal der tilføjes flere parametre:
Tjek, om der er dubletter i importen
Definer $.match.fields med de ID'er, som du vil køre dublettjek op imod. Du kan inkludere eksisterende kontakter i dublettjekket ved at tilføje et eller flere pulje-ID'er til $.match.blacklist.
Berig eksisterende kontakter
I stedet for at springe over eksisterende kontakter, når du laver dublettjekket, kan du definere tilladte felter for databerigelse i $.updateFields.
Da dette er en asynkron proces, kan et tilbagekald være nødvendigt, når der integreres til eksterne systemer. URL'en kan tilføjes til $.callbackUrl.
For mere information, se venligst vores officielle dokumentationsside.
Din request returnerer et svar, som indeholder import-ID'et, f.eks:
{ "id": 523231, "state": "init", "match": { "fields": [ 2 ], "blacklist": [ 25528 ] }, "updateFields": [ 1, 2, 3 ], "poolId": 25528}Det returnerede ID bruges nu til at udfylde records til din import request ved at kalde /imports/{id}/insert endpoint; i dette tilfælde /imports/523231/insert.
Din request skal indeholde dine kontakt records i body, ifølge dokumentationen.
[ { "data": { "1": "Peter", "2": "12345678", "3": "8000" } }, { "data": { "1": "Martin", "2": "87654321", "3": "9000" } }]Til slut skal du starte din import request ved at kalde /imports/{id}/start.