Fetch profile
From ePrize Developers Wiki
(Difference between revisions)
Line 1: | Line 1: | ||
{{RESTfulAPI | {{RESTfulAPI | ||
|crumbs=[[API Home Page]] :: [[Profiles]] | |crumbs=[[API Home Page]] :: [[Profiles]] | ||
- | |summary=Only key:value pairs marked as safe for display will be returned. The {apikey} defines which keys are safe and the client may not change them except by requesting a new {apikey}. This allows clients to easily handle personalization, but minimizes the risk of exposing PII with a programming error. Full profiles are available through the Analytics "profile download" service. | + | |summary=Only key:value pairs marked as safe for display (public) will be returned. The {apikey} defines which keys are safe and the client may not change them except by requesting a new {apikey}. This allows clients to easily handle personalization, but minimizes the risk of exposing PII with a programming error. Full profiles are available through the Analytics "profile download" service. |
}} | }} | ||
Line 13: | Line 13: | ||
<id>{profile-number}</id> | <id>{profile-number}</id> | ||
<email>some.email@address.com</email> | <email>some.email@address.com</email> | ||
- | < | + | <public1>public-value1</public1> |
- | < | + | <public2>public-value2</public2> |
... | ... | ||
- | < | + | <publicN>public-valueN</publicN> |
</profile> | </profile> | ||
</result> | </result> |
Revision as of 12:53, 3 May 2010
Summary
Only key:value pairs marked as safe for display (public) will be returned. The {apikey} defines which keys are safe and the client may not change them except by requesting a new {apikey}. This allows clients to easily handle personalization, but minimizes the risk of exposing PII with a programming error. Full profiles are available through the Analytics "profile download" service.
Example: Found Profile
Summary
This demonstrates a successful fetch profile request where a profile was found.
Response
HTTP Status Code: 200 OK
<?xml version="1.0" encoding="UTF-8" ?> <result ver="1.0"> <profile> <id>{profile-number}</id> <email>some.email@address.com</email> <public1>public-value1</public1> <public2>public-value2</public2> ... <publicN>public-valueN</publicN> </profile> </result>
Example: Profile with UID Not Found
Summary
This demonstrates a fetch profile request where no profile could be found for the given UID.
Response
HTTP Status Code: 404 Not Found
<?xml version="1.0" encoding="UTF-8" ?> <result ver="1.0"> <status>0</status> </result>