webleads-tracker

Home > TraceParts for Developers > User account creation

Introduction

This API allows you to create a TraceParts user account with few required user informations.

 

API Key

This web service requires an API Key. Please refer to this chapter to request your API Key.

 

Description

The API returns the success of the registration process.

 

Building a URL

The UserRegistration API request takes the following form:

http://ws.tracepartsonline.net/tpowebservices/UserRegistration?parameters

 

Parameters

Certain parameters are required while others are optional. As is standard in URLs, all parameters are separated using the ampersand (&) character. The list of parameters and their possible values are enumerated below.

 

Required parameters

Parameter Name

Data type

Default value

Length min

Length max

Description

ApiKey

string

none

N/A

N/A

Code calling an API to track and control how the API is used

UserEmail

string

none

5

100

User email / User ID

company

string

none

2

50

User company

country

ISO 3166 2 characters

none

2

2

User country

Format

string

none

N/A

N/A

Answer file type (xml, json or csv)

 

Optional parameters

Parameter Name

Data type

Default value

Length min

Length max

Description

ActiveJsonLight

boolean

0

N/A

N/A

Enables the light version when json is the answer file type

name

string

none

2

50

User last name

fname

string

none

2

50

User first name

addr1

string

none

2

80

First field for the user address

addr2

string

none

2

80

Second field for the user address

addr3

string

none

2

80

Third field for the user address

city

string

none

2

50

User city

state

string

none

2

80

User state, for North America

zipcode

string

none

3

20

User ZIP code

phone

string

none

5

25

User phone number

fax

string

none

5

20

User fax number

TPOptIn

boolean

0

N/A

N/A

Consent to receive information sent by TraceParts by email about TraceParts services

PartnersOptIn

boolean

0

N/A

N/A

Consent to receive information sent by TraceParts by email about TraceParts’ partners’ services

Example of UserRegistration API

The request below creates a user account and returns the success of the registration as an xml file.

http://ws.tracepartsonline.net/tpowebservices/UserRegistration?UserEmail=test@traceparts.com&Company=TraceParts&Country=US&Format=xml&ApiKey={ApiKey}

By changing the Format and adding the ActiveJsonLight, UserRegistration returns the registration success as a light Json file.

http://ws.tracepartsonline.net/tpowebservices/UserRegistration?UserEmail=test@traceparts.com&Company=TraceParts&Country=US&Format=json&ActiveJsonLight=1&ApiKey={ApiKey}

UserRegistration responses

UserRegistration responses are returned in the format indicated by the Format parameter within the URL request’s path.

 

JSON Output

A sample HTTP request is shown below, displaying if the user account exists.

{
"registered":true
}

 

XML Output

Same example as above.

<WsUserRegistration>
<Registered>true</Registered>
</WsUserRegistration>

UserRegistration response element

UserRegistration responses contain one element:

  • “Registered”: the value is “true” or “false” if the user account creation succeeded or not.

Developer support

Please contact us for any problems, questions or comments related to this web service.

Last updated July 25, 2016