Animadoria at 01:04, 16 May 2025

2025-05-16T01:04:00Z

AD at 06:39, 26 March 2020

2020-03-26T06:39:30Z

← Older revision		Revision as of 06:39, 26 March 2020
Line 1:		Line 1:
	{{Protocols/WebAPI}}		{{Protocols/WebAPI}}

	Various data types that the [[Protocols/WebAPI/Reference/Methods\|methods]] return.		This page is about WebAPI types, in a series for the WebAPI [[Protocols/WebAPI/Reference\|reference manual]]. Various data types that the [[Protocols/WebAPI/Reference/Methods\|methods]] return.

	== Capability ==		== Capability ==

AD: Created page with "{{Protocols/WebAPI}} Various data types that the methods return. == Capability == A capability allows clients to broadcast what featu..."

2020-03-26T03:34:23Z

Created page with "{{Protocols/WebAPI}} Various data types that the methods return. == Capability == A capability allows clients to broadcast what featu..."

New page

{{Protocols/WebAPI}}

Various data types that the [[Protocols/WebAPI/Reference/Methods|methods]] return.

== Capability ==

A capability allows clients to broadcast what features they are interested in or support. They are represented with [http://web.archive.org/web/20090218224837/http://en.wikipedia.org/wiki/UUID UUIDs]. When sending or receiving a capability with these APIs, use the 32 character hex encoding of the UUID.

32 character UUID example: 550e8400e29b41d4a716446655440000

== Location ==

The Location Object contains field relating to a user's location.

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| desc
| Description
|-
| String
| street
| Street name
|-
| String
| city
| City name
|-
| String
| country
| Country name
|-
| String
| state
| State name
|-
| String
| postcode
| Postal code
|-
| String
| accuracy
| Measure of how accurate (in meters) location is
|-
| String
| lat
| Latitude
|-
| String
| lon
| Longitude
|-
| String
| accu_string
| Description of the accuracy level, ex Street|City|State, etc
|}

== QuietHours ==

Quiet hours

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| start
| Start time
|-
| String
| end
| End time
|}

== LocationAllow ==

