Friendica API entities
Activities
Attachment
Attribute |
Type |
Nullable |
url |
String (URL) |
No |
mimetype |
String |
No |
size |
Integer (bytes) |
No |
Contact
Attribute |
Type |
Nullable |
id |
Integer |
No |
id_str |
String |
No |
name |
String |
No |
screen_name |
String |
No |
location |
String |
No |
description |
String |
No |
profile_image_url |
String (URL) |
No |
profile_image_url_https |
String (URL) |
No |
profile_image_url_profile_size |
String (URL) |
No |
profile_image_url_large |
String (URL) |
No |
url |
String (URL) |
No |
protected |
Boolean |
No |
followers_count |
Integer |
No |
friends_count |
Integer |
No |
listed_count |
Integer |
No |
favourites_count |
Integer |
No |
statuses_count |
Integer |
No |
created_at |
String (Date)
Ex: Wed May 23 06:01:13 +0000 2007
|
No |
utc_offset |
Integer |
No |
time_zone |
String |
No |
geo_enabled |
Boolean |
No |
verified |
Boolean |
No |
lang |
String |
No |
contributors_enabled |
Boolean |
No |
is_translator |
Boolean |
No |
is_translation_enabled |
Boolean |
No |
following |
Boolean |
No |
follow_request_sent |
Boolean |
No |
statusnet_blocking |
Boolean |
No |
notifications |
Boolean |
No |
statusnet_profile_url |
String (URL) |
No |
uid |
Integer |
No |
cid |
Integer |
No |
pid |
Integer |
No |
self |
Integer |
No |
network |
String |
No |
Entities
Event
Attribute |
Type |
Description |
id |
Integer |
|
uid |
Integer |
Owner User Id |
cid |
Integer |
Target Contact Id |
uri |
String |
Item unique URI string |
name |
String (Plaintext) |
Title |
desc |
String (HTML) |
Description |
start_time |
String (UTC YYYY-MM-DD HH:II:SS) ) |
|
end_time |
String (UTC YYYY-MM-DD HH:II:SS) ) |
Optional (null date is 0001-01-01 00:00:00 |
type |
String (event or birthday ) |
|
nofinish |
Boolean |
Ongoing event |
place |
String |
Optional. Location. |
ignore |
Boolean |
??? |
allow_cid |
String (angle-brackets escaped integers) |
Optional. List of allowed contact ids |
allow_gid |
String (angle-brackets escaped integers) |
Optional. List of allowed group ids |
deny_cid |
String (angle-brackets escaped integers) |
Optional. List of disallowed contact ids |
deny_gid |
String (angle-brackets escaped integers) |
Optional. List of disallowed group ids |
Hashtag
Unused
Item
Attribute |
Type |
Nullable |
text |
String (Plaintext) |
No |
truncated |
Boolean |
No |
created_at |
String (Date)
Ex: Wed May 23 06:01:13 +0000 2007
|
No |
in_reply_to_status_id |
Integer |
No |
in_reply_to_status_id_str |
String |
No |
source |
String |
No |
id |
Integer |
No |
id_str |
String |
No |
in_reply_to_user_id |
Integer |
No |
in_reply_to_user_id_str |
String |
No |
in_reply_to_screen_name |
String |
No |
geo |
String |
Yes |
favorited |
Boolean |
No |
user |
Contact |
No |
friendica_author |
Contact |
No |
friendica_owner |
Contact |
No |
friendica_private |
Boolean |
No |
statusnet_html |
String (HTML) |
No |
statusnet_conversation_id |
Integer |
No |
external_url |
String (URL) |
No |
friendica_activities |
Activities |
No |
friendica_title |
String (Plaintext) |
No |
friendica_html |
String (HTML) |
No |
attachments |
List of Attachments |
Yes |
entities |
Entities |
Yes |
Media
Identical to the Twitter Media Object.
Attribute |
Type |
Nullable |
id |
Integer |
No |
id_str |
String |
No |
indices |
List of Integer |
No |
media_url |
String (URL) |
No |
media_url_https |
String (URL) |
No |
url |
String (URL) |
No |
display_url |
String (URL) |
No |
expanded_url |
String (URL) |
No |
ext_alt_text |
String |
No |
type |
String |
No |
sizes |
Sizes |
No |
Notification
Attribute |
Type |
Description |
id |
Integer |
|
hash |
String |
|
type |
Integer |
- 1: Inbound follow request
- 2: Outbound follow request confirmation
- 4: Wall-to-wall post
- 8: Reply
- 16: Private message
- 32: Friend suggestion
- 64: Unused
- 128: Mention
- 256: Tag added to a post
- 512: Poke (Obsolete)
- 1024: New post
- 16384: System email
- 32768: System event
|
name |
String |
Full name of the contact subject |
url |
String (URL) |
Profile page URL of the contact subject |
photo |
String (URL) |
Profile photo URL of the contact subject |
date |
String (Date) |
YYYY-MM-DD hh:mm:ss local server time |
msg |
String (BBCode) |
|
uid |
Integer |
Owner User Id |
link |
String (URL) |
Notification URL |
iid |
Integer |
Item Id |
parent |
Integer |
Parent Item Id |
seen |
Integer (Boolean) |
Whether the notification was read or not. |
verb |
String (URL) |
[Activity Streams](http://activitystrea.ms) Verb URL |
seen |
Integer (Boolean) |
Whether the notification was read or not. |
otype |
Enum |
Subject type (`item`, `intro` or `mail`) |
name_cache |
String (HTML) |
Full name of the contact subject |
msg_cache |
String (Plaintext) |
Plaintext version of the notification text with a placeholder (`{0}`) for the subject contact's name. |
timestamp |
Integer |
Unix timestamp |
date_rel |
String |
Time since the note was posted, eg "1 hour ago" |
msg_html |
String (HTML) |
|
msg_plain |
String (Plaintext) |
|
Photo
Attribute |
Type |
Description |
id |
String |
Resource ID (32 hex chars) |
media-id |
String (Integer) |
ID used for attaching images to a Mastodon Post Status |
created |
String (Date) |
Format YYYY-MM-DD HH:MM:SS |
edited |
String (Date) |
Format YYYY-MM-DD HH:MM:SS |
title |
String |
|
desc |
String (Plaintext) |
Picture caption |
album |
String |
Album name |
filename |
String |
Original image filename |
type |
String |
MIME Type |
height |
Integer |
Image height in pixels |
width |
Integer |
Image width in pixels |
profile |
Integer |
1 if it is a profile photo |
allow_cid |
String (ACL) |
List of contact ids wrapped in angle brackets allowed to access the photo. |
allow_gid |
String (ACL) |
List of contact group ids wrapped in angle brackets allowed to access the photo. |
deny_cid |
String (ACL) |
List of contact ids wrapped in angle brackets forbidden to access the photo. |
deny_gid |
String (ACL) |
List of contact group ids wrapped in angle brackets forbidden to access the photo. |
link |
Array of Strings (URL) |
URLs to the different scales indexed by scale number if no specific scale was requested.
Mutually exclusive with data datasize .
|
scales |
Array of Photo Scales |
List of the various resized versions of the Photo
|
datasize |
Integer |
Picture size in bytes if a single scale was requested.
Mutually exclusive with link .
|
data |
String |
Base64-encoded image data if a single scale was requested.
Mutually exclusive with link .
|
friendica_activities |
Activities |
|
friendica_comments |
List of Items |
|
rights_mismatch |
Boolean |
True if the ACL differs between the picture and the associated item. |
Photo Scale
Attribute |
Type |
Nullable |
id |
String (Integer) |
Row ID of this photo scale |
scale |
Integer |
Scale number |
link |
String (URL) |
URL to this scale's image |
height |
Integer |
Image height in pixels |
width |
Integer |
Image width in pixels |
size |
Integer |
Image size in bytes |
Photo List Item
Attribute |
Type |
Description |
id |
String |
Resource ID (32 hex chars) |
album |
String |
Album name |
filename |
String |
Original image filename |
type |
String |
MIME Type |
created |
String (Date) |
Format YYYY-MM-DD HH:MM:SS |
edited |
String (Date) |
Format YYYY-MM-DD HH:MM:SS |
desc |
String (Plaintext) |
Picture caption |
thumb |
String (URL) |
URL of the smallest scale version of the picture. |
Photo Album
Attribute |
Type |
Description |
name |
String |
The name of the photo album |
created |
String (Date) |
The creation date of the album. Format YYYY-MM-DD HH:MM:SS |
count |
Integer |
The number of images in the album |
Private message
Attribute |
Type |
Description |
id |
Integer |
|
sender_id |
Integer |
Sender Contact Id |
text |
String |
Can be HTML or plaintext depending on the API call parameter `getText`. |
recipient_id |
Integer |
Recipient Contact Id |
created_at |
String (Date) |
Ex: Wed May 23 06:01:13 +0000 2007 |
sender_screen_name |
String |
|
recipient_screen_name |
String |
|
sender |
Contact |
|
recipient |
Contact |
|
title |
String |
Empty if the API call parameter `getText` is empty or absent. |
friendica_seen |
Integer (Boolean) |
Whether the private message has been read or not. |
friendica_parent_uri |
String |
|
Profile
Attribute |
Type |
Description |
profile_id |
Integer |
|
profile_name |
String |
|
is_default |
Boolean |
|
hide_friends |
Boolean |
Whether the user chose to hide their contact list on their profile. |
profile_photo |
String (URL) |
Largest size profile picture URL. |
profile_thumb |
String (URL) |
Smallest size profile picture URL. |
publish |
Boolean |
Whether the user chose to publish their profile in the local directory. |
net_publish |
Boolean |
Whether the user chose to publish their profile in the global directory. |
description |
String |
|
date_of_birth |
String |
|
address |
String |
|
city |
String |
|
region |
String |
|
postal_code |
String |
|
country |
String |
|
public_keywords |
String |
Comma-separated list of words meant to be displayed as hashtags. |
private_keywords |
String |
Comma-separated list of words meant to be used for search only. |
homepage |
String (URL) |
|
Size
<
table class="table table-condensed table-striped table-bordered">
Attribute |
Type |
Nullable |
Attribute |
Type |
Nullable |
w |
Integer |
No |
h |
Integer |
No |
resize |
Enum (fit, crop) |
Yes |
Sizes
Attribute |
Type |
Nullable |
medium |
Size |
No |
large |
Size |
Yes |
thumb |
Size |
Yes |
small |
Size |
Yes |
Symbol
Unused
URL
Attribute |
Type |
Nullable |
url |
String (URL) |
No |
expanded_url |
String (URL) |
No |
display_url |
String (URL) |
No |
indices |
List of Integer |
No |
User Mention
Unused
⇧