linagora-rse/modules/linagora.esn.contact.import/doc/REST_API.md

Linagora RSE

# /import/api

## POST /import/api/{type}

Import contacts from a specified type into OpenPaaS ESN.

**Request Headers**

- Accept: application/json

**Request URL Parameters:**

- type: The type of contacts to import.

**JSON Hash:**

- account_id: The ID of the account to import contacts from.

**Response Headers:**

- Content-Length: Document size
- Content-Type: application/json

**Status Codes:**

- 202 Valid request. The import has been started.
- 400 Bad request.
- 401 Unauthorized. The current request does not contains any valid data to be used for authentication.
- 404 Not found. No valid importer found.
- 500 Internal server error.

**Request:**

    POST /import/api/twitter
    Accept: application/json
    Host: localhost:8080

    {
      "account_id": "5375de4bd684db7f6fbd4f97"
    }

**Response:**

    HTTP/1.1 202 Accepted