User.findbymail: Difference between revisions

From Safe Creative API
Jump to navigation Jump to search
w>Mpolo
Added user.findbymail
 
w>Mpolo
m Added InvalidProtocol notice
Line 9: Line 9:
* '''Timestamp''': Requires ztime parameter
* '''Timestamp''': Requires ztime parameter
* '''API trust level''': Partner
* '''API trust level''': Partner
* '''Mandatory protocol''': HTTPS
* '''Mandatory protocol''': HTTPS (Or InvalidProtocol error result (See [[Error handling]]))


= Parameters =
= Parameters =

Revision as of 12:53, 14 January 2011

Partner component to find if the provided e-mail address corresponds to a Safe Creative user.

You must be a Safe Creative partner to use this component.

Info

  • Component name: user.findbymail
  • Signature: Requires signature using the shared key's private key
  • Timestamp: Requires ztime parameter
  • API trust level: Partner
  • Mandatory protocol: HTTPS (Or InvalidProtocol error result (See Error handling))

Parameters

  • sharedkey*: Your application shared key
  • ztime*: Z-Timestamp
  • mail*: user mail

* Required parameter

Returns

  • user-found true if found, false otherwise

Example

REQUEST:

https://api.safecreative.org/v2/
?component=user.findbymail
&mail=sholmes%40baker.fake
&sharedkey=zy9x4ol0ctg3btyswq7b5wi9
&ztime=1271749826106
&signature=3b2d5552b5cd969c370ce70dae280a76dc844895

RESPONSE:

<?xml version="1.0" encoding="UTF-8"?>
<user-found>false</user-found>