Location Allow

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| aimId
| Allowed AIM id
|-
| ''Array of'' [[Protocols/WebAPI/Reference/Types#QuietHours|QuietHours]]
| quietHours
| Quiet hours
|}

== SmsSegment ==

The SMS Segment Object contains fields relating to segmenting IMs to send to SMS or IM Forwarding users

{| class="wikitable"
! Type
! Field
! Description
|-
| Integer
| single
| Number of bytes that can be sent in a single segment message
|-
| Integer
| initial
| Number of bytes in the first segment of a multi-segment IM
|-
| Integer
| trailing
| Number of bytes in second or later segment of a multisegment IM
|}

== Presence ==

The Presence Object contains fields relating to a users' online availability.

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| aimId
| Compressed AIM loginId - use this to identify windows; does not change
|-
| String
| displayId
| Display AIM loginId - use this to display an aimId to the end user
|-
| String
| emailId
| Email address of user - only set when doing an email search
|-
| String
| friendly
| Friendly alias - not always set; this is a local friendly name for the user
|-
| [[Protocols/WebAPI/Reference/Enumeration#Presence_State|Presence State]]
| state
| State of the aimId
|-
| Integer
| onlineTime
| Seconds online
|-
| Integer
| idleTime
| Minutes idle
|-
| Integer
| awayTime
| Seconds away
|-
| Integer
| statusTime
| Seconds since status message was changed
|-
| String
| awayMsg
| Away message in xhtml form
|-
| String
| profileMsg
| Profile message in xhtml form
|-
| String
| statusMsg
| Status message in utf8 form
|-
| String
| buddyIcon
| Buddy icon URL
|-
| String
| presenceIcon
| Presence icon URL
|-
| Integer
| memberSince
| When user joined AIM
|-
| ''Array of'' [[Protocols/WebAPI/Reference/Types#Capability|Capability]]
| capabilities
| Capabilities of the user
|-
| [[Protocols/WebAPI/Reference/Types#Location|Location]]
| location
| Information that the user has provided about their location
|-
| String
| ipCountry
| Country of the user if known. Based on IP address. Only valid in myInfo objects
|-
| Boolean
| recent
| For buddylist events, any buddies in the Recent Buddies group will have this set
|-
| Boolean
| bot
| For buddylist events, any buddies that are BOTs will have this set
|-
| Boolean
| shared
| For buddylist events, any buddies in the a shared buddies group will have this set
|-
| [[Protocols/WebAPI/Reference/Types#SmsSegment|SmsSegment]]
| smsSegment
| Information about SMS/IMF users
|-
| [[Protocols/WebAPI/Reference/Enumeration#User_Type|User Type]]
| userType
| Type of user
|}

== Group ==

The Group Object is used to subdivide Buddy lists.

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| name
| Name of Group
|-
| Boolean
| collapsed
| List of buddies not expanded
|-
| Boolean
| recent
| This group contains Recent Buddies
|-
| Boolean
| bot
| This group contains system added BOTs
|-
| Boolean
| shared
| This is a shared group
|-
| ''Array of'' [[Protocols/WebAPI/Reference/Types#Presence|Presence]]
| buddies
| Array of Users
|}

== Expression ==

The Expression Object points to the personal Expression data described in the Expression Type enumeration - buddy icons, arrival and departure sounds, and wallpaper.

{| class="wikitable"
! Type
! Field
! Description
|-
| [[Protocols/WebAPI/Reference/Enumeration#Expression_Type|Expression Type]]
| type
| Type of the expression
|-
| String
| id
| Id of the expression
|-
| String
| url
| URL to fetch the binary data for the expression
|}

== Personality ==

The Personality Object points to the Personality name and contains the Expression data therein.

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| name
| Name of the personality
|-
| ''Array of'' [[Protocols/WebAPI/Reference/Types#Expression|Expression]]
| expressions
| Expression object contained in the personality
|}

== MyInfoEvent ==

The MyInfoEvent, when subscribed to, returns the user's personal profile and online availability. Please refer to the Presence datatype section for specific details.

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| type
| Will be "myInfo"
|-
| [[Protocols/WebAPI/Reference/Types#Presence|Presence]]
| eventData
| Presence Event Data
|}

== PresenceEvent ==

The PresenceEvent, when subscribed to, returns another user's personal profile and online availability. Please refer to the Presence datatype section for specific details.

As users on a logged-in AIM member's Buddy List change their Presence information (by logging in and out, changing their away message, etc.), Presence events are sent by the Web AIM API for pickup by the fetchEvents method.

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| type
| Will be "presence"
|-
| [[Protocols/WebAPI/Reference/Types#Presence|Presence]]
| eventData
| Presence Event Data
|}

== TypingEventData ==

The Typing Event Data indicates whether a user is typing or not. Please refer to the Typing Status section for details.

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| aimId
| Source user
|-
| [[Protocols/WebAPI/Reference/Enumeration#Typing_Status|Typing Status]]
| typingStatus
| Status
|}

== TypingEvent ==

The Typing Event is sent when a user's Typing Status changes.

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| type
| Will be "typing"
|-
| [[Protocols/WebAPI/Reference/Types#TypingEventData|TypingEventData]]
| eventData
| Typing Event Data
|}

== DataIMEventData ==

The Data IM Event Data contains the actual data message as well as the source of the message, its type, and a timestamp.

{| class="wikitable"
! Type
! Field
! Description
|-
| [[Protocols/WebAPI/Reference/Types#Presence|Presence]]
| source
| Presence information about the source user
|-
| [[Protocols/WebAPI/Reference/Types#Capability|Capability]]
| dataCapability
| AIM Capability to which the message was sent
|-
| [[Protocols/WebAPI/Reference/Enumeration#Data_IM_Type|Data IM Type]]
| dataType
| Type of Message
|-
| String
| dataIM
| Base64 encoded data sent from the source user
|-
| Integer
| timestamp
| UTC timestamp of when the IM was sent
|-
| String
| inviteMsg
| For invite types, the message if present
|}

== DataIMEvent ==

The IM Event will be retrieved by the fetchEvents method whenever a data IM is received by the user.

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| type
| Will be "dataIM"
|-
| [[Protocols/WebAPI/Reference/Types#DataIMEventData|DataIMEventData]]
| eventData
| Data for the Data IM Event
|}

== sentDataIMEventData ==

The Sent Data IM Event Data contains the actual data message as well as the destination of the message, its type, and a timestamp.

{| class="wikitable"
! Type
! Field
! Description
|-
| [[Protocols/WebAPI/Reference/Types#Presence|Presence]]
| dest
| Presence information about the destination user. Actual presence information may not be known
|-
| [[Protocols/WebAPI/Reference/Types#Capability|Capability]]
| dataCapability
| AIM Capability to which the message was sent
|-
| [[Protocols/WebAPI/Reference/Enumeration#Data_IM_Type|Data IM Type]]
| dataType
| Type of Message
|-
| String
| dataIM
| Base64 encoded data sent from the source user
|-
| Integer
| timestamp
| UTC timestamp of when the IM was sent
|-
| String
| inviteMsg
| For invite types, the message if present
|}

== sentDataIMEvent ==

The Sent Data IM Event will be retrieved by the fetchEvents method whenever a data IM is sent by the user.

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| type
| Will be "sentDataIM"
|-
| [[Protocols/WebAPI/Reference/Types#sentDataIMEventData|sentDataIMEventData]]
| eventData
| Data for the Sent Data IM Event
|}

== IMEventData ==

The IM Event Data contains the actual IM message as well as the source of the message, its autoresponse status, and a timestamp.

{| class="wikitable"
! Type
! Field
! Description
|-
| [[Protocols/WebAPI/Reference/Types#Presence|Presence]]
| source
| Presence information about the source user
|-
| String
| message
| IM from the source user
|-
| Boolean
| autoResponse
| Is this an autoresponse IM?
|-
| Integer
| timestamp
| UTC timestamp of when the IM was sent
|}

== IMEvent ==

The IM Event will be retrieved by the fetchEvents method whenever an IM is received by the user.

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| type
| Will be "im"
|-
| [[Protocols/WebAPI/Reference/Types#IMEventData|IMEventData]]
| eventData
| IM Event Data
|}

== sentIMEventData ==

The Sent IM Event Data contains the actual IM message as well as the destination of the message, its autoresponse status, and a timestamp.

{| class="wikitable"
! Type
! Field
! Description
|-
| [[Protocols/WebAPI/Reference/Types#Presence|Presence]]
| dest
| Presence information about the source user. Actual online status may not be available
|-
| String
| message
| IM to the destination user
|-
| Boolean
| autoResponse
| Is this an autoresponse IM?
|-
| Integer
| timestamp
| UTC timestamp of when the IM was sent
|}

== sentIMEvent ==

The IM Event will be retrieved by the fetchEvents method whenever an IM is sent by the user.

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| type
| Will be "sentIM"
|-
| [[Protocols/WebAPI/Reference/Types#sentIMEventData|sentIMEventData]]
| eventData
| Sent IM Event Data
|}

== ClientErrorEventData ==

The Client Error Event Data contains the error data.

{| class="wikitable"
! Type
! Field
! Description
|-
| [[Protocols/WebAPI/Reference/Types#Presence|Presence]]
| source
| Presence information about the source user
|-
| String
| cookie
| Base64 encoded conversation cookie
|-
| [[Protocols/WebAPI/Reference/Enumeration#IM_Channel|IM Channel]]
| channel
| Channel client reported error on
|-
| [[Protocols/WebAPI/Reference/Enumeration#Client_Error|Client Error]]
| code
| Reason code
|-
| [[Protocols/WebAPI/Reference/Enumeration#Reject_Reason|Reject Reason]]
| rejectReason
| For rendezvous rejects
|-
| String
| errorInfo
| Base64 encoded optional error information
|}

== ClientErrorEvent ==

The Client Error Event will be retrieved by the fetchEvents method whenever a client error is received by the user.

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| type
| Will be "clientError"
|-
| [[Protocols/WebAPI/Reference/Types#ClientErrorEventData|ClientErrorEventData]]
| eventData
| Data for the Data IM Event
|}

== OfflineIMEventData ==

The IM Event Data contains the actual IM message as well as the source of the message, its autoresponse status, and a timestamp.

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| aimId
| Source user
|-
| String
| message
| IM from the source user
|-
| Integer
| timestamp
| UTC timestamp of when the IM was sent
|}

== OfflineIMEvent ==

The IM Event will be retrieved by the fetchEvents method whenever an IM is received by the user.

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| type
| will be "offlineIM"
|-
| [[Protocols/WebAPI/Reference/Types#OfflineIMEventData|OfflineIMEventData]]
| eventData
| Offline IM Event Data
|}

== BuddyListEventData ==

The BuddyList Event Data contains the user's complete Buddy List, stored as an array of Buddy List groups.

{| class="wikitable"
! Type
! Field
! Description
|-
| ''Array of'' [[Protocols/WebAPI/Reference/Types#Group|Group]]
| groups
| groups inside the Buddy List
|}

== BuddyListEvent ==

The Buddy List Event is sent to fetchEvents when a user first authenticates and gives permission for the API to access his Buddy List.

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| type
| Will be "buddylist"
|-
| [[Protocols/WebAPI/Reference/Types#BuddyListEventData|BuddyListEventData]]
| eventData
| Presence Event Data
|}

== SessionEndedEvent ==

This is the Session Ended Event from fetchEvents.

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| type
| Will be "sessionEnded"
|}

== Event ==

Event Object is a base class to all the different Events above.

{| class="wikitable"
! Type
! Field
! Description
|-
| [[Protocols/WebAPI/Reference/Enumeration#Event_Type|Event Type]]
| type
| Type of event
|-
| String
| eventData
| Data for event - see all the *Event types above.
|-
| Integer
| seqNum
| Identifier for event. Can be used as eventNumber with deleteEvent.
|}

== SendImSubCode ==

The subcode data returned with sendIM for mobile.

{| class="wikitable"
! Type
! Field
! Description
|-
| Integer
| subError
| suberror code
|-
| String
| subReason
| reason of the failure
|}

== BuddyFeedItem ==

This is the Buddy Feed Data.

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| aimId
| Compressed AIM id
|-
| String
| title
| Title
|-
| String
| link
| Link
|-
| String
| domain
| Domain link is on
|-
| String
| description
| Description
|-
| String
| category
| Category
|-
| String
| pubDate
| Date
|-
| String
| author
| Author
|-
| String
| guid
| guid
|}

== RankedUsersLocation ==

Ranked Users Locations Information

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| name
| Description of point
|-
| Integer
| count
| Number of users
|-
| Float
| lat
| latitude
|-
| Float
| lon
| longitude
|}

== EventStatus ==

Event Status Information

{| class="wikitable"
! Type
! Field
! Description
|-
| Integer
| event
| Event Number
|-
| Integer
| code
| Event Response Code
|}

== AddBuddyResultCode ==

The result code returned for each buddy object.

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| buddy
| buddy name
|-
| [[Protocols/WebAPI/Reference/Enumeration#AddBuddyResultCodeValue|AddBuddyResultCodeValue]]
| resultCode
| Status code of each buddy as a result of an action
|}

== IMConversationLocation ==

IM Conversation Location Information

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| name
| Description of line
|-
| Integer
| count
| Number of users
|-
| Integer
| age
| How long ago
|-
| Float
| lat1
| latitude1
|-
| Float
| lon1
| longitude1
|-
| Float
| lat2
| latitude2
|-
| Float
| lon2
| longitude2
|}

== AIMFightUser ==

User's AIM Fight information

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| aimId
| Compressed AIM id
|-
| Integer
| score
| The users score
|-
| Integer
| rank
| If the user is in the top 5% their numerical rank starting at 1, otherwise 0
|}

== PDNameResult ==

The target name and status code data.

{| class="wikitable"
! Type
! Field
! Description
|-
| String
| aimid
| aimid
|-
| [[Protocols/WebAPI/Reference/Enumeration#PDResultCode|PDResultCode]]
| statusCode
| status code returned for this aimid
|}

== PDResults ==

The result code returned for each object.

{| class="wikitable"
! Type
! Field
! Description
|-
| Integer
| pdModeResult
| Result of setting pdMode
|-
| ''Array of'' [[Protocols/WebAPI/Reference/Types#PDNameResult|PDNameResult]]
| allowResults
| Status code of each target in pdAllow
|-
| ''Array of'' [[Protocols/WebAPI/Reference/Types#PDNameResult|PDNameResult]]
| blockResults
| Status code of each target in pdBlock
|-
| ''Array of'' [[Protocols/WebAPI/Reference/Types#PDNameResult|PDNameResult]]
| IgnoreResults
| Status code of each target in pdIgnore
|-
| ''Array of'' [[Protocols/WebAPI/Reference/Types#PDNameResult|PDNameResult]]
| allowRemoveResults
| Status code of each target in pdAllowRemove
|-
| ''Array of'' [[Protocols/WebAPI/Reference/Types#PDNameResult|PDNameResult]]
| blockRemoveResults
| Status code of each target in pdBlockRemove
|-
| ''Array of'' [[Protocols/WebAPI/Reference/Types#PDNameResult|PDNameResult]]
| IgnoreRemoveResults
| Status code of each target in pdIgnoreRemove
|}

[[Category:Stub]]
[[Category:AOL]]
[[Category:AIM]]
[[Category:Protocols/WebAPI]]
[[Category:Protocols/WebAPI/Reference]]
[[Category:Work_In_Progress]]

Protocols/WebAPI/Reference/Types - Revision history

Animadoria at 01:04, 16 May 2025

AD at 06:39, 26 March 2020

AD: Created page with "{{Protocols/WebAPI}} Various data types that the methods return. == Capability == A capability allows clients to broadcast what featu..."