## API URL

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

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

> [!NOTE]
> Nedostane-li se požadavek k cíli, zopakujte ho na [záložním serveru](https://www.bulkgate.com/cs/dokumentace/api-administrace-a-tokeny/zalozni-server/) `backup1.bulkgate.com`.


## Podporované HTTP metody

- `POST` - `application/json`

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

## Tabulka s parametry

| NÁZEV PARAMETRU	  | HODNOTA                                                               | 	POVINNÝ | VÝCHOZÍ HODNOTA                   |
|:------------------|:----------------------------------------------------------------------|:---------|:----------------------------------|
| application_id    | [Aplikační identifikátor](https://www.bulkgate.com/cs/dokumentace/api-administrace-a-tokeny/administrace-api/)                | **Ano**  | -                                 | 
| application_token | [Aplikační ověřovací token](https://www.bulkgate.com/cs/dokumentace/api-administrace-a-tokeny/api-tokeny/)	                     | **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) |
| category          | Adresář, se kterým se pracuje. Výchozí je hlavní adresář účtu.  | Ne       | `main`                      |
| duplicity_action  | Co dělat s kontaktem, který v adresáři už je — `restrict` (odmítnout), `skip` (přeskočit), `update` (doplnit prázdná pole), `rewrite` (přepsat).  | Ne       | `skip`                 |

## Data objekt

| NÁZEV PARAMETRU	 | HODNOTA                                                                                                                  | 	POVINNÝ | VÝCHOZÍ HODNOTA |
|:-----------------|:-------------------------------------------------------------------------------------------------------------------------|:---------|:----------------|
| type             | Typ kontaktu (person/company)                                                                                            | **Ne**   | -               |
| phone_mobile     | Hlavní telefonní číslo                                                                                                   | **Ano**  | -               | 
| 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           | male / female / transgender / agender / non_binary / 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](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements) | **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 požadavku

```http-json
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"
    	}
    ]
}
```

## Odpověď

**V případě úspěchu:**
```json
{
    "data": {
        "message": "contacts_have_been_imported",
        "imported": 3,
        "groups": [1,2,3]
    }
}
```


**V případě chyby:**
```json
{
    "type": "no_valid_contacts_found",
    "code": 400,
    "error": "No valid contacts found",
    "detail": null
}
```

Kde:

- **type** a **error** (popis chyby) najdete v [tabulce typů chyb](https://www.bulkgate.com/cs/dokumentace/api-administrace-a-tokeny/typy-chyb-api/)
- **code** je HTTP kód chyby
- **detail** je doplňující informace o chybě