Importere kontakter

API-URL

URL for sending av HTTP-forespørsler:

https://portal.bulkgate.com/api/1.0/address-book/import

Merk

Hvis forespørselen ikke kommer frem, kan du gjenta den på reserveserveren backup1.bulkgate.com.

Støttede HTTP-metoder

POST - application/json

POST /api/1.0/address-book/import HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json

Parametertabell

PARAMETERNAVN	VERDI	OBLIGATORISK	STANDARDVERDI
application_id	Applikasjons-ID	Ja	-
application_token	Applikasjonstoken	Ja	-
groups	Array med ID-er for grupper som kontaktene skal legges til i	Nei	-
group_name	Importerte kontakter legges til i en ny gruppe med dette navnet	Nei	-
data	Kontaktopplysninger	Ja	Array med Data-objekter
category	Adresseboken det skal arbeides med. Standard er kontoens hovedadressebok.	Nei	`main`
duplicity_action	Hva som skal skje med en kontakt som allerede finnes — `restrict` (avvis), `skip` (hopp over), `update` (fyll ut tomme felt), `rewrite` (overskriv).	Nei	`skip`

Data-objekt

PARAMETERNAVN	VERDI	OBLIGATORISK	STANDARDVERDI
type	Kontakttype (person/bedrift)	Nei	-
phone_mobile	Hovedtelefonnummer	Nei	-
title_before	Tittel foran navnet	Nei	-
first_name	Fornavn	Nei	-
last_name	Etternavn	Nei	-
title_after	Tittel etter navnet	Nei	-
gender	male / female / transgender / agender / non_binary / unknown	Nei	unknown
company_name	Navnet på bedriften	Nei	-
email	E-post	Nei	-
url	URL til nettstedet ditt	Nei	-
street1	Gateadresse 1	Nei	-
street2	Gateadresse 2	Nei	-
city	By	Nei	-
zip	Postnummer	Nei	-
state	Delstat/fylke	Nei	-
country	Landskode i formatet ISO 3166-1 alpha-2	Nei	`null`
company_number	Organisasjonsnummer	Nei	-
company_vat	MVA-nummer	Nei	-
note	Notat	Nei	-
custom_field_0	Egendefinert felt	Nei	-
custom_field_1	Egendefinert felt	Nei	-
custom_field_2	Egendefinert felt	Nei	-
custom_field_3	Egendefinert felt	Nei	-
custom_field_4	Egendefinert felt	Nei	-
custom_field_5	Egendefinert felt	Nei	-
custom_field_6	Egendefinert felt	Nei	-
custom_field_7	Egendefinert felt	Nei	-
custom_field_8	Egendefinert felt	Nei	-
custom_field_9	Egendefinert felt	Nei	-

Eksempel på forespørsel

POST /api/1.0/address-book/import HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json { "application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj", "groups": [1, 2], "group_name": "Talos 1", "data": [ { "first_name": "Morgan", "last_name": "Yu", "phone_mobile": "789456123" }, { "first_name": "Alex", "last_name": "Yu", "phone_mobile": "123456789" } ] }

Svar

Ved suksess:

{ "data": { "message": "contacts_have_been_imported", "imported": 3, "groups": [1,2,3] } }

Ved feil:

{ "type": "no_valid_contacts_found", "code": 400, "error": "No valid contacts found", "detail": null }

Der:

type og error (beskrivelse av feilen) finner du i tabellen over feiltyper
code angir HTTP-feilkoden
detail er tilleggsinformasjon om feilen

Var denne siden nyttig?

Spør AI Kopiert