Skip to content
Connect API
/
/Validation

Magicline Connect API (1.0.0)

Scope of this API

This API can be used to integrate Magicline operations into third party clients like websites or apps.

Following operations are supported

  • Online contract conclusion
  • Trial session slot booking
  • Lead creation
Download OpenAPI description
connectapi.json
connectapi.yaml
Overview
URL

https://developer.sportalliance.com/

Languages
Servers
Generated server url

https://connectdemo.api.magicline.com/

Mock server

https://redocly.sportalliance.com/_mock/apis/magicline/connectapi/connectapi/

Campaigns

List your marketing campaigns

Operations

Terminal

/terminal

Operations

TrialSessions

Allow prospects to book a trial session

Operations

Tenant

Tenant information

Operations

Referral

Additional referral information for member creation

Operations

Image

Allow prospect to upload image

Operations

Promotions

Getting information about external promotion participation

Operations

AddressData

/addressdata

Operations

ContractVoucher

/contractvoucher

Operations

Validation

/validation

Operations

Validates the taxId against country based validation rules.

Request

For some countries additional customer related attributes might be needed for that. Country will be derived from given studioId.

Bodyapplication/jsonrequired
countryOfBirthstring

addition for Italy if customer isn't national

Enum"UNDEFINED""AC""AD""AE""AF""AG""AI""AL""AM""AN"
dateOfBirthstring(date)required
firstnamestringrequired
genderstring

User will be assigned as UNISEX if no gender is set.

Enum"MALE""FEMALE""UNISEX"
lastnamestringrequired
placeOfBirthstring

addition for Italy if customer is national

studioIdinteger(int64)required

Is needed to determine country specific validation rules

taxIdstringrequired

Is country specific, like CodiceFisacale in Italy

curl -i -X POST \
  https://connectdemo.api.magicline.com/connect/v1/validation/taxId \
  -H 'Content-Type: application/json' \
  -d '{
    "countryOfBirth": "UNDEFINED",
    "dateOfBirth": "2019-08-24",
    "firstname": "string",
    "gender": "MALE",
    "lastname": "string",
    "placeOfBirth": "string",
    "studioId": 0,
    "taxId": "string"
  }'

Responses

OK

Body*/*
errorsArray of stringsunique
Items Enum"INVALID_TAX_ID""MISSING_LASTNAME""MISSING_FIRSTNAME""MISSING_GENDER""UNSUPPORTED_GENDER""MISSING_DATE_OF_BIRTH""MISSING_PLACE_OR_COUNTRY_OF_BIRTH"
validboolean

Contracts

Cancel contracts

Operations

CreditCard Tokenization

Store credit cards for new members

Operations

BankAccount

Operations

FeatureCheck

Operations

I18n

Operations

Leads

Operations

Studios

Operations

Previews

Operations