Importovat kontakty

API URL

Adresa URL používaná k odeslání požadavků HTTP:

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

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

Tabulka s parametry

NÁZEV PARAMETRU	HODNOTA	POVINNÝ	VÝCHOZÍ HODNOTA
application_id	Aplikační identifikátor	Ano	-
application_token	Aplikační ověřovací token	Ano	-
groups	Pole ID skupin do kterých budou kontakty přidány	No	-
group_name	Importované kontakty budou přidány do skupiny pod jménem group_name	No	-
data	Kontaktní informace	Ano	Pole Data objektů

Data objekt

NÁZEV PARAMETRU	HODNOTA	POVINNÝ	VÝCHOZÍ HODNOTA
type	Typ kontaktu (person/company)	Ne	-
phone_mobile	Hlavní telefonní číslo	Ano	-
phone	Sekundární telefonní číslo	Ne	-
title_before	Titul před jménem	Ne	-
first_name	Křestní jméno	Ne	-
last_name	Příjmení	Ne	-
title_after	Titul po jméně	Ne	-
gender	Pohlaví (male/female/unknown)	Ne	unknown
company_name	Jméno společnosti	Ne	-
email	Email	No	-
url	Url vaší webové stránky	Ne	-
street1	1. adresa ulice	Ne	-
street2	2. adresa ulice	Ne	-
city	Město	Ne	-
zip	Zip kód	Ne	-
state	Stát	Ne	-
country	Kód země ISO 3166-1 alpha-2 format	Ne	null
company_number	IČO	Ne	-
company_vat	DIČO	Ne	-
note	Poznámka	Ne	-
custom_field_0	Volitelné pole	Ne	-
custom_field_1	Volitelné pole	Ne	-
custom_field_2	Volitelné pole	Ne	-
custom_field_3	Volitelné pole	Ne	-
custom_field_4	Volitelné pole	Ne	-
custom_field_5	Volitelné pole	Ne	-
custom_field_6	Volitelné pole	Ne	-
custom_field_7	Volitelné pole	Ne	-
custom_field_8	Volitelné pole	Ne	-
custom_field_9	Volitelné pole	Ne	-

Příklad úplného požadavku

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

{
    "application_id": "####",
    "application_token": "##################################################",
    "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"
        }
    ]
}

Odpověď na tento příkaz může být:

V případě úspěchu:

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

V případě chyby:

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