Shopitag API Documentation API Reference

Welcome to Shopitags public API. Please make sure you obtain a valid api_token before calling any of the mentioned methods.

You can find your personal api_token by logging in to your Shopitag account, click top right corner on your profile picture, choose Settings and then click API.

Mandatory headers to use in your API calls

  1. Accept with value application/json
  2. Content-type with value application/json; charset=utf-8
  3. Authorization with value Bearer {your API token}
.

API Endpoint
https://app.shopitag.com/api/v1
Terms of Service: https://shopitag.com/terms-conditions/
Contact: support@shopitag.com
Schemes: https
Version: 1.0.0

Paths

tag

Generate a hyperlink to visit a popup shop or productcategory

POST /tag/generate/{hashtag}

Based on the provided # hashtag which identifies your popup shop (or one of its categories), we will generate a link so a user can immediately enter the popup shop when he clicks the link. The user will (potentially) not have to authenticate during checkout as the userdata is provided in the call.

The lifetime of such link is 3 hours.

hashtag

Hashtag of the popup shop or the product category. The # itself must not be provided.

type
string
in
path
email

User e-mail; if not available at moment of calling the API, generate one that has a valid email pattern

type
string
in
formData
firstname

User first name; if not available, provide dummy data.

type
string
in
formData
lastname

User last name; if not available, provide dummy data.

type
string
in
formData
lang

The language of the user; if used, use en for English, fr for French, de for German, es for Spanish, nl for Dutch. Unsupported languages will fall back to English.

type
string
in
formData
200 OK

The JSON containing the hyperlink to the popupshop.

422 Unprocessable Entity

See the error message

Response Content-Types: application/json
Response Example (200 OK)
{
  "token": "string",
  "url": "string",
  "shop_title": "string",
  "valid_from": "string",
  "valid_until": "string"
}
tag

Generates a link that can be used in a mailing

POST /tag/generate/email/{hashtag}

This API call is linked to our email sales channel. This API call can be used by email providers (email marketing companies) that send out a batch of emails to opt-in subscribed email addresses. Calling the API will provide you the correct URL to a popup shop. The user that receives the email will then be able to visit the right popup shop when he clicks the link in the email.

The lifetime of this link is indefinite, or untill the popup shop itself expires or is deleted.

hashtag

Hashtag of the popup shop or the product category. You can skip the #.

type
string
in
path
lang

The language of the email campaign; if used, use en for English, fr for French, de for German, es for Spanish, nl for Dutch. Unsupported languages will fall back to English.

type
string
in
formData
200 OK

The JSON containing the hyperlink to the popupshop.

404 Not Found

The code does not exists or the shop is expired

Response Content-Types: application/json
Response Example (200 OK)
{
  "redirect": "string"
}