Integration

How to integrate with vcards by TicTAP

REST API

The documentation of the api can be found in Api Docs page. This article defines the resources available in the Vcards integration API.

Access token

In order to access the API it is required having an accessToken. Once you have an accessToken you must include it in every request as a HTTP header

AccessToken: "YOUR_API_KEY_HERE"

If you need to try different API calls you can do it from the same Api Docs page, by using the "authorize" button

List vcards

Retrieve a paginated list of vcards with optional filtering and search functionality.

Parameters:

Name Type Description Required
query string Search a string in name, code, or SKU No
filters[] array Filter by field values, can include multiple in the format filters[field-slug]=value. Example: filters[email]=mymail No
page string Page number for pagination (default is 1) No
limit string Number of items per page (default is 25) No

Responses:

The response for this endpoint would contain a paginated list of tags with the applied filters and search criteria.

Create a new vcard

Creates a new vcard in the team.

Parameters ( values )

Name Type Description Required
name string Full name ( contains name and last name ) Yes
collection string Brand id ( this value uniquely identifies a vcard brand ) Yes
position object Job Position as a localized value. Uses the locale as a key No
email string Email related to the vcard Yes
telephone string Phone number No
mobile-phone string Mobile phone number No
address string Address of the vcard No
address-second-line string When the address is too long No
department string Company department No
postal-code string Postal code / zip code No
city string City No

Request Body:

Responses:

201 - Success

Show vcard detail

Retrieves vcard details by the given SKU. The SKU is a unique reference for the vcard.

Parameters:

Name Type Description Required
sku string SKU code Yes

Responses:

200 - Success

404 - Not Found

Edit a vcard

Updates the details of an existing vcard identified by the SKU.

Attention: When a value is NOT included in the request body, that value will be ERASED!! Every PUT request must include all the fields that you want to keep.

Parameters:

Name Type Description Required
sku string SKU code Yes

Request Body:

Responses:

200 - Success

Delete a vcard

Deletes a vcard from the team by the given SKU.

Parameters:

Name Type Description Required
sku string SKU code Yes

Responses:

204 - Success

Custom domain

If you want use your own domain to access the vcards is very simple:

You need to add a DNS record of type "CNAME" in your own domain management tool

The records needs to have the following name and value:

Name: "{vcards}.yourdomain.com"
Value: vcards-go.tictap.me