Back to top

Xiglute REST API

What is REST API? Simply, REST API is the set of functions to which the developers can perform requests and receive responses. The interaction is performed via the HTTP/HTTPS protocol. An advantage of such an approach is the wide usage of HTTP/HTTPS that’s why REST API can be used practically for any programming language.

Below are the characteristics of the Xiglute REST API:

  • When a request is sent to the REST API server, the server will return a response that contains either the data you requested, or the status code, or both.

  • oauth_consumer_key / oauth_consumer_secret? The Consumer Key and Consumer Secret Key are used to make a connection between API client and server. These keys are also used for creating OAuth Tokens for site members to access server resources without sharing their credentials.

Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
  • oauth_token / oauth_secret? The OAuth Token and OAuth Secret are used for identifying site members.
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478

Base URL

All requests to this REST API should have the base URL: [https://xiglute.com/api/rest/]

HTTP Verbs

In REST API, there are four verbs that are used to manage resources: GET, POST, PUT, and DELETE. You can get the contents of a data using GET, delete the data using DELETE, and create or update the data using POST/PUT.

Supported Features

Official Xiglute Plugins

  • Blogs Plugin

  • Photo Albums Plugin

  • Classifieds Plugin

  • Groups Plugin

  • Events Plugin

  • Forums Plugin

  • Polls Plugin

  • Video Sharing Plugin

  • Music Sharing Plugin

Core Xiglute Features

  • Search

  • Member Links

  • Member Log-in

  • Member Sign-up With Profile Fields

  • Edit Member Profile Fields

  • Activity Feeds

  • Notifications

  • Friend Requests

  • Messages

  • Member Settings

  • Likes and Comments

  • Easy Implementation of Photo Lightbox.

  • Footer Menus

Xiglute Plugins:

  • Advanced Activity Feeds / Wall Plugin

  • Geo-Location, Geo-Tagging, Check-Ins & Proximity Search Plugin [only for Advanced Activity Feed’s location features]

Member Login

These are APIs for login, logout and forgot password.

Login

Get Login Form
GET/login

Returns the member login form.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "type": "Text",
    "name": "email",
    "label": "Email Address",
    "hasValidator": true
  },
  {
    "type": "Password",
    "name": "password",
    "label": "Password",
    "hasValidator": true
  },
  {
    "type": "Submit",
    "name": "submit",
    "label": "Sign In"
  }
]

Post Login Form
POST/login

Provides oauth_token and oauth_secret in the 200 response, so that API client can save their values and send them with every request.

Parameter Required Type Example Description
email yes string [email protected] member email address
password yes string @&#[email protected] member password
ip yes string 127.0.0.1 ip address

Login via Facebook

In case of login via Facebook, the following information will need to be sent with the request. If the Facebook user is not a member of the website, then the API will return the signup form.

Parameter Required Type Example Description
facebook_uid yes string 1122872077726440 facebook user id
access_token yes string CAAWkWAuNawYBAJ3uhTwNsqxC5T1ZArICqfsYDnniTvGrl3ZCH… facebook access token
code yes string AQDN-hjg5gzdzBqjYEr7SC23T65ah2XPVgzG9gzC-aPHNaoWUy1WdIiScLjImlzHrkT8yXicGp… facebook code
ip yes string 127.0.0.1 ip address

Login via Twitter

In case of login via Twitter, the following information will need to be sent with the request. If the Twitter user is not a member of the website, then the API will return the signup form.

Parameter Required Type Example Description
twitter_uid yes string 278526643412 twitter user id
twitter_token yes string 2785266434-Ll7cmPtr7DeQHVC8IdxLZo5yFwzNSrRpHuM0pBs twitter token
twitter_secret yes string jQ2GlrHSr7fxWKjlz18oHopLkYaHkY0zNz0P1PRewI2t5 twitter secret key
ip yes string 127.0.0.1 ip address
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Body
{
  "email": "[email protected]",
  "password": "@&#[email protected]"
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "token": "4a68af0f41e115140f05bd60f6f53151",
  "user": {
    "user_id": 3,
    "username": "dario",
    "displayname": "M Dario",
    "photo_id": 0,
    "status": null,
    "status_date": null,
    "locale": "English",
    "language": "English",
    "timezone": "US/Pacific",
    "search": 1,
    "show_profileviewers": 1,
    "level_id": 4,
    "invites_used": 0,
    "extra_invites": 0,
    "enabled": 1,
    "verified": 1,
    "approved": 1,
    "creation_date": "2014-12-30 06:15:12",
    "modified_date": "2015-05-19 05:56:21",
    "lastlogin_date": "2015-05-19 05:30:20",
    "update_date": null,
    "member_count": 0,
    "view_count": 6,
    "location": "",
    "image": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
    "image_normal": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
    "image_profile": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
    "image_icon": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_icon.png",
    "content_url": "http://example.com/profile/dario",
    "cover": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png"
  }
}
Response  400
HideShow
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "validation_fail",
  "message": {
    "email": "Please enter a valid email address.",
    "password": "Please enter a valid password."
  }
}
Response  404
HideShow
Body
{
  "status_code": 404,
  "error": true,
  "error_code": "no_record",
  "message": "No record found."
}

Logout

Logout
POST/logout

With 204 response of this API call, X-Auth-Token value should be deleted from API client.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "already_logged_out",
  "message": "You are already logged out."
}

Forgot Password

Forgot Password
POST/forgot-password

Sends forgot password email to the entered email address.

Parameter Required Type Example Description
email yes string [email protected] password reset instructions will be sent to the entered email address
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Body
{
  "email": "[email protected]"
}
Response  204
Response  400
HideShow
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "email_not_found",
  "message": "Email does not exist."
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "email_not_verified",
  "message": "This account still requires email verification."
}

Member Sign Up

Creates a new user.

The 200 response of Sign Up Form [GET] call returns the signup form fields. To validate signup form fields after each signup step, use the subsequent Validate Sign Up Form API. Finally, send the POST call to Sign Up Form [POST] API.

Sign Up Form

Get Sign Up Form
GET/signup

Get the sign up form.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "account": [
    {
      "type": "Text",
      "name": "email",
      "label": "Email Address",
      "description": "You will use your email address to login.",
      "hasValidator": true
    },
    {
      "type": "Password",
      "name": "password",
      "label": "Password",
      "description": "Passwords must be at least 6 characters in length.",
      "hasValidator": true
    },
    {
      "type": "Password",
      "name": "passconf",
      "label": "Password Again",
      "description": "Enter your password again for confirmation.",
      "hasValidator": true
    },
    {
      "type": "Text",
      "name": "username",
      "label": "Profile Address",
      "description": "This will be the last part of your profile link.",
      "hasValidator": true
    },
    {
      "type": "Select",
      "name": "timezone",
      "label": "Timezone",
      "multiOptions": {
        "US/Pacific": "(UTC-8) Pacific Time (US & Canada)",
        "US/Mountain": "(UTC-7) Mountain Time (US & Canada)",
        "US/Central": "(UTC-6) Central Time (US & Canada)",
        "US/Eastern": "(UTC-5) Eastern Time (US & Canada)",
        "America/Halifax": "(UTC-4)  Atlantic Time (Canada)",
        "America/Anchorage": "(UTC-9)  Alaska (US & Canada)",
        "Pacific/Honolulu": "(UTC-10) Hawaii (US)",
        "Pacific/Samoa": "(UTC-11) Midway Island, Samoa",
        "Etc/GMT-12": "(UTC-12) Eniwetok, Kwajalein",
        "Canada/Newfoundland": "(UTC-3:30) Canada/Newfoundland",
        "America/Buenos_Aires": "(UTC-3) Brasilia, Buenos Aires, Georgetown",
        "Atlantic/South_Georgia": "(UTC-2) Mid-Atlantic",
        "Atlantic/Azores": "(UTC-1) Azores, Cape Verde Is.",
        "Europe/London": "Greenwich Mean Time (Lisbon, London)",
        "Europe/Berlin": "(UTC+1) Amsterdam, Berlin, Paris, Rome, Madrid",
        "Europe/Athens": "(UTC+2) Athens, Helsinki, Istanbul, Cairo, E. Europe",
        "Europe/Moscow": "(UTC+3) Baghdad, Kuwait, Nairobi, Moscow",
        "Iran": "(UTC+3:30) Tehran",
        "Asia/Dubai": "(UTC+4) Abu Dhabi, Kazan, Muscat",
        "Asia/Kabul": "(UTC+4:30) Kabul",
        "Asia/Yekaterinburg": "(UTC+5) Islamabad, Karachi, Tashkent",
        "Asia/Calcutta": "(UTC+5:30) Bombay, Calcutta, New Delhi",
        "Asia/Katmandu": "(UTC+5:45) Nepal",
        "Asia/Omsk": "(UTC+6) Almaty, Dhaka",
        "Indian/Cocos": "(UTC+6:30) Cocos Islands, Yangon",
        "Asia/Krasnoyarsk": "(UTC+7) Bangkok, Jakarta, Hanoi",
        "Asia/Hong_Kong": "(UTC+8) Beijing, Hong Kong, Singapore, Taipei",
        "Asia/Tokyo": "(UTC+9) Tokyo, Osaka, Sapporto, Seoul, Yakutsk",
        "Australia/Adelaide": "(UTC+9:30) Adelaide, Darwin",
        "Australia/Sydney": "(UTC+10) Brisbane, Melbourne, Sydney, Guam",
        "Asia/Magadan": "(UTC+11) Magadan, Solomon Is., New Caledonia",
        "Pacific/Auckland": "(UTC+12) Fiji, Kamchatka, Marshall Is., Wellington"
      },
      "hasValidator": true
    },
    {
      "type": "Select",
      "name": "language",
      "label": "Language",
      "multiOptions": {
        "fil_PH": "Pilipinas Filipino",
        "ky": "Кыргыз",
        "en": "English"
      },
      "hasValidator": true
    },
    {
      "type": "Checkbox",
      "name": "terms",
      "label": "Terms of Service",
      "description": "I have read and agree to the terms of service.",
      "hasValidator": true
    }
  ],
  "fields": {
    "Personal Details": [
      {
        "type": "Text",
        "name": "1_1_3_alias_first_name",
        "label": "First Name",
        "description": "",
        "hasValidator": true
      },
      {
        "type": "Text",
        "name": "1_1_4_alias_last_name",
        "label": "Last Name",
        "description": "",
        "hasValidator": true
      },
      {
        "type": "Select",
        "name": "1_1_5_alias_gender",
        "label": "Gender",
        "description": "",
        "multiOptions": [
          "Male",
          "Female"
        ]
      },
      {
        "type": "Date",
        "name": "1_1_6_alias_birthdate",
        "label": "Birthday",
        "description": ""
      }
    ],
    "Contact Information": [
      {
        "type": "Text",
        "name": "1_1_8_alias_",
        "label": "Website",
        "description": ""
      },
      {
        "type": "Text",
        "name": "1_1_9_alias_",
        "label": "Twitter",
        "description": ""
      },
      {
        "type": "Text",
        "name": "1_1_10_alias_",
        "label": "Facebook",
        "description": ""
      },
      {
        "type": "Text",
        "name": "1_1_11_alias_",
        "label": "AIM",
        "description": ""
      }
    ],
    "Personal Information": [
      {
        "type": "Textarea",
        "name": "1_1_13_alias_about_me",
        "label": "About Me",
        "description": "",
        "hasValidator": true
      },
      {
        "type": "Text",
        "name": "1_1_27_alias_website",
        "label": "Website",
        "description": "Enter Your Website:",
        "hasValidator": true
      }
    ]
  },
  "photo": [
    {
      "type": "File",
      "name": "photo",
      "label": "Add Your Photo"
    }
  ]
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Post Sign Up Form
POST/signup

Create a new user.

To upload the profile photo, send the file in multipart / form-data format with the API request parameters.

Parameter Required Type Example Description
email yes string [email protected] email address
password yes string @#dskjfhd5$#das password
passconf yes string @#dskjfhd5$#das password
username yes string dario username
timezone yes string US/Mountain timezone
language yes string en language
terms yes boolean 1 agree with terms and conditions
1_1_3_alias_first_name yes string D profile fields
1_1_4_alias_last_name yes string Dario profile fields

In case of signup through Facebook, client will need to send facebook details also with post form values.

Parameter Required Type Example Description
facebook_uid yes string 1122872077726440 facebook user id
access_token yes string CAAWkWAuNawYBAJ3uhTwNsqxC5T1ZArICqfsYDnniTvGrl3ZCH… facebook access token
code yes string AQDN-hjg5gzdzBqjYEr7SC23T65ah2XPVgzG9gzC-aPHNaoWUy1WdIiScLjImlzHrkT8yXicGp… facebook code
email yes string [email protected] email address
username yes string dario username
timezone yes string US/Mountain timezone
language yes string en language
terms yes boolean 1 agree with terms and conditions
1_1_3_alias_first_name yes string D profile fields
1_1_4_alias_last_name yes string Dario profile fields

In case of signup through Twitter, client will need to send twitter details also with post form values.

Parameter Required Type Example Description
twitter_uid yes string 278526643412 twitter user id
twitter_token yes string 2785266434-Ll7cmPtr7DeQHVC8IdxLZo5yFwzNSrRpHuM0pBs twitter token
twitter_secret yes string jQ2GlrHSr7fxWKjlz18oHopLkYaHkY0zNz0P1PRewI2t5 twitter secret key
email yes string [email protected] email address
username yes string dario username
timezone yes string US/Mountain timezone
language yes string en language
terms yes boolean 1 agree with terms and conditions
1_1_3_alias_first_name yes string D profile fields
1_1_4_alias_last_name yes string Dario profile fields
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Body
{
    "email": "[email protected]",
    "password": "@#dskjfhd5$#das",
    "passconf": "@#dskjfhd5$#das",
    "username": "dario",
    "timezone": "US/Mountain",
    "language": "en",
    "terms": 1,
    "1_1_3_alias_first_name": M,
    "1_1_4_alias_last_name": Dario,
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "token": "4a68af0f41e115140f05bd60f6f53151",
  "user": {
    "user_id": 3,
    "username": "dario",
    "displayname": "M Dario",
    "photo_id": 0,
    "status": null,
    "status_date": null,
    "locale": "English",
    "language": "English",
    "timezone": "US/Pacific",
    "search": 1,
    "show_profileviewers": 1,
    "level_id": 4,
    "invites_used": 0,
    "extra_invites": 0,
    "enabled": 1,
    "verified": 1,
    "approved": 1,
    "creation_date": "2014-12-30 06:15:12",
    "modified_date": "2015-05-19 05:56:21",
    "lastlogin_date": "2015-05-19 05:30:20",
    "update_date": null,
    "member_count": 0,
    "view_count": 6,
    "location": "",
    "image": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
    "image_normal": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
    "image_profile": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
    "image_icon": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_icon.png",
    "content_url": "http://example.com/profile/dario",
    "cover": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png"
  }
}
Response  400
HideShow
Headers
Content-Type: application/json
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "validation_fail",
  "message": {
    "email": "Please complete this field - it is required.",
    "password": "Please complete this field - it is required."
  }
}

Validate Sign Up Form

Validate Sign Up Form
POST/signup/validations{?account_validation}

Validates the sign-up steps. You can break sign up into three steps:

  • Create Account: With the fields: email, password, timezone, language and profile type.

  • Profile Information: With the remaining profile fields.

  • Add Your Photo: With the profile photo field.

Validation can be done separately for the “Create Account” and “Profile Information” steps by passing their respective parameter in this API call.

Parameter Required Type Example Description
email yes string [email protected] email address
password yes string @#dskjfhd5$#das password
passconf yes string @#dskjfhd5$#das password
username yes string dario username
timezone yes string US/Mountain timezone
language yes string en language
terms yes boolean 1 agree with terms and conditions
1_1_3_alias_first_name yes string D profile fields
1_1_4_alias_last_name yes string Dario profile fields
Parameters
HideShow
account_validation
boolean (optional) Example: account_validation=1

validate “Create Account” fields of the sign up form. Default value is 1.

fields_validation
boolean (optional) Example: fields_validation=0

validate “Profile Information” fields of the sign up form. Default value is 1.

Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Body
{
    "email": "[email protected]",
    "password": "@#dskjfhd5$#das",
    "passconf": "@#dskjfhd5$#das",
    "username": "dario",
    "timezone": "US/Mountain",
    "language": "en",
    "terms": 1,
    "1_1_3_alias_first_name": M,
    "1_1_4_alias_last_name": Dario,
}
Response  204
Response  400
HideShow
Headers
Content-Type: application/json
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "validation_fail",
  "message": {
    "email": "Please complete this field - it is required.",
    "password": "Please complete this field - it is required."
  }
}

Members

These are APIs for various things related to member listings and profiles such as: Browse Members, Members Search, Profile Fields, Friends, etc.

Browse Members

Browse Members
GET/members{?profile_type}

Get the members listing. Members can also be browsed and searched based on profile field values.

In case of pagination, we need to use 2 parameters limit and page. Use limit to set the number of users in response and use page for the page number. [i.e: If you have 100 users and the first request has limit=20 and page=1, then in that case the recent 20 users will be returned in response, and if limit=20 and page=2 is sent in request, then the next 20 recent users will be returned.]

Parameters
HideShow
profile_type
integer (optional) Example: profile_type=1

get members of this profile type.

displayname
string (optional) Example: displayname=dario

get members with matching name.

has_photo
boolean (optional) Example: has_photo=1

get members with / without profile photo.

is_online
boolean (optional) Example: is_online=1

get members who are online / offline.

1_1_3_alias_first_name
string (optional) Example: 1_1_3_alias_first_name=dario

get members with matching value for this profile field. You can get the key name for profile field from the response of member search form.

1_1_4_alias_last_name
string (optional) Example: 1_1_4_alias_last_name=x

get members with matching value for this profile field. You can get the key name for profile field from the response of member search form.

page
integer (optional) Example: page=2

return the ‘limit’ number of users of that page of member listings.

limit
integer (optional) Example: limit=20

number of users. Default limit is 20.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "page": 1,
  "response": [
    {
      "user_id": 217,
      "username": "dario",
      "displayname": "Linus Dario",
      "photo_id": 25,
      "status": "",
      "status_date": "0000-00-00 00:00:00",
      "locale": "English",
      "language": "English",
      "timezone": "US/Pacific",
      "search": 1,
      "show_profileviewers": 1,
      "level_id": 4,
      "enabled": 1,
      "verified": 1,
      "approved": 1,
      "creation_date": "2014-11-20 05:57:44",
      "modified_date": "2015-03-30 10:11:06",
      "lastlogin_date": "2015-03-30 10:08:47",
      "update_date": null,
      "member_count": 0,
      "view_count": 148,
      "location": "",
      "image": "http://example.com/public/user/19/0019_3c26.png",
      "image_icon": "http://example.com/public/user/1c/001c_b8a4.png",
      "image_profile": "http://example.com/public/user/1a/001a_0453.png",
      "image_normal": "http://example.com/public/user/1b/001b_283c.png",
      "content_url": "http://example.com/profile/dario",
      "menus": ""
    },
    {
      "user_id": 4,
      "username": "test10",
      "displayname": "Ronald Desuza",
      "photo_id": 151,
      "status": null,
      "status_date": null,
      "locale": "English",
      "language": "English",
      "timezone": "US/Pacific",
      "search": 1,
      "show_profileviewers": 1,
      "level_id": 4,
      "enabled": 1,
      "verified": 1,
      "approved": 1,
      "creation_date": "2015-03-30 06:38:13",
      "modified_date": "2015-03-30 10:07:59",
      "lastlogin_date": "2015-03-30 06:38:14",
      "update_date": null,
      "member_count": 1,
      "view_count": 2,
      "location": "",
      "image": "http://example.com/public/user/97/0097_d975.jpg",
      "image_icon": "http://example.com/public/user/9a/009a_0f09.jpg",
      "image_profile": "http://example.com/public/user/98/0098_d975.jpg",
      "image_normal": "http://example.com/public/user/99/0099_0f09.jpg",
      "content_url": "http://example.com/profile/dario",
      "menus": {
        "label": "Add Friend",
        "name": "add_friend",
        "url": "user/add",
        "urlParams": {
          "user_id": 4
        }
      }
    }
  ],
  "totalItemCount": 44
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Members Search Form

Members Search Form
GET/members/search-form

Get the search / filter members form. The search / filter parameters from this form will be used by ‘Browse Members’ API call to return results.

Response  200
HideShow
Headers
Accept: application/json
Body
{
  "form": [
    {
      "type": "Select",
      "name": "profile_type",
      "label": "Member Type",
      "multiOptions": {
        "1": "Regular Member",
        "": " "
      }
    },
    {
      "type": "Text",
      "name": "displayname",
      "label": "Name"
    },
    {
      "type": "Checkbox",
      "name": "has_photo",
      "label": "Only Members With Photos"
    },
    {
      "type": "Checkbox",
      "name": "is_online",
      "label": "Only Online Members"
    },
    {
      "type": "Submit",
      "name": "submit",
      "label": "Search"
    }
  ],
  "profile_fields": {
    "Personal Details": [
      {
        "type": "Text",
        "name": "1_1_3_alias_first_name",
        "label": "First Name",
        "description": "",
        "hasValidator": true
      },
      {
        "type": "Text",
        "name": "1_1_4_alias_last_name",
        "label": "Last Name",
        "description": "",
        "hasValidator": true
      },
      {
        "type": "Select",
        "name": "1_1_5_alias_gender",
        "label": "Gender",
        "description": "",
        "multiOptions": [
          "Male",
          "Female"
        ]
      },
      {
        "type": "Date",
        "name": "1_1_6_alias_birthdate",
        "label": "Birthday",
        "description": ""
      }
    ],
    "Personal Information": [
      {
        "type": "Textarea",
        "name": "1_1_13_alias_about_me",
        "label": "About Me",
        "description": "",
        "hasValidator": true
      }
    ]
  }
}

User Profile

User Profile
GET/user/profile/{user_id}{?gutter_menu}

Get the user profile information and various components of user profile (like tabs info, gutter menu, etc.).

Parameters
HideShow
user_id
integer (optional) Example: user_id=125

user id of profile owner. Default value is logged-in user’s ID.

gutter_menu
boolean (optional) Example: gutter_menu=1

get gutter menu’s array. Default value is 1.

profile_tabs
boolean (optional) Example: profile_tabs=1

get profile tabs array. Default value is 1.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "gutterMenu": [
    {
      "label": "Edit My Profile",
      "name": "user_home_edit",
      "url": "members/edit/profile",
      "urlParams": []
    },
    {
      "label": "Block Member",
      "name": "user_profile_block",
      "url": "block/add",
      "urlParams": {
        "user_id": 14
      }
    },
    {
      "label": "Report",
      "name": "user_profile_report",
      "url": "report/create/subject/user_14",
      "urlParams": {
        "type": "user",
        "id": 14
      }
    }
  ],
  "profile_tabs": [
    {
      "label": "Updates",
      "name": "update"
    },
    {
      "label": "Info",
      "name": "info"
    },
    {
      "label": "Friends",
      "name": "friends",
      "totalItemCount": 34
    },
    {
      "label": "Blogs",
      "name": "blog",
      "totalItemCount": 14
    },
    {
      "label": "Groups",
      "name": "group",
      "totalItemCount": 23
    },
    {
      "label": "Events",
      "name": "event",
      "totalItemCount": 75
    },
    {
      "label": "Albums",
      "name": "album",
      "totalItemCount": 24
    },
    {
      "label": "Classifieds",
      "name": "classified",
      "totalItemCount": 12
    },
    {
      "label": "Forum Posts",
      "name": "forum_topics",
      "totalItemCount": 2
    },
    {
      "label": "Music",
      "name": "music",
      "totalItemCount": 18
    },
    {
      "label": "Polls",
      "name": "poll",
      "totalItemCount": 5
    },
    {
      "label": "Videos",
      "name": "video",
      "totalItemCount": 45
    }
  ],
  "response": {
    "user_id": 14,
    "username": "dario",
    "displayname": "M Dario",
    "photo_id": 206,
    "status": null,
    "status_date": null,
    "locale": "en",
    "language": "en",
    "timezone": "US/Pacific",
    "search": 1,
    "show_profileviewers": 1,
    "level_id": 4,
    "enabled": 1,
    "verified": 1,
    "approved": 1,
    "creation_date": "2015-06-04 10:58:48",
    "modified_date": "2015-06-04 10:58:49",
    "lastlogin_date": "2015-06-04 10:58:49",
    "update_date": null,
    "member_count": 0,
    "view_count": 1,
    "location": "",
    "url": "http://example.com/profile/test51",
    "is_like": 0,
    "like_count": 0,
    "image": "http://example.com/public/user/ce/00ce_c36f.png?c=6e14",
    "image_normal": "http://example.com/public/user/d0/00d0_779e.png?c=9148",
    "image_profile": "http://example.com/public/user/cf/00cf_9c34.png?c=813e",
    "image_icon": "http://example.com/public/user/d1/00d1_01e3.png?c=23ab",
    "content_url": "http://example.com/profile/dario",
    "member_type": "Regular Member",
    "network_list": "",
    "friend_count": 0
  }
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}
Response  404
HideShow
Body
{
  "status_code": 404,
  "error": true,
  "error_code": "no_record",
  "message": "No record found"
}

Edit Profile Fields

Get Profile Fields Form
GET/members/edit/profile

Get the form for editing profile fields.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "form": {
    "Personal Details": [
      {
        "type": "Text",
        "name": "1_1_3_alias_first_name",
        "label": "First Name",
        "description": "",
        "hasValidator": true
      },
      {
        "type": "Text",
        "name": "1_1_4_alias_last_name",
        "label": "Last Name",
        "description": "",
        "hasValidator": true
      },
      {
        "type": "Select",
        "name": "1_1_5_alias_gender",
        "label": "Gender",
        "description": "",
        "multiOptions": [
          "Male",
          "Female"
        ]
      },
      {
        "type": "Date",
        "name": "1_1_6_alias_birthdate",
        "label": "Birthday",
        "description": ""
      }
    ],
    "Contact Information": [
      {
        "type": "Text",
        "name": "1_1_8_alias_",
        "label": "Website",
        "description": ""
      },
      {
        "type": "Text",
        "name": "1_1_9_alias_",
        "label": "Twitter",
        "description": ""
      },
      {
        "type": "Text",
        "name": "1_1_10_alias_",
        "label": "Facebook",
        "description": ""
      },
      {
        "type": "Text",
        "name": "1_1_11_alias_",
        "label": "AIM",
        "description": ""
      }
    ],
    "Personal Information": [
      {
        "type": "Textarea",
        "name": "1_1_13_alias_about_me",
        "label": "About Me",
        "description": "",
        "hasValidator": true
      },
      {
        "type": "Text",
        "name": "1_1_27_alias_website",
        "label": "Website",
        "description": "Enter Your Website:",
        "hasValidator": true
      }
    ]
  },
  "formValues": {
    "1_1_3_alias_first_name": {
      "value": "Alen",
      "privacy": "everyone"
    },
    "1_1_4_alias_last_name": {
      "value": "X",
      "privacy": "everyone"
    },
    "1_1_5_alias_gender": {
      "value": "",
      "privacy": "everyone"
    },
    "1_1_6_alias_birthdate": {
      "value": "",
      "privacy": "everyone"
    },
    "1_1_8_alias_": {
      "value": "",
      "privacy": "everyone"
    },
    "1_1_9_alias_": {
      "value": "",
      "privacy": "everyone"
    },
    "1_1_10_alias_": {
      "value": "",
      "privacy": "everyone"
    },
    "1_1_11_alias_": {
      "value": "",
      "privacy": "everyone"
    },
    "1_1_13_alias_about_me": {
      "value": "",
      "privacy": "everyone"
    },
    "1_1_27_alias_website": {
      "value": "http://example.com",
      "privacy": "everyone"
    }
  }
}
Response  400
HideShow
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "profile_type_missing",
  "message": "A Profile Type has not been configured for this user."
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Edit Profile Fields
PUT/members/edit/profile

Edit the profile fields values.

Parameter Required Type Example Description
1_1_3_alias_first_name yes string Alen First name
1_1_4_alias_last_name yes string J Last name
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "1_1_3_alias_first_name": "Alen",
  "1_1_4_alias_last_name": "J"
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Edit Profile Photo

Get Profile Photo Form
GET/members/edit/photo

Get the edit profile photo form.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
        "user_id":1,
        "username":"admin",
        "displayname":"Alen X",
        "photo_id":0,
        "status":"ewrewrwerwrr",
        "status_date":"2015-06-12 05:02:34",
        "locale":"fil_PH",
        "language":"en_US",
        "timezone":"Asia/Dubai",
        "search":0,
        "show_profileviewers":1,
        "level_id":1,
        "enabled":1,
        "verified":1,
        "approved":1,
        "creation_date":"2014-11-11 06:00:28",
        "modified_date":"2015-07-01 11:29:57",
        "lastlogin_date":"2015-07-03 14:14:02",
        "update_date":null,
        "member_count":1,
        "view_count":16,
        "location":"",
        "image":"http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
        "image_normal":"http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
        "image_profile":"http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
        "image_icon":"http://example.com/application/modules/User/externals/images/nophoto_user_thumb_icon.png",
        "content_url":"http://example.com/profile/dario",
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Change Profile Photo
POST/members/edit/photo

Change the profile photo.

To upload the profile photo, send the file in multipart / form-data format with the API request parameters.

Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Remove Profile Photo

Remove Profile Photo
DELETE/members/edit/remove-photo

Remove the profile photo.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Get User Info

Get User Info
GET/members/profile/get-member-info{?user_id}

Get the profile field values of the user.

Parameters
HideShow
user_id
integer (optional) Example: user_id=125

user id of profile owner. Default value is logged-in user’s ID.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "Personal Details": {
    "First Name": "Alen",
    "Last Name": "X"
  },
  "Personal Information": {
    "About Me": "It's all about me.",
    "Website": "http://example.com"
  }
}
Response  404
HideShow
Body
{
  "status_code": 404,
  "error": true,
  "error_code": "no_record",
  "message": "No record found"
}

Get Friends

Get Friends
GET/user/get-friend-list{?user_id}

Get the user’s friends.

In case of pagination, we need to use 2 parameters limit and page. Use limit to set the number of users in response and use page for the page number. [i.e: If you have 100 users and the first request has limit=20 and page=1, then in that case the recent 20 users will be returned in response, and if limit=20 and page=2 is sent in request, then the next 20 recent users will be returned.]

Parameters
HideShow
user_id
integer (optional) Example: user_id=125

user id of profile owner. Default value is logged-in user’s ID.

page
integer (optional) Example: page=2

use page to get next limit of friends.

limit
integer (optional) Example: limit=10

number of friends. Default limit is 10.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "totalItemCount": 1,
  "friends": [
    {
      "user_id": 3,
      "username": "dario",
      "displayname": "M Dario",
      "photo_id": 0,
      "status": null,
      "status_date": null,
      "locale": "English",
      "language": "English",
      "timezone": "US/Pacific",
      "search": 1,
      "show_profileviewers": 1,
      "level_id": 4,
      "enabled": 1,
      "verified": 1,
      "approved": 1,
      "creation_date": "2014-12-30 06:15:12",
      "modified_date": "2015-06-20 11:14:51",
      "lastlogin_date": "2015-06-20 10:03:48",
      "update_date": null,
      "member_count": 1,
      "view_count": 10,
      "location": "",
      "url": "http://example.com/profile/test2",
      "image": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
      "image_normal": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
      "image_profile": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
      "image_icon": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_icon.png",
      "content_url": "http://example.com/profile/dario",
      "menus": {
        "label": "Remove Friend",
        "name": "remove_friend",
        "url": "user/remove",
        "urlParams": {
          "user_id": 3
        }
      }
    }
  ]
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Create New List

Create New List
POST/user/list-create

Create a new list for friends.

Parameter Required Type Example Description
title yes string Family list title
friend_id no integer 178 friend id
Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "title": "Family",
  "friend_id": 178
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
167
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Add Friend To List

Add Friend To List
POST/user/list-add

Add a friend to the created list.

Parameter Required Type Example Description
list_id yes integer 69 list id
friend_id no integer 178 friend id
Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "list_id": 69,
  "friend_id": 178
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Remove Friend From List

Remove Friend From List
DELETE/user/list-remove

Remove a friend from a list.

Parameter Required Type Example Description
list_id yes integer 69 list id
friend_id no integer 178 friend id
Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "list_id": 69,
  "friend_id": 178
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Delete List

Delete List
DELETE/user/list-delete

Delete a friend list.

Parameter Required Type Example Description
list_id yes integer 45 list id
Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "list_id": 69
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Suggest Friends

Suggest Friends
GET/user/suggest{?search}

Get the list of friend to be suggested to the user. This API call is useful for auto-suggest fields.

Parameters
HideShow
search
string (optional) Example: search=alen

string to be matched with friends’ names.

user_id
integer (optional) Example: user_id=87

user id of profile owner. Default value is logged-in user’s ID.

guid
string (optional) Example: guid=siteevent_event_3

useful only for Xiglute “Groups / Communities Plugin” and “Advanced Events Plugin”. Return list of friends, who have joined the guid resource id.

limit
integer (optional) Example: limit=10

number of friends. Default limit is 10.

Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "type": "user",
    "id": 2,
    "guid": "user_2",
    "label": "James Robert",
    "photo": "http://example.com/public/user/41/02/023f_eabf.jpg"
  },
  {
    "type": "user",
    "id": 1,
    "guid": "user_1",
    "label": "Jennifer Aniston",
    "photo": "http://example.com/public/user/41/02/023f_eabf.jpg"
  }
]
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Member Actions

These APIs are for various actions related to members like add friend, remove friend, cancel friend request, accept friend request, block member, unblock member, etc.

Add Friend

Add Friend
POST/user/add

Send friend request to a user.

Parameter Required Type Example Description
user_id yes integer 67 user id to whom sent the friend request by logged-in user.
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "user_id": "67"
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Cancel Friend Request

Cancel Friend Request
POST/user/cancel

Cancel the friend request sent to a user.

Parameter Required Type Example Description
user_id yes integer 67 user id to whom cancel the sent friend request by logged-in user.
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "user_id": "67"
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Accept Friend Request

Accept Friend Request
POST/user/confirm

Accept a friend request.

Parameter Required Type Example Description
user_id yes integer 67 user id to whom accept the friend request by logged-in user.
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "user_id": "67"
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Reject Friend Request

Reject Friend Request
POST/user/reject

Reject a friend request.

Parameter Required Type Example Description
user_id yes integer 67 user id to whom reject the sent friend request by logged-in user.
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "user_id": "67"
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Remove Friend

Remove Friend
POST/user/remove

Remove friendship with a user.

Parameter Required Type Example Description
user_id yes integer 67 user id of the friend to remove as friend by logged-in user.
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "user_id": "67"
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Block Member

Block Member
POST/block/add

Block a user.

Parameter Required Type Example Description
user_id yes integer 67 user id to whom make it block by logged-in user.
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "user_id": "67"
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Unblock Member

Unblock Member
POST/block/remove

Unblock a user.

Parameter Required Type Example Description
user_id yes integer 67 user id to whom unblock by logged-in user.
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "user_id": "67"
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Make Profile Photo

Make Profile Photo
POST/members/edit/external-photo

Make an existing photo of the community as the profile photo.

Parameter Required Type Example Description
id no integer 67 user id of profile owner. Default value is logged-in user’s ID.
photo yes string group_photo_116 photo guide
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "id": "67",
  "photo": "group_photo_116"
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Member Settings

These APIs are for managing various member settings like:

  • General Settings: email address, profile address, timezone, locale, etc.

  • Privacy Settings

  • Network Settings: To join networks, leave networks, etc.

  • Notification Settings

  • Change Password

  • Delete Account

General Settings

Get General Settings Form
GET/members/settings/general

Get the member’s general settings form.

Returns the form and formValues as response. In form we get the complete general settings form and in formValues we get the form’s values.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "form": [
    {
      "type": "Text",
      "name": "email",
      "label": "Email Address",
      "hasValidator": true
    },
    {
      "type": "Text",
      "name": "username",
      "label": "Profile Address",
      "hasValidator": true
    },
    {
      "type": "Select",
      "name": "timezone",
      "label": "Timezone",
      "description": "Select the city closest to you that shares your same timezone.",
      "multiOptions": {
        "US/Pacific": "(UTC-8) Pacific Time (US & Canada)",
        "US/Mountain": "(UTC-7) Mountain Time (US & Canada)",
        "US/Central": "(UTC-6) Central Time (US & Canada)",
        "US/Eastern": "(UTC-5) Eastern Time (US & Canada)",
        "America/Halifax": "(UTC-4)  Atlantic Time (Canada)",
        "America/Anchorage": "(UTC-9)  Alaska (US & Canada)",
        "Pacific/Honolulu": "(UTC-10) Hawaii (US)",
        "Pacific/Samoa": "(UTC-11) Midway Island, Samoa",
        "Etc/GMT-12": "(UTC-12) Eniwetok, Kwajalein",
        "Canada/Newfoundland": "(UTC-3:30) Canada/Newfoundland",
        "America/Buenos_Aires": "(UTC-3) Brasilia, Buenos Aires, Georgetown",
        "Atlantic/South_Georgia": "(UTC-2) Mid-Atlantic",
        "Atlantic/Azores": "(UTC-1) Azores, Cape Verde Is.",
        "Europe/London": "Greenwich Mean Time (Lisbon, London)",
        "Europe/Berlin": "(UTC+1) Amsterdam, Berlin, Paris, Rome, Madrid",
        "Europe/Athens": "(UTC+2) Athens, Helsinki, Istanbul, Cairo, E. Europe",
        "Europe/Moscow": "(UTC+3) Baghdad, Kuwait, Nairobi, Moscow",
        "Iran": "(UTC+3:30) Tehran",
        "Asia/Dubai": "(UTC+4) Abu Dhabi, Kazan, Muscat",
        "Asia/Kabul": "(UTC+4:30) Kabul",
        "Asia/Yekaterinburg": "(UTC+5) Islamabad, Karachi, Tashkent",
        "Asia/Calcutta": "(UTC+5:30) Bombay, Calcutta, New Delhi",
        "Asia/Katmandu": "(UTC+5:45) Nepal",
        "Asia/Omsk": "(UTC+6) Almaty, Dhaka",
        "India/Cocos": "(UTC+6:30) Cocos Islands, Yangon",
        "Asia/Krasnoyarsk": "(UTC+7) Bangkok, Jakarta, Hanoi",
        "Asia/Hong_Kong": "(UTC+8) Beijing, Hong Kong, Singapore, Taipei",
        "Asia/Tokyo": "(UTC+9) Tokyo, Osaka, Sapporto, Seoul, Yakutsk",
        "Australia/Adelaide": "(UTC+9:30) Adelaide, Darwin",
        "Australia/Sydney": "(UTC+10) Brisbane, Melbourne, Sydney, Guam",
        "Asia/Magadan": "(UTC+11) Magadan, Soloman Is., New Caledonia",
        "Pacific/Auckland": "(UTC+12) Fiji, Kamchatka, Marshall Is., Wellington"
      }
    },
    {
      "type": "Select",
      "name": "locale",
      "label": "Locale",
      "description": "Dates, times, and other settings will be displayed using this locale setting.",
      "multiOptions": {
        "auto": "[Automatic]",
        "af_NA": "Afrikaans (Namibia)",
        "af_ZA": "Afrikaans (Timog Afrika)",
        "af": "Afrikaans",
        "am_ET": "Amharic (Ethiopia)",
        "am": "Amharic",
        "ar_AE": "Arabic (United Arab Emirates)",
        "ar_BH": "Arabic (Bahrain)",
        "ar_DZ": "Arabic (Algeria)",
        "ar_EG": "Arabic (Ehipto)",
        "ar_IQ": "Arabic (Iraq)",
        "ar_JO": "Arabic (Jordan)",
        "ar_LB": "Arabic (Lebanon)",
        "ar_LY": "Arabic (Libya)",
        "ar_MA": "Arabic (Morocco)",
        "ar_OM": "Arabic (Oman)",
        "ar_SA": "Arabic (Saudi Arabya)",
        "ar_SD": "Arabic (Sudan)",
        "ar_SY": "Arabic (Syria)",
        "ar_TN": "Arabic (Tunisia)",
        "ar_YE": "Arabic (Yemen)",
        "ar": "Arabic",
        "as_IN": "Assamese (India)",
        "as": "Assamese",
        "az_AZ": "Azerbaijani (Azerbaijan)",
        "az": "Azerbaijani",
        "be_BY": "Belarusian (Belarus)",
        "be": "Belarusian",
        "bg_BG": "Bulgarian (Bulgaria)",
        "bg": "Bulgarian",
        "bn_BD": "Bengali; Bangla (Bangladesh)",
        "bn_IN": "Bengali; Bangla (India)",
        "bn": "Bengali; Bangla",
        "bs_BA": "Bosnian (Bosnia and Herzegovina)",
        "bs": "Bosnian",
        "ca_ES": "Catalan (Espanya)",
        "ca": "Catalan",
        "cs_CZ": "Czech (Czech Republic)",
        "cs": "Czech",
        "cy_GB": "Welsh (United Kingdom)",
        "cy": "Welsh",
        "da_DK": "Danish (Denmark)",
        "da": "Danish",
        "de_AT": "Aleman (Austria)",
        "de_BE": "Aleman (Belgium)",
        "de_CH": "Aleman (Switzerland)",
        "de_DE": "Aleman (Alemaya)",
        "de_LI": "Aleman (Liechtenstein)",
        "de": "Aleman",
        "el_CY": "Griyego (Cyprus)",
        "el_GR": "Griyego (Griyego)",
        "el": "Griyego",
        "en_AS": "Ingles (American Samoa)",
        "en_AU": "Ingles (Australia)",
        "en_BE": "Ingles (Belgium)",
        "en_BW": "Ingles (Botswana)",
        "en_BZ": "Ingles (Belize)",
        "en_CA": "Ingles (Canada)",
        "en_GB": "Ingles (UK)",
        "en_HK": "Ingles (Hong Kong SAR China)",
        "en_IE": "Ingles (Ireland)",
        "en_IN": "Ingles (India)",
        "en_MH": "Ingles (Marshall Islands)",
        "en_MP": "Ingles (Northern Mariana Islands)",
        "en_NA": "Ingles (Namibia)",
        "en_NZ": "Ingles (New Zealand)",
        "en_PH": "Ingles (Pilipinas)",
        "en_PK": "Ingles (Pakistan)",
        "en_TT": "Ingles (Trinidad and Tobago)",
        "en_UM": "Ingles (United States minor outlying islands)",
        "en_US": "Ingles (US)",
        "en_VI": "Ingles (U.S. Virgin Islands)",
        "en_ZA": "Ingles (Timog Afrika)",
        "en_ZW": "Ingles (Zimbabwe)",
        "en": "Ingles",
        "eo": "Esperanto",
        "es_AR": "Espanyol (Argentina)",
        "es_BO": "Espanyol (Bolivia)",
        "es_CL": "Espanyol (Chile)",
        "es_CO": "Espanyol (Colombia)",
        "es_CR": "Espanyol (Costa Rica)",
        "es_DO": "Espanyol (Dominican Republic)",
        "es_EC": "Espanyol (Ecuador)",
        "es_ES": "Espanyol (Espanya)",
        "es_HN": "Espanyol (Honduras)",
        "es_MX": "Espanyol (Mehiko)",
        "es_NI": "Espanyol (Nicaragua)",
        "es_PE": "Espanyol (Peru)",
        "es_PY": "Espanyol (Paraguay)",
        "es_SV": "Espanyol (El Salvador)",
        "es_US": "Espanyol (United States)",
        "es_UY": "Espanyol (Uruguay)",
        "es_VE": "Espanyol (Venezuela)",
        "es": "Espanyol",
        "et_EE": "Estonian (Estonia)",
        "et": "Estonian",
        "eu_ES": "Basque (Espanya)",
        "eu": "Basque",
        "fa_AF": "Persian (Afghanistan)",
        "fa_IR": "Persian (Iran)",
        "fa": "Persian",
        "fi_FI": "Finnish (Finland)",
        "fi": "Finnish",
        "fil_PH": "Filipino (Pilipinas)",
        "fil": "Filipino",
        "fo_FO": "Faroeso (Faroe Islands)",
        "fo": "Faroeso",
        "fr_BE": "Pranses (Belgium)",
        "fr_CA": "Pranses (Canada)",
        "fr_CH": "Pranses (Switzerland)",
        "fr_FR": "Pranses (Pranses)",
        "fr_SN": "Pranses (Senegal)",
        "fr": "Pranses",
        "ga_IE": "Irish (Ireland)",
        "ga": "Irish",
        "gl_ES": "Galician (Espanya)",
        "gl": "Galician",
        "gu_IN": "Gujarati (India)",
        "gu": "Gujarati",
        "he_IL": "Hebreo (Israel)",
        "he": "Hebreo",
        "hi_IN": "Hindu (India)",
        "hi": "Hindu",
        "hr_HR": "Croatian (Croatia)",
        "hr": "Croatian",
        "hu_HU": "Hungarian (Hungary)",
        "hu": "Hungarian",
        "hy_AM": "Armenian (Armenia)",
        "hy": "Armenian",
        "ia": "Interlingua",
        "id_ID": "Indonesian (Indonesia)",
        "id": "Indonesian",
        "is_IS": "Icelandic (Iceland)",
        "is": "Icelandic",
        "it_CH": "Italyano (Switzerland)",
        "it_IT": "Italyano (Italya)",
        "it": "Italyano",
        "ja_JP": "Japanese (Japan)",
        "ja": "Japanese",
        "ka_GE": "Georgian (Georgia)",
        "ka": "Georgian",
        "km_KH": "Khmer (Cambodia)",
        "km": "Khmer",
        "kn_IN": "Kannada (India)",
        "kn": "Kannada",
        "ko_KR": "Korean (Timog Korea)",
        "ko": "Korean",
        "ku_IQ": "Kurdish (Iraq)",
        "ku_IR": "Kurdish (Iran)",
        "ku_SY": "Kurdish (Syria)",
        "ku_TR": "Kurdish (Turkey)",
        "ku": "Kurdish",
        "ky_KG": "Kirghiz (Kyrgyzstan)",
        "ky": "Kirghiz",
        "ln_CD": "Lingala (Congo - Kinshasa)",
        "ln_CG": "Lingala (Congo)",
        "ln": "Lingala",
        "lo_LA": "Lao (Laos)",
        "lo": "Lao",
        "lt_LT": "Lithuanian (Lithuania)",
        "lt": "Lithuanian",
        "lv_LV": "Latvian (Latvia)",
        "lv": "Latvian",
        "mk_MK": "Macedonian (Macedonia)",
        "mk": "Macedonian",
        "ml_IN": "Malayalam (India)",
        "ml": "Malayalam",
        "mn_CN": "Mongolian (Tsina)",
        "mn_MN": "Mongolian (Mongolia)",
        "mn": "Mongolian",
        "mr_IN": "Marathi (India)",
        "mr": "Marathi",
        "ms_BN": "Malay (Brunei)",
        "ms_MY": "Malay (Malaysia)",
        "ms": "Malay",
        "mt": "Maltese",
        "ne_IN": "Nepali (India)",
        "ne_NP": "Nepali (Nepal)",
        "ne": "Nepali",
        "nl_BE": "Olandes (Belgium)",
        "nl_NL": "Olandes (Netherlands)",
        "nl": "Olandes",
        "nn_NO": "Norwegian Nynorsk (Norway)",
        "nn": "Norwegian Nynorsk",
        "no": "Norwegian",
        "oc_FR": "Occitan (Pranses)",
        "oc": "Occitan",
        "or_IN": "Oriya (India)",
        "or": "Oriya",
        "pa_IN": "Punjabi (India)",
        "pa_PK": "Punjabi (Pakistan)",
        "pa": "Punjabi",
        "pl_PL": "Polish (Poland)",
        "pl": "Polish",
        "ps_AF": "Pashto (Afghanistan)",
        "ps": "Pashto",
        "pt_BR": "Portuges (Brasil)",
        "pt_PT": "Portuges (Portugal)",
        "pt": "Portuges",
        "ro_MD": "Romanian (Moldova)",
        "ro_RO": "Romanian (Romania)",
        "ro": "Romanian",
        "ru_RU": "Ruso (Russia)",
        "ru_UA": "Ruso (Ukraine)",
        "ru": "Ruso",
        "sa_IN": "Sanskrit (India)",
        "sa": "Sanskrit",
        "sh_BA": "Serbo-Croatian (Bosnia and Herzegovina)",
        "sh_CS": "Serbo-Croatian (Serbia at Montenegro)",
        "sh": "Serbo-Croatian",
        "si_LK": "Sinhalese (Sri Lanka)",
        "si": "Sinhalese",
        "sk_SK": "Eslobak (Slovakia)",
        "sk": "Eslobak",
        "sl_SI": "Eslobenyan (Slovenia)",
        "sl": "Eslobenyan",
        "so_DJ": "Somali (Djibouti)",
        "so_ET": "Somali (Ethiopia)",
        "so_KE": "Somali (Kenya)",
        "so_SO": "Somali (Somalia)",
        "so": "Somali",
        "sq_AL": "Albanian (Albania)",
        "sq": "Albanian",
        "sr_BA": "Serbiran (Bosnia and Herzegovina)",
        "sr_CS": "Serbiran (Serbia at Montenegro)",
        "sr_ME": "Serbiran (Montenegro)",
        "sr_RS": "Serbiran (Serbia)",
        "sr": "Serbiran",
        "st_LS": "Sesoto (Lesotho)",
        "st_ZA": "Sesoto (Timog Afrika)",
        "st": "Sesoto",
        "sv_FI": "Suwiso (Finland)",
        "sv_SE": "Suwiso (Sweden)",
        "sv": "Suwiso",
        "sw_KE": "Swahili (Kenya)",
        "sw_TZ": "Swahili (Tanzania)",
        "sw": "Swahili",
        "ta_IN": "Tamil (India)",
        "ta": "Tamil",
        "te_IN": "Telugu (India)",
        "te": "Telugu",
        "th_TH": "Thai (Thailand)",
        "th": "Thai",
        "ti_ER": "Tigrinya (Eritrea)",
        "ti_ET": "Tigrinya (Ethiopia)",
        "ti": "Tigrinya",
        "tl": "Tagalog",
        "tr_TR": "Turko (Turkey)",
        "tr": "Turko",
        "ug_CN": "Uighur (Tsina)",
        "ug": "Uighur",
        "uk_UA": "Ukranian (Ukraine)",
        "uk": "Ukranian",
        "ur_IN": "Urdu (India)",
        "ur_PK": "Urdu (Pakistan)",
        "ur": "Urdu",
        "uz_AF": "Uzbeko (Afghanistan)",
        "uz_UZ": "Uzbeko (Uzbekistan)",
        "uz": "Uzbeko",
        "vi_VN": "Vietnamese (Vietnam)",
        "vi": "Vietnamese",
        "wo_SN": "Wolof (Senegal)",
        "wo": "Wolof",
        "xh_ZA": "Xhosa (Timog Afrika)",
        "xh": "Xhosa",
        "zh_CN": "zh (Tsina)",
        "zh_HK": "zh (Hong Kong SAR China)",
        "zh_MO": "zh (Macao)",
        "zh_TW": "zh (Taiwan)",
        "zh": "zh",
        "zu_ZA": "Zulu (Timog Afrika)",
        "zu": "Zulu"
      }
    },
    {
      "type": "Submit",
      "name": "submit",
      "label": "Save Changes"
    }
  ],
  "formValues": {
    "user_id": 134,
    "email": "[email protected]",
    "username": "dario",
    "displayname": "M Dario",
    "photo_id": 0,
    "status": "ewrewrwerwrr",
    "status_date": "2015-06-12 05:02:34",
    "locale": "fil_PH",
    "language": "en_US",
    "timezone": "Asia/Dubai",
    "search": 0,
    "show_profileviewers": 1,
    "level_id": 1,
    "enabled": 1,
    "verified": 1,
    "approved": 1,
    "creation_date": "2014-11-11 06:00:28",
    "modified_date": "2015-06-19 11:13:10",
    "lastlogin_date": "2015-06-20 05:04:01",
    "update_date": null,
    "member_count": 23,
    "view_count": 136,
    "location": ""
  }
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Edit General Settings
PUT/members/settings/general

Edit the member’s general settings.

Parameter Required Type Example Description
email yes string [email protected] member’s email
username yes string dario member’s username
timezone yes string US/Central member’s timezone
locale yes string en_US member’s locale
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "email": "[email protected]",
  "username": "dario",
  "timezone": "US/Central",
  "locale": "en_US"
}
Response  204
Response  400
HideShow
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "validation_fail",
  "message": {
    "email": "Please enter a valid email address.",
    "username": "Please enter a valid profile address."
  }
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Privacy Settings

Get Privacy Settings Form
GET/members/settings/privacy

Get the member’s privacy settings form.

Returns the form and formValues as response. In form we get the complete privacy settings form and in formValues we get the form’s values.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "form": [
    {
      "type": "Checkbox",
      "name": "search",
      "label": "Do not display me in searches, browsing members, or the \"Online Members\" list."
    },
    {
      "type": "Radio",
      "name": "privacy",
      "label": "Profile Privacy",
      "description": "Who can view your profile?",
      "multiOptions": {
        "owner": "Only Me",
        "member": "Only My Friends",
        "network": "Friends & Networks",
        "registered": "All Registered Members",
        "everyone": "Everyone"
      }
    },
    {
      "type": "Radio",
      "name": "comment",
      "label": "Profile Posting Privacy",
      "description": "Who can post on your profile?",
      "multiOptions": {
        "owner": "Only Me",
        "member": "Only My Friends",
        "network": "Friends & Networks",
        "registered": "All Registered Members"
      }
    },
    {
      "type": "MultiCheckbox",
      "name": "publishTypes",
      "label": "Recent Activity Privacy",
      "description": "Which of the following things do you want to have published about you in the recent activity feed? Note that changing this setting will only affect future news feed items.",
      "multiOptions": {
        "album_photo_new": "New photo albums",
        "blog_new": "New blog entries",
        "classified_new": "New classified listings",
        "comment_album": "Comments on your photo albums",
        "comment_album_photo": "Comments on your photos",
        "comment_blog": "Comments on your blogs",
        "comment_classified": "Comments on your classified listings",
        "comment_playlist": "Comments on your playlists",
        "comment_poll": "Comments on your polls",
        "comment_video": "Comments on your videos",
        "event_create": "New events",
        "event_join": "Joining an event",
        "event_photo_upload": "Uploading a photo to an event",
        "event_topic_create": "Creating an event discussion topic",
        "event_topic_reply": "Replying to an event discussion topic",
        "forum_promote": "Forum promotions",
        "forum_topic_create": "Creating a forum topic",
        "forum_topic_reply": "Replying to a forum topic",
        "friends": "When I become friends with someone",
        "group_create": "New groups",
        "group_join": "Joining a group",
        "group_photo_upload": "Uploading a group photo",
        "group_promote": "Group promotions",
        "group_topic_create": "Creating a group discussion topic",
        "group_topic_reply": "Replying to a group discussion topic",
        "music_playlist_new": "New playlists",
        "network_join": "Joining a network",
        "poll_new": "New polls",
        "post_self": "Posting a status update to your own profile",
        "post_self_link": "Posting a status update with link on your own profile",
        "post_self_music": "Posting a status update with music on your own profile",
        "post_self_photo": "Posting a status update with photo on your own profile",
        "post_self_video": "Posting a status update with video on your own profile",
        "profile_photo_update": "Changing your photo",
        "share": "Activity Feed Item Shared",
        "sitetagcheckin_add_to_map": "When someone adds current date while checking into any content posted by me.",
        "sitetagcheckin_album_photo_new": "When I add location to my photo albums (object).",
        "sitetagcheckin_checkin": "When I post only my location.",
        "sitetagcheckin_content": "When someone checks into any content posted by me.",
        "sitetagcheckin_lct_add_to_map": "When someone adds previous date while checking into any content posted by me.",
        "sitetagcheckin_location": "When I add location to my photos (object).",
        "sitetagcheckin_post": "When I add location while posting in a content.",
        "sitetagcheckin_post_self": "When I add location to my posts.",
        "sitetagcheckin_profile_photo": "When I add location to my profile photos (object).",
        "sitetagcheckin_status": "When I add location to my posts.",
        "sitetagcheckin_tagged_new": "When I add location to a photo in which my friends are already tagged.",
        "tagged": "Tagged",
        "video_new": "New videos"
      }
    },
    {
      "type": "Submit",
      "name": "submit",
      "label": "Save Changes"
    }
  ],
  "formValues": {
    "user_id": 134,
    "email": "[email protected]mple.com",
    "username": "dario",
    "displayname": "M Dario",
    "photo_id": 0,
    "status": "ewrewrwerwrr",
    "status_date": "2015-06-12 05:02:34",
    "locale": "fil_PH",
    "language": "en_US",
    "timezone": "Asia/Dubai",
    "search": 0,
    "show_profileviewers": 1,
    "level_id": 1,
    "enabled": 1,
    "verified": 1,
    "approved": 1,
    "creation_date": "2014-11-11 06:00:28",
    "modified_date": "2015-06-19 11:13:10",
    "lastlogin_date": "2015-06-20 05:04:01",
    "update_date": null,
    "member_count": 23,
    "view_count": 136,
    "location": ""
  }
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Edit Privacy Settings
PUT/members/settings/privacy

Edit the member’s privacy settings.

Parameter Required Type Example Description
search no boolean 1 do not display me in searches, browsing members, or the “Online Members” list.
privacy yes string everyone who all can view profile?
comment yes string registered who all can post on the profile?
publishTypes no array [“post_self_video”,“tagged”] activities about user that can be published in activity feeds.
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
    "search": 1,
    "privacy": "everyone",
    "comment": "registered",
    "publishTypes": '["post_self_photo","post_self_video","share","tagged"]'
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Network Settings

Get Networks List
GET/members/settings/network

Get the list of member’s “Available Networks” and “Joined Networks”.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "availableNetworks": [
    {
      "network_id": 5,
      "title": "Africa",
      "description": "",
      "field_id": 0,
      "pattern": null,
      "member_count": 0,
      "hide": 0,
      "assignment": 0
    },
    {
      "network_id": 4,
      "title": "Asia",
      "description": "",
      "field_id": 0,
      "pattern": null,
      "member_count": 0,
      "hide": 0,
      "assignment": 0
    },
    {
      "network_id": 6,
      "title": "Australia",
      "description": "",
      "field_id": 0,
      "pattern": null,
      "member_count": 0,
      "hide": 0,
      "assignment": 0
    },
    {
      "network_id": 3,
      "title": "Europe",
      "description": "",
      "field_id": 0,
      "pattern": null,
      "member_count": 0,
      "hide": 0,
      "assignment": 0
    },
    {
      "network_id": 1,
      "title": "North America",
      "description": "",
      "field_id": 0,
      "pattern": null,
      "member_count": 0,
      "hide": 0,
      "assignment": 0
    },
    {
      "network_id": 2,
      "title": "South America",
      "description": "",
      "field_id": 0,
      "pattern": null,
      "member_count": 0,
      "hide": 0,
      "assignment": 0
    }
  ],
  "joinedNetworks": [
    {
      "network_id": 7,
      "title": "Antarctica",
      "description": "",
      "field_id": 0,
      "pattern": null,
      "member_count": 1,
      "hide": 0,
      "assignment": 0
    }
  ]
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Join / Leave Network
POST/members/settings/network

Join or leave a network. The parameter passed must be join_id if user is joining a network, or it must be leave_id if user is leaving a network.

Parameter Required Type Example Description
join_id / leave_id yes integer 2 network id
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "join_id": 2,
  "leave_id": 5
}
Response  201
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Notification Settings

Get Notification Settings Form
GET/members/settings/notifications

Get the member’s notification settings form.

Returns the form and formValues as response. In form we get the complete notification settings form and in formValues we get the form’s values.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "form": [
    {
      "category": "General",
      "types": [
        {
          "type": "Checkbox",
          "name": "commented",
          "label": "When people comment on things I post."
        },
        {
          "type": "Checkbox",
          "name": "commented_commented",
          "label": "When people comment on the same thing as me."
        },
        {
          "type": "Checkbox",
          "name": "friend_accepted",
          "label": "When someone accepts my friend request."
        },
        {
          "type": "Checkbox",
          "name": "friend_request",
          "label": "When I receive a friend request."
        },
        {
          "type": "Checkbox",
          "name": "liked",
          "label": "When people like things I post."
        },
        {
          "type": "Checkbox",
          "name": "liked_commented",
          "label": "When people comment on things I've liked."
        },
        {
          "type": "Checkbox",
          "name": "message_new",
          "label": "When I receive a message."
        },
        {
          "type": "Checkbox",
          "name": "post_user",
          "label": "When people post on my profile."
        },
        {
          "type": "Checkbox",
          "name": "shared",
          "label": "When activity feed item is shared."
        },
        {
          "type": "Checkbox",
          "name": "tagged",
          "label": "When I'm tagged in photos and other places."
        }
      ]
    },
    {
      "category": "Advanced Activity Feeds / Wall Plugin",
      "types": [
        {
          "type": "Checkbox",
          "name": "aaf_tagged",
          "label": "When my content is tagged."
        }
      ]
    },
    {
      "category": "Blogs",
      "types": [
        {
          "type": "Checkbox",
          "name": "blog_subscribed_new",
          "label": "When a new blog entry is posted by a member you have subscribed to."
        }
      ]
    },
    {
      "category": "Events",
      "types": [
        {
          "type": "Checkbox",
          "name": "event_accepted",
          "label": "When my request to attend an event is approved."
        },
        {
          "type": "Checkbox",
          "name": "event_approve",
          "label": "When someone request to join my event."
        },
        {
          "type": "Checkbox",
          "name": "event_discussion_reply",
          "label": "When people reply to discussion topics that I've replied to."
        },
        {
          "type": "Checkbox",
          "name": "event_discussion_response",
          "label": "When people reply to discussion topics that I create."
        },
        {
          "type": "Checkbox",
          "name": "event_invite",
          "label": "When I'm invited to attend an event."
        }
      ]
    },
    {
      "category": "Forum",
      "types": [
        {
          "type": "Checkbox",
          "name": "forum_promote",
          "label": "When I'm given moderator status in a forum."
        },
        {
          "type": "Checkbox",
          "name": "forum_topic_reply",
          "label": "When people reply to forum topics that I've replied to."
        },
        {
          "type": "Checkbox",
          "name": "forum_topic_response",
          "label": "When people reply to forum topics that I create."
        }
      ]
    },
    {
      "category": "Groups",
      "types": [
        {
          "type": "Checkbox",
          "name": "group_accepted",
          "label": "When my request to join a group is approved."
        },
        {
          "type": "Checkbox",
          "name": "group_approve",
          "label": "When someone requests to join a group I created."
        },
        {
          "type": "Checkbox",
          "name": "group_discussion_reply",
          "label": "When people reply to discussion topics that I've replied to."
        },
        {
          "type": "Checkbox",
          "name": "group_discussion_response",
          "label": "When people reply to discussion topics that I create."
        },
        {
          "type": "Checkbox",
          "name": "group_invite",
          "label": "When I'm invited to join a group."
        },
        {
          "type": "Checkbox",
          "name": "group_promote",
          "label": "When I'm given officer status in a group."
        }
      ]
    },
    {
      "category": "Geo-Location, Geo-Tagging, Check-Ins & Proximity Search Plugin",
      "types": [
        {
          "type": "Checkbox",
          "name": "sitetagcheckin_business_tagged",
          "label": "When someone adds my business as location."
        },
        {
          "type": "Checkbox",
          "name": "sitetagcheckin_page_tagged",
          "label": "When someone adds my page as location."
        },
        {
          "type": "Checkbox",
          "name": "sitetagcheckin_tagged",
          "label": "When I am tagged-in a post."
        },
        {
          "type": "Checkbox",
          "name": "sitetagcheckin_tagged_location",
          "label": "When location is added to the photo (object) I'm tagged-in."
        }
      ]
    },
    {
      "category": "Videos",
      "types": [
        {
          "type": "Checkbox",
          "name": "video_processed",
          "label": "When a video has been processed."
        },
        {
          "type": "Checkbox",
          "name": "video_processed_failed",
          "label": "When a video has failed to be processed."
        }
      ]
    }
  ],
  "formValues": [
    "aaf_tagged",
    "blog_subscribed_new",
    "event_accepted",
    "event_approve",
    "event_discussion_reply",
    "event_discussion_response",
    "event_invite",
    "forum_topic_response",
    "friend_accepted",
    "friend_request",
    "group_accepted",
    "group_approve",
    "group_discussion_reply",
    "group_discussion_response",
    "group_invite",
    "group_promote",
    "liked",
    "liked_commented",
    "message_new",
    "post_user",
    "shared",
    "sitetagcheckin_business_tagged",
    "sitetagcheckin_page_tagged",
    "sitetagcheckin_tagged",
    "sitetagcheckin_tagged_location",
    "tagged",
    "video_processed",
    "video_processed_failed"
  ]
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Edit Notification Settings
PUT/members/settings/notifications

Edit the member’s notification settings.

If any notification type’s parameter is not sent in request, then its notifications will get disabled.

Parameter Required Type Example Description
event_accepted no boolean 1 enable notification
forum_topic_response no boolean 1 enable notification
group_accepted no boolean 1 enable notification
liked no boolean 1 enable notification
liked_commented no boolean 1 enable notification
message_new no boolean 1 enable notification
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "event_accepted": 1,
  "forum_topic_response": 1,
  "group_accepted": 1,
  "liked": 1,
  "liked_commented": 1,
  "message_new": 1
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Change Password

Get Change Password Form
GET/members/settings/password

Get the member’s change password form.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "type": "Password",
    "name": "oldPassword",
    "label": "Old Password",
    "hasValidator": true
  },
  {
    "type": "Password",
    "name": "password",
    "label": "New Password",
    "description": "Passwords must be at least 6 characters in length.",
    "hasValidator": true
  },
  {
    "type": "Password",
    "name": "passwordConfirm",
    "label": "New Password (again)",
    "description": "Enter your password again for confirmation.",
    "hasValidator": true
  },
  {
    "type": "Submit",
    "name": "submit",
    "label": "Change Password"
  }
]
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Edit Password
POST/members/settings/password

Edit the member’s password.

Parameter Required Type Example Description
oldPassword yes string @*&adad%$34F#$ old password
password yes string @*&ada534gsgd%$34F#$ new password
passwordConfirm yes string @*&ada534gsgd%$34F#$ new password
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "oldPassword": "@*&adad%$34F#$",
  "password": "@*&ada534gsgd%$34F#$",
  "passwordConfirm": "@*&ada534gsgd%$34F#$"
}
Response  204
Response  400
HideShow
Headers
Content-Type: application/json
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "validation_fail",
  "message": {
    "oldPassword": "Please complete this field - it is required.",
    "password": "Please complete this field - it is required.",
    "passwordConfirm": "Please complete this field - it is required."
  }
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Delete Account

Delete Account
DELETE/members/settings/delete

Delete the member’s account.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Notifications

These APIs are for various things related to notifications like fetching all notifications, friend requests, new notifications count, messages count, marking notifications as read, etc.

Get Notifications

Get Notifications
GET/notifications{?myRequests}

Get the member’s notifications of various types.

In case of pagination, we need to use 2 parameters limit and page. Use limit to set the number of notifications in response and use page for the page number. [i.e: If you have 100 notifications and the first request has limit=20 and page=1, then in that case the recent 20 notifications will be returned in response, and if limit=20 and page=2 is sent in request, then the next 20 recent notifications will be returned.]

Parameters
HideShow
myRequests
boolean (optional) Example: myRequests=0

get notifications of “My Requests” section. Default value is 1.

recentUpdates
boolean (optional) Example: recentUpdates=0

get notifications of “Recent Updates” section. Default value is 1

subject
boolean (optional) Example: subject=0

get array of notification’s subject with each notification.

object
boolean (optional) Example: object=0

get array of notification’s object with each notification.

page
integer (optional) Example: page=2

return the ‘limit’ number of notifications of that page of notification listings.

limit
integer (optional) Example: limit=10

number of notifications. Default limit is 10.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "requestTotalItemCount": 1,
  "myRequests": [
    {
      "notification_id": 124,
      "user_id": 3,
      "subject_type": "user",
      "subject_id": 1,
      "object_type": "user",
      "object_id": 3,
      "type": "friend_request",
      "params": null,
      "read": 0,
      "mitigated": 0,
      "date": "2015-06-20 10:14:15",
      "show": 0,
      "action_type_body": "{item:$subject} has requested to be your friend.",
      "feed_title": "M Dario has requested to be your friend.",
      "action_type_body_params": [
        {
          "search": "{item:$subject}",
          "label": "M Dario",
          "type": "user",
          "id": 1
        }
      ],
      "request_action": {
        "label": "Accept Request",
        "name": "accept_request",
        "url": "user/confirm",
        "urlParams": {
          "user_id": 1
        }
      },
      "subject": {
        "user_id": 123,
        "username": "dario",
        "displayname": "M Dario",
        "photo_id": 0,
        "status": "ewrewrwerwrr",
        "status_date": "2015-06-12 05:02:34",
        "locale": "fil_PH",
        "language": "en_US",
        "timezone": "Asia/Dubai",
        "search": 0,
        "show_profileviewers": 1,
        "level_id": 1,
        "enabled": 1,
        "verified": 1,
        "approved": 1,
        "creation_date": "2014-11-11 06:00:28",
        "modified_date": "2015-06-19 11:13:10",
        "lastlogin_date": "2015-06-20 10:13:46",
        "update_date": null,
        "member_count": 0,
        "view_count": 16,
        "location": "",
        "image": "",
        "image_icon": "",
        "image_profile": "",
        "image_normal": ""
      },
      "object": {
        "user_id": 233,
        "username": "john",
        "displayname": "K John",
        "photo_id": 0,
        "status": null,
        "status_date": null,
        "locale": "English",
        "language": "English",
        "timezone": "US/Pacific",
        "search": 1,
        "show_profileviewers": 1,
        "level_id": 4,
        "enabled": 1,
        "verified": 1,
        "approved": 1,
        "creation_date": "2014-12-30 06:15:12",
        "modified_date": "2015-05-19 05:56:21",
        "lastlogin_date": "2015-06-20 10:03:48",
        "update_date": null,
        "member_count": 0,
        "view_count": 9,
        "location": "",
        "image": "",
        "image_icon": "",
        "image_profile": "",
        "image_normal": ""
      }
    }
  ],
  "recentUpdateTotalItemCount": 15,
  "recentUpdates": [
    {
      "notification_id": 117,
      "user_id": 3,
      "subject_type": "user",
      "subject_id": 1,
      "object_type": "activity_action",
      "object_id": 170,
      "type": "tagged",
      "params": {
        "object_type_name": "post",
        "label": "post"
      },
      "read": 0,
      "mitigated": 0,
      "date": "2015-05-28 10:30:36",
      "show": 1,
      "action_type_body": "{item:$subject} tagged you in a {item:$object:$label}.",
      "feed_title": "M Dario tagged you in a post.",
      "action_type_body_params": [
        {
          "search": "{item:$subject}",
          "label": "M Dario",
          "type": "user",
          "id": 123
        },
        {
          "search": "{item:$object:$label}",
          "label": "post",
          "type": "",
          "id": ""
        }
      ],
      "subject": {
        "user_id": 1,
        "username": "dario",
        "displayname": "M Dario",
        "photo_id": 0,
        "status": "ewrewrwerwrr",
        "status_date": "2015-06-12 05:02:34",
        "locale": "fil_PH",
        "language": "en_US",
        "timezone": "Asia/Dubai",
        "search": 0,
        "show_profileviewers": 1,
        "level_id": 1,
        "enabled": 1,
        "verified": 1,
        "approved": 1,
        "creation_date": "2014-11-11 06:00:28",
        "modified_date": "2015-06-19 11:13:10",
        "lastlogin_date": "2015-06-20 10:13:46",
        "update_date": null,
        "member_count": 0,
        "view_count": 16,
        "location": "",
        "image": "",
        "image_icon": "",
        "image_profile": "",
        "image_normal": ""
      },
      "object": {
        "action_id": 170,
        "type": "post_self",
        "subject_type": "user",
        "subject_id": 1,
        "object_type": "user",
        "object_id": 1,
        "body": "Good News!",
        "params": "[]",
        "date": "2015-05-28 09:28:10",
        "attachment_count": 1,
        "comment_count": 2,
        "like_count": 1,
        "privacy": null,
        "commentable": 1,
        "shareable": 1,
        "user_agent": null,
        "image": "",
        "image_icon": "",
        "image_profile": "",
        "image_normal": ""
      }
    },
    {
      "notification_id": 103,
      "user_id": 3,
      "subject_type": "user",
      "subject_id": 1,
      "object_type": "blog",
      "object_id": 18,
      "type": "blog_subscribed_new",
      "params": null,
      "read": 0,
      "mitigated": 0,
      "date": "2015-05-06 06:05:16",
      "show": 1,
      "action_type_body": "{item:$subject} has posted a new blog entry: {item:$object}.",
      "feed_title": "M Dario has posted a new blog entry: .",
      "action_type_body_params": [
        {
          "search": "{item:$subject}",
          "label": "M Dario",
          "type": "user",
          "id": 1
        },
        {
          "search": "{item:$object}",
          "label": "",
          "type": "blog",
          "id": 18
        }
      ],
      "subject": {
        "user_id": 1,
        "username": "dario",
        "displayname": "M Dario",
        "photo_id": 0,
        "status": "ewrewrwerwrr",
        "status_date": "2015-06-12 05:02:34",
        "locale": "fil_PH",
        "language": "en_US",
        "timezone": "Asia/Dubai",
        "search": 0,
        "show_profileviewers": 1,
        "level_id": 1,
        "enabled": 1,
        "verified": 1,
        "approved": 1,
        "creation_date": "2014-11-11 06:00:28",
        "modified_date": "2015-06-19 11:13:10",
        "lastlogin_date": "2015-06-20 10:13:46",
        "update_date": null,
        "member_count": 0,
        "view_count": 16,
        "location": "",
        "image": "",
        "image_icon": "",
        "image_profile": "",
        "image_normal": ""
      },
      "object": {
        "blog_id": 18,
        "title": "",
        "body": "",
        "owner_type": "user",
        "owner_id": 1,
        "category_id": 1,
        "creation_date": "2015-05-06 06:05:16",
        "modified_date": "2015-05-06 06:05:16",
        "view_count": 0,
        "comment_count": 0,
        "search": 1,
        "draft": 0,
        "image": "",
        "image_icon": "",
        "image_profile": "",
        "image_normal": ""
      }
    }
  ]
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Get Friend Requests

Get Friend Requests
GET/notifications/friend-request{?subject}

Get the member’s friend requests.

In case of pagination, we need to use 2 parameters limit and page. Use limit to set the number of friend requests in response and use page for the page number. [i.e: If you have 100 friend requests and the first request has limit=20 and page=1, then in that case the recent 20 friend requests will be returned in response, and if limit=20 and page=2 is sent in request, then the next 20 recent friend requests will be returned.]

Parameters
HideShow
subject
boolean (optional) Example: subject=0

get array of friend request’s subject with each friend request.

object
boolean (optional) Example: object=0

get array of friend request’s object with each notification

page
integer (optional) Example: page=2

return the ‘limit’ number of friend requests of that page of friend requests listing.

limit
integer (optional) Example: limit=10

number of friends request. Default limit is 10.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "totalItemCount": 1,
  "response": [
    {
      "notification_id": 124,
      "user_id": 3,
      "subject_type": "user",
      "subject_id": 1,
      "object_type": "user",
      "object_id": 3,
      "type": "friend_request",
      "params": null,
      "read": 0,
      "mitigated": 0,
      "date": "2015-06-20 10:14:15",
      "show": 1,
      "action_type_body": "{item:$subject} has requested to be your friend.",
      "feed_title": "M Dario has requested to be your friend.",
      "action_type_body_params": [
        {
          "search": "{item:$subject}",
          "label": "M Dario",
          "type": "user",
          "id": 1
        }
      ],
      "request_action": [
        {
          "label": "Accept Request",
          "name": "accept_request",
          "url": "user/confirm",
          "urlParams": {
            "user_id": 1
          }
        },
        {
          "label": "ignore request",
          "name": "ignore_request",
          "url": "user/reject",
          "urlParams": {
            "user_id": 1
          }
        }
      ],
      "subject": {
        "user_id": 123,
        "username": "dario",
        "displayname": "M Dario",
        "photo_id": 0,
        "status": "ewrewrwerwrr",
        "status_date": "2015-06-12 05:02:34",
        "locale": "fil_PH",
        "language": "en_US",
        "timezone": "Asia/Dubai",
        "search": 0,
        "show_profileviewers": 1,
        "level_id": 1,
        "enabled": 1,
        "verified": 1,
        "approved": 1,
        "creation_date": "2014-11-11 06:00:28",
        "modified_date": "2015-06-19 11:13:10",
        "lastlogin_date": "2015-06-20 10:13:46",
        "update_date": null,
        "member_count": 0,
        "view_count": 16,
        "location": "",
        "image": "",
        "image_icon": "",
        "image_profile": "",
        "image_normal": ""
      },
      "object": {
        "user_id": 323,
        "username": "john",
        "displayname": "K John",
        "photo_id": 0,
        "status": null,
        "status_date": null,
        "locale": "English",
        "language": "English",
        "timezone": "US/Pacific",
        "search": 1,
        "show_profileviewers": 1,
        "level_id": 4,
        "enabled": 1,
        "verified": 1,
        "approved": 1,
        "creation_date": "2014-12-30 06:15:12",
        "modified_date": "2015-05-19 05:56:21",
        "lastlogin_date": "2015-06-20 10:03:48",
        "update_date": null,
        "member_count": 0,
        "view_count": 9,
        "location": "",
        "image": "",
        "image_icon": "",
        "image_profile": "",
        "image_normal": ""
      }
    }
  ]
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Get New Updates Count

Get New Updates Count
GET/notifications/new-updates

Get the count of new notifications, messages and friend requests.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "notifications": 5,
  "friend_requests": 2,
  "messages": 7
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Mark all Notifications as Read

Mark all Notifications as Read
POST/notifications/markallread

Mark all notifications as read.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Mark a Notification as Read

Mark a Notification as Read
POST/notifications/markread

Mark a particular notification as read.

Parameter Required Type Example Description
action_id yes integer 564 notification id
Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "action_id": 564
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Messages

These APIs are for various things related to messages like fetching unread messages, fetching all inbox messages, marking messages as read, creating a new message, viewing a message, etc.

Get Inbox Messages

Get Inbox Messages
GET/messages/inbox{?page}

Get the inbox messages of a member.

In case of pagination, we need to use 2 parameters limit and page. Use limit to set the number of messages in response and use page for the page number. [i.e: If you have 100 messages and the first request has limit=20 and page=1, then in that case the recent 20 messages will be returned in response, and if limit=20 and page=2 is sent in request, then the next 20 recent messages will be returned.]

Parameters
HideShow
page
integer (optional) Example: page=2

return the ‘limit’ number of messages of that page of message listings.

limit
integer (optional) Example: limit=10

number of messages. Default limit is 10.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "getTotalItemCount": 1,
  "getUnreadMessageCount": 1,
  "response": [
    {
      "message": {
        "message_id": 13,
        "conversation_id": 4,
        "user_id": 1,
        "title": "Hello Michael",
        "body": "How are you?",
        "date": "2015-06-20 11:15:15",
        "attachment_type": "",
        "attachment_id": 0,
        "recipients_count": 1
      },
      "recipient": {
        "user_id": 3,
        "conversation_id": 4,
        "inbox_message_id": 13,
        "inbox_updated": "2015-06-20 11:15:15",
        "inbox_read": 0,
        "inbox_deleted": 0,
        "outbox_message_id": 0,
        "outbox_updated": null,
        "outbox_deleted": 1,
        "inbox_view": 1
      },
      "sender": {
        "user_id": 134,
        "username": "john",
        "displayname": "K John",
        "photo_id": 0,
        "status": "ewrewrwerwrr",
        "status_date": "2015-06-12 05:02:34",
        "locale": "fil_PH",
        "language": "en_US",
        "timezone": "Asia/Dubai",
        "search": 0,
        "show_profileviewers": 1,
        "level_id": 1,
        "enabled": 1,
        "verified": 1,
        "approved": 1,
        "creation_date": "2014-11-11 06:00:28",
        "modified_date": "2015-06-20 11:14:51",
        "lastlogin_date": "2015-06-20 10:13:46",
        "update_date": null,
        "member_count": 1,
        "view_count": 16,
        "location": "",
        "image": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
        "image_normal": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
        "image_profile": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
        "image_icon": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_icon.png",
        "content_url": "http://example.com/profile/dario"
      }
    }
  ]
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Get Outbox Messages

Get Outbox Messages
GET/messages/outbox{?page}

Get the outbox messages of a member.

In case of pagination, we need to use 2 parameters limit and page. Use limit to set the number of messages in response and use page for the page number. [i.e: If you have 100 messages and the first request has limit=20 and page=1, then in that case the recent 20 messages will be returned in response, and if limit=20 and page=2 is sent in request, then the next 20 recent messages will be returned.]

Parameters
HideShow
page
integer (optional) Example: page=2

return the ‘limit’ number of messages of that page of message listings.

limit
integer (optional) Example: limit=10

number of messages. Default limit is 10.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "getTotalItemCount": 1,
  "getUnreadMessageCount": 1,
  "response": [
    {
      "message": {
        "message_id": 14,
        "conversation_id": 5,
        "user_id": 3,
        "title": "Hiii",
        "body": "How are you ?",
        "date": "2015-06-20 11:35:53",
        "attachment_type": "",
        "attachment_id": 0,
        "recipients_count": 1
      },
      "recipient": {
        "user_id": 3,
        "conversation_id": 5,
        "inbox_message_id": null,
        "inbox_updated": null,
        "inbox_read": 1,
        "inbox_deleted": 1,
        "outbox_message_id": 14,
        "outbox_updated": "2015-06-20 11:35:53",
        "outbox_deleted": 0,
        "inbox_view": 0
      },
      "sender": {
        "user_id": 1,
        "username": "john",
        "displayname": "K John",
        "photo_id": 0,
        "status": "ewrewrwerwrr",
        "status_date": "2015-06-12 05:02:34",
        "locale": "fil_PH",
        "language": "en_US",
        "timezone": "Asia/Dubai",
        "search": 0,
        "show_profileviewers": 1,
        "level_id": 1,
        "enabled": 1,
        "verified": 1,
        "approved": 1,
        "creation_date": "2014-11-11 06:00:28",
        "modified_date": "2015-06-20 11:14:51",
        "lastlogin_date": "2015-06-20 10:13:46",
        "update_date": null,
        "member_count": 1,
        "view_count": 16,
        "location": "",
        "image": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
        "image_normal": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
        "image_profile": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
        "image_icon": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_icon.png",
        "content_url": "http://example.com/profile/dario"
      }
    }
  ]
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Mark Message as Read

Mark Message as Read
POST/messages/mark-message-read-unread

Mark a message as read.

Parameter Required Type Example Description
message_id yes integer 564 message id
is_read no integer 1 mark message a read (1) or unread (0). Default value is 0.
Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "message_id": 564
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

View Message

View Message
GET/messages/view/id/{conversation_id}

Get the information of a message conversation.

Parameters
HideShow
conversation_id
integer (required) Example: id=20

message conversation id

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "conversation": {
    "conversation_id": 4,
    "title": "Hello Michael",
    "user_id": 1,
    "recipients": 1,
    "modified": "2015-06-20 11:15:15",
    "locked": 0,
    "resource_type": null,
    "resource_id": 0
  },
  "messages": [
    {
      "message": {
        "message_id": 13,
        "conversation_id": 4,
        "user_id": 1,
        "title": "Hello Michael",
        "body": "How are you?",
        "date": "2015-06-20 11:15:15",
        "attachment_type": "",
        "attachment_id": 0
      },
      "recipient": {
        "user_id": 3,
        "conversation_id": 4,
        "inbox_message_id": 13,
        "inbox_updated": "2015-06-20 11:15:15",
        "inbox_read": 1,
        "inbox_deleted": 0,
        "outbox_message_id": 0,
        "outbox_updated": null,
        "outbox_deleted": 1,
        "inbox_view": 1
      },
      "sender": {
        "user_id": 123,
        "username": "john",
        "displayname": "K John",
        "photo_id": 0,
        "status": "ewrewrwerwrr",
        "status_date": "2015-06-12 05:02:34",
        "locale": "fil_PH",
        "language": "en_US",
        "timezone": "Asia/Dubai",
        "search": 0,
        "show_profileviewers": 1,
        "level_id": 1,
        "enabled": 1,
        "verified": 1,
        "approved": 1,
        "creation_date": "2014-11-11 06:00:28",
        "modified_date": "2015-06-20 11:14:51",
        "lastlogin_date": "2015-06-20 10:13:46",
        "update_date": null,
        "member_count": 1,
        "view_count": 16,
        "location": "",
        "image": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
        "image_normal": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
        "image_profile": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
        "image_icon": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_icon.png",
        "content_url": "http://example.com/profile/dario"
      }
    }
  ],
  "reply_form": [
    {
      "type": "Textarea",
      "name": "body"
    },
    {
      "type": "Submit",
      "name": "submit",
      "label": "Send Reply"
    }
  ]
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Send Reply
POST/messages/view/id/

Post a reply in a message conversation.

Parameter Required Type Example Description
body yes string I am fine, what about you. reply message
Parameters
HideShow
id
integer (required) Example: id=20

message conversation id

Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "body": "I am fine, what about you."
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "conversation": {
    "conversation_id": 4,
    "title": "Hello Michael",
    "user_id": 1,
    "recipients": 1,
    "modified": "2015-06-20 11:15:15",
    "locked": 0,
    "resource_type": null,
    "resource_id": 0
  },
  "messages": [
    {
      "message": {
        "message_id": 13,
        "conversation_id": 4,
        "user_id": 1,
        "title": "Hello Michael",
        "body": "How are you?",
        "date": "2015-06-20 11:15:15",
        "attachment_type": "",
        "attachment_id": 0
      },
      "recipient": {
        "user_id": 3,
        "conversation_id": 4,
        "inbox_message_id": 13,
        "inbox_updated": "2015-06-20 11:15:15",
        "inbox_read": 1,
        "inbox_deleted": 0,
        "outbox_message_id": 0,
        "outbox_updated": null,
        "outbox_deleted": 1,
        "inbox_view": 1
      },
      "sender": {
        "user_id": 123,
        "username": "john",
        "displayname": "K John",
        "photo_id": 0,
        "status": "ewrewrwerwrr",
        "status_date": "2015-06-12 05:02:34",
        "locale": "fil_PH",
        "language": "en_US",
        "timezone": "Asia/Dubai",
        "search": 0,
        "show_profileviewers": 1,
        "level_id": 1,
        "enabled": 1,
        "verified": 1,
        "approved": 1,
        "creation_date": "2014-11-11 06:00:28",
        "modified_date": "2015-06-20 11:14:51",
        "lastlogin_date": "2015-06-20 10:13:46",
        "update_date": null,
        "member_count": 1,
        "view_count": 16,
        "location": "",
        "image": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
        "image_normal": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
        "image_profile": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
        "image_icon": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_icon.png",
        "content_url": "http://example.com/profile/dario"
      }
    }
  ],
  "reply_form": [
    {
      "type": "Textarea",
      "name": "body"
    },
    {
      "type": "Submit",
      "name": "submit",
      "label": "Send Reply"
    }
  ]
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Compose New Message

Get Message Form
GET/messages/compose

Get the compose message form.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "type": "Text",
    "label": "Send To",
    "name": "toValues"
  },
  {
    "type": "Text",
    "label": "Subject",
    "name": "title"
  },
  {
    "type": "Textarea",
    "label": "Message",
    "name": "body"
  },
  {
    "type": "Submit",
    "name": "submit",
    "label": "Send Message"
  }
]
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Post New Message
POST/messages/compose

Create a new message.

Parameter Required Type Example Description
toValues yes string 12, 45, 65 comma separated friend ids
title yes string Hello message title
body yes string How are you? message body
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "toValues": "12, 45, 65",
  "title": "Hello",
  "body": "How are you?"
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Delete Message Conversations

Delete Message Conversations
POST/messages/delete

Delete message conversations.

Parameter Required Type Example Description
conversation_ids yes string 123, 64, 234 comma separated message conversation ids
Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "conversation_ids": "123, 64, 234"
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Likes and Comments

These APIs are for features related to likes and comments on various content like blogs, classifieds, photos, etc, as well as on user profiles.

Get Likes and Comments

Get Likes and Comments
GET/likes-comments{?subject_type}

Get likes and comments for any content, user or comment.

In case of pagination, we need to use 2 parameters limit and page. Use limit to set the number of likes and / or comments in response and use page for the page number. [i.e: If you have 100 likes / comments and the first request has limit=20 and page=1, then in that case the recent 20 likes / comments will be returned in response, and if limit=20 and page=2 is sent in request, then the next 20 recent likes / comments will be returned.]

Parameters
HideShow
subject_type
string (required) Example: subject_type=blog

content item type

subject_id
integer (required) Example: subject_id=123

content item id

comment_id
integer (optional) Example: comment_id=120

comment id (if likes need to be fetched for a comment)

viewAllLikes
boolean (optional) Example: viewAllLikes=0

get users who like this content. Default value is 1.

viewAllComments
boolean (optional) Example: viewAllComments=0

get comments on this content. Default value is 1.

order
string (optional) Example: order=DESC

return comments in order. Default order is ASC.

page
integer (optional) Example: page=2

use page to get next limit of likes / comments.

limit
integer (optional) Example: limit=20

number of likes / comments. Default limit is 20.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "viewAllLikesBy": [
    {
      "user_id": 143,
      "username": "john",
      "displayname": "H John",
      "photo_id": 0,
      "status": null,
      "status_date": null,
      "locale": "English",
      "language": "English",
      "timezone": "US/Pacific",
      "search": 1,
      "show_profileviewers": 1,
      "level_id": 4,
      "enabled": 1,
      "verified": 1,
      "approved": 1,
      "creation_date": "2014-12-30 06:15:12",
      "modified_date": "2015-06-20 11:14:51",
      "lastlogin_date": "2015-06-20 10:03:48",
      "update_date": null,
      "member_count": 1,
      "view_count": 10,
      "location": "",
      "image": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
      "image_normal": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
      "image_profile": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
      "image_icon": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_icon.png",
      "content_url": "http://example.com/profile/dario"
    },
    {
      "user_id": 231,
      "username": "adario",
      "displayname": "A Michael",
      "photo_id": 0,
      "status": "ewrewrwerwrr",
      "status_date": "2015-06-12 05:02:34",
      "locale": "fil_PH",
      "language": "en_US",
      "timezone": "Asia/Dubai",
      "search": 0,
      "show_profileviewers": 1,
      "level_id": 1,
      "enabled": 1,
      "verified": 1,
      "approved": 1,
      "creation_date": "2014-11-11 06:00:28",
      "modified_date": "2015-06-20 11:14:51",
      "lastlogin_date": "2015-06-20 10:13:46",
      "update_date": null,
      "member_count": 1,
      "view_count": 16,
      "location": "",
      "image": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
      "image_normal": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
      "image_profile": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
      "image_icon": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_icon.png",
      "content_url": "http://example.com/profile/dario"
    }
  ],
  "viewAllComments": [
    {
      "comment_id": 5,
      "image": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
      "image_normal": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
      "image_profile": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
      "image_icon": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_icon.png",
      "content_url": "http://example.com/profile/dario",
      "author_title": "A Michael",
      "comment_body": "How are you friends?",
      "comment_date": "2015-01-13 09:46:38",
      "like_count": 2,
      "delete": {
        "name": "delete",
        "label": "Delete",
        "url": "comment-delete",
        "urlParams": {
          "subject_type": "blog",
          "subject_id": 10,
          "comment_id": 5
        }
      },
      "like": {
        "name": "unlike",
        "label": "Unlike",
        "url": "unlike",
        "urlParams": {
          "subject_type": "blog",
          "subject_id": 10,
          "comment_id": 5
        },
        "isLike": 1
      }
    },
    {
      "comment_id": 6,
      "image": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
      "image_normal": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
      "image_profile": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
      "image_icon": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_icon.png",
      "content_url": "http://example.com/profile/dario",
      "author_title": "M John",
      "comment_body": "Just Exploring...",
      "comment_date": "2015-01-15 10:39:10",
      "like_count": 1,
      "delete": {
        "name": "delete",
        "label": "Delete",
        "url": "comment-delete",
        "urlParams": {
          "subject_type": "blog",
          "subject_id": 10,
          "comment_id": 6
        }
      },
      "like": {
        "name": "unlike",
        "label": "Unlike",
        "url": "unlike",
        "urlParams": {
          "subject_type": "blog",
          "subject_id": 10,
          "comment_id": 6
        },
        "isLike": 1
      }
    }
  ],
  "isLike": 1,
  "canComment": 1,
  "canDelete": 1,
  "getTotalComments": 2,
  "getTotalLikes": 2
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}
Response  404
HideShow
Body
{
  "status_code": 404,
  "error": true,
  "error_code": "no_record",
  "message": "No record found"
}

Like

Like
POST/like

Like a content, user or a comment.

Parameter Required Type Example Description
subject_type yes string blog content item type
subject_id yes integer 125 content item id
comment_id no integer 564 comment id (if liking a comment)
Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "subject_type": "blog",
  "subject_id": 125
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "already_liked",
  "message": "Item already liked."
}
Response  404
HideShow
Body
{
  "status_code": 404,
  "error": true,
  "error_code": "no_record",
  "message": "No record found"
}

Unlike

Unlike
POST/unlike

Unlike a content, user or a comment.

Parameter Required Type Example Description
subject_type yes string blog content item type
subject_id yes integer 125 content item id
comment_id no integer 564 comment id (if unliking a comment)
Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "subject_type": "blog",
  "subject_id": 125
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "already_unliked",
  "message": "Item already unliked."
}
Response  404
HideShow
Body
{
  "status_code": 404,
  "error": true,
  "error_code": "no_record",
  "message": "No record found"
}

Post Comment

Post Comment
POST/comment-create

Post a comment on a content.

Parameter Required Type Example Description
subject_type yes string blog content item type
subject_id yes integer 252 content item id
body yes string this is a good content comment body
Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "subject_type": "blog",
  "subject_id": 252,
  "body": "this is a good content"
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "comment_id": 18,
  "image": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
  "image_normal": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
  "image_profile": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
  "image_icon": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_icon.png",
  "content_url": "http://example.com/profile/dario",
  "author_title": "A Michael",
  "comment_body": "good content !!",
  "comment_date": "2015-06-20 12:59:12",
  "delete": {
    "name": "delete",
    "label": "Delete",
    "url": "comment-delete",
    "urlParams": {
      "subject_type": "blog",
      "subject_id": 10,
      "comment_id": 18
    }
  },
  "like": {
    "name": "like",
    "label": "Like",
    "url": "like",
    "urlParams": {
      "subject_type": "blog",
      "subject_id": 10,
      "comment_id": 18
    }
  }
}
Response  404
HideShow
Body
{
  "status_code": 404,
  "error": true,
  "error_code": "no_record",
  "message": "No record found"
}

Delete a Comment

Delete a Comment
DELETE/comment-delete

Delete a comment.

Parameter Required Type Example Description
subject_type yes string blog content item type
subject_id yes integer 252 content item id
comment_id yes integer 536 comment id
Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "subject_type": "blog",
  "subject_id": 252,
  "comment_id": 536
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}
Response  404
HideShow
Body
{
  "status_code": 404,
  "error": true,
  "error_code": "no_record",
  "message": "No record found"
}

Activity Feeds

APIs allow to Xiglute members to manage there feed and get paginated list of feeds, post new feed, share on feed and manage feed etc.

Get Activity Feeds

Get Activity Feeds
GET/activity{?limit}

Get the paginated list of feeds

In case of New Feeds Count call this API after some time interval[i.e: in every 30 second] with minid and feed_count_only then available newly feeds count will be return in response.

In case of pagination, we need to use 2 parameters limit and maxid. Use limit to set the number of feeds in response and use maxid for the page number. [i.e: If you have 100 feeds and the first request has limit=20 and maxid=0, then in that case the recent 20 feeds will be returned in response, and if limit=20 and maxid=286 is sent in request, then the next 20 recent feeds will be returned.]

Parameters
HideShow
maxid
integer (optional) Example: maxid=128

last feed id. Required in pagination

subject_type
string (optional) Example: subject_type=blog

subject type. Required for content profile activity feeds

subject_id
integer (optional) Example: subject_id=128

subject id. Required for content profile activity feeds

minid
integer (optional) Example: minid=75

first feed id. Required to get new feeds count

action_id
integer (optional) Example: action_id=167

get single activity feed information

viewAllLikes
boolean (optional) Example: viewAllLikes=1

get feed all likes information. Default value is 0

viewAllComments
boolean (optional) Example: viewAllComments=1

get feed all comments information . Default value is 0

feed_count_only
boolean (optional) Example: feed_count_only=1

get only feed count in response. Required to get new feeds count

getUpdate
boolean (optional) Example: getUpdates=1

get newly updates information. Default value is 0

checkUpdate
boolean (optional) Example: checkUpdate=1

Check is any update exist. Default value is 0

post_menu
boolean (optional) Example: post_menu=1

get feed menus in response. Default value is 1

limit
integer (optional) Example: limit=20

number of feeds. Default limit is 15.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Response  200
HideShow
Headers
Content-Type: application/json
Body
{  
        "data":[  
            {  
                "feed":{  
                    "action_id":217,
                    "type":"group_create",
                    "subject_type":"user",
                    "subject_id":1,
                    "object_type":"group",
                    "object_id":13,
                    "body":"",
                    "params":"[]",
                    "date":"2015-07-01 11:29:57",
                    "attachment_count":1,
                    "comment_count":0,
                    "like_count":0,
                    "privacy":null,
                    "commentable":1,
                    "shareable":1,
                    "user_agent":null,
                    "main_content":"Alen X created a new group:",
                    "time_value":1435750197,
                    "subject":{  
                        "user_id":254,
                        "username":"alenx",
                        "displayname":"Alen X",
                        "photo_id":0,
                        "status":"",
                        "status_date":"2015-06-12 05:02:34",
                        "locale":"fil_PH",
                        "language":"en_US",
                        "timezone":"Asia/Dubai",
                        "search":0,
                        "show_profileviewers":1,
                        "level_id":1,
                        "enabled":1,
                        "verified":1,
                        "approved":1,
                        "creation_date":"2014-11-11 06:00:28",
                        "modified_date":"2015-07-06 12:09:45",
                        "lastlogin_date":"2015-07-06 10:12:12",
                        "update_date":null,
                        "member_count":1,
                        "view_count":16,
                        "location":"",
                        "url":"http://example.com/profile/admin",
                        "image":"",
                        "image_icon":"",
                        "image_profile":"",
                        "image_normal":"",
                        "owner_title":"Alen X"
                    }
                }
            },
            {  
                "feed":{  
                    "action_id":216,
                    "type":"group_create",
                    "subject_type":"user",
                    "subject_id":1,
                    "object_type":"group",
                    "object_id":12,
                    "body":"",
                    "params":"[]",
                    "date":"2015-07-01 11:29:03",
                    "attachment_count":1,
                    "comment_count":0,
                    "like_count":0,
                    "privacy":null,
                    "commentable":1,
                    "shareable":1,
                    "user_agent":null,
                    "main_content":"Alen X created a new group:",
                    "time_value":1435750143,
                    "subject":{  
                        "user_id":154,
                        "username":"jhonx",
                        "displayname":"Jhon X",
                        "photo_id":0,
                        "status":"",
                        "status_date":"2015-06-12 05:02:34",
                        "locale":"fil_PH",
                        "language":"en_US",
                        "timezone":"Asia/Dubai",
                        "search":0,
                        "show_profileviewers":1,
                        "level_id":1,
                        "enabled":1,
                        "verified":1,
                        "approved":1,
                        "creation_date":"2014-11-11 06:00:28",
                        "modified_date":"2015-07-06 12:09:45",
                        "lastlogin_date":"2015-07-06 10:12:12",
                        "update_date":null,
                        "member_count":1,
                        "view_count":16,
                        "location":"",
                        "url":"http://example.com/profile/admin",
                        "image":"",
                        "image_icon":"",
                        "image_profile":"",
                        "image_normal":"",
                        "owner_title":"Alen X"
                    }
                }
            },
            {  
                "feed":{  
                    "action_id":211,
                    "type":"group_create",
                    "subject_type":"user",
                    "subject_id":1,
                    "object_type":"group",
                    "object_id":8,
                    "body":"",
                    "params":"[]",
                    "date":"2015-06-19 11:13:10",
                    "attachment_count":1,
                    "comment_count":1,
                    "like_count":0,
                    "privacy":null,
                    "commentable":1,
                    "shareable":1,
                    "user_agent":null,
                    "main_content":"Alen X created a new group:",
                    "time_value":1434712390,
                    "subject":{  
                        "user_id":165,
                        "username":"yued",
                        "displayname":"Yuv D",
                        "photo_id":0,
                        "status":"",
                        "status_date":"2015-06-12 05:02:34",
                        "locale":"fil_PH",
                        "language":"en_US",
                        "timezone":"Asia/Dubai",
                        "search":0,
                        "show_profileviewers":1,
                        "level_id":1,
                        "enabled":1,
                        "verified":1,
                        "approved":1,
                        "creation_date":"2014-11-11 06:00:28",
                        "modified_date":"2015-07-06 12:09:45",
                        "lastlogin_date":"2015-07-06 10:12:12",
                        "update_date":null,
                        "member_count":1,
                        "view_count":16,
                        "location":"",
                        "url":"http://example.com/profile/admin",
                        "image":"",
                        "image_icon":"",
                        "image_profile":"",
                        "image_normal":"",
                        "owner_title":"Alen X"
                    }
                }
            },
            {  
                "feed":{  
                    "action_id":210,
                    "type":"share",
                    "subject_type":"user",
                    "subject_id":1,
                    "object_type":"user",
                    "object_id":1,
                    "body":"",
                    "params":{  
                        "type":" 
                        <a href="example.com/group/7">group</a>"
                    },
                    "date":"2015-06-19 10:07:10",
                    "attachment_count":1,
                    "comment_count":0,
                    "like_count":0,
                    "privacy":null,
                    "commentable":1,
                    "shareable":1,
                    "user_agent":null,
                    "main_content":"Alen X shared Alen X's group.\r\n",
                    "time_value":1434708430,
                    "subject":{  
                        "user_id":123,
                        "username":"alenx",
                        "displayname":"Alen X",
                        "photo_id":0,
                        "status":"",
                        "status_date":"2015-06-12 05:02:34",
                        "locale":"fil_PH",
                        "language":"en_US",
                        "timezone":"Asia/Dubai",
                        "search":0,
                        "show_profileviewers":1,
                        "level_id":1,
                        "enabled":1,
                        "verified":1,
                        "approved":1,
                        "creation_date":"2014-11-11 06:00:28",
                        "modified_date":"2015-07-06 12:09:45",
                        "lastlogin_date":"2015-07-06 10:12:12",
                        "update_date":null,
                        "member_count":1,
                        "view_count":16,
                        "location":"",
                        "url":"http://example.com/profile/admin",
                        "image":"",
                        "image_icon":"",
                        "image_profile":"",
                        "image_normal":"",
                        "owner_title":"Alen X"
                    }
                }
            },
            {  
                "feed":{  
                    "action_id":209,
                    "type":"music_playlist_new",
                    "subject_type":"user",
                    "subject_id":1,
                    "object_type":"music_playlist",
                    "object_id":6,
                    "body":"",
                    "params":"[]",
                    "date":"2015-06-19 06:52:42",
                    "attachment_count":1,
                    "comment_count":0,
                    "like_count":0,
                    "privacy":null,
                    "commentable":1,
                    "shareable":1,
                    "user_agent":null,
                    "main_content":"Alen X created a new playlist: gggggggggggg[New Playlist]",
                    "time_value":1434696762,
                    "subject":{  
                        "user_id":123,
                        "username":"alenx",
                        "displayname":"Alen X",
                        "photo_id":0,
                        "status":"",
                        "status_date":"2015-06-12 05:02:34",
                        "locale":"fil_PH",
                        "language":"en_US",
                        "timezone":"Asia/Dubai",
                        "search":0,
                        "show_profileviewers":1,
                        "level_id":1,
                        "enabled":1,
                        "verified":1,
                        "approved":1,
                        "creation_date":"2014-11-11 06:00:28",
                        "modified_date":"2015-07-06 12:09:45",
                        "lastlogin_date":"2015-07-06 10:12:12",
                        "update_date":null,
                        "member_count":1,
                        "view_count":16,
                        "location":"",
                        "url":"http://example.com/profile/admin",
                        "image":"",
                        "image_icon":"",
                        "image_profile":"",
                        "image_normal":"",
                        "owner_title":"Alen X"
                    },
                    "attachment":[  
                        {  
                            "playlist_id":6,
                            "title":"My Playlist",
                            "description":"",
                            "photo_id":0,
                            "owner_type":"user",
                            "owner_id":1,
                            "search":1,
                            "profile":0,
                            "special":null,
                            "creation_date":"2015-06-19 06:52:42",
                            "modified_date":"2015-06-19 06:52:42",
                            "view_count":0,
                            "comment_count":0,
                            "play_count":0,
                            "attachment_type":"music",
                            "likes_count":0,
                            "is_like":0,
                            "menu":[  

                            ],
                            "mode":1
                        }
                    ],
                    "photo_attachment_count":1
                },
                "can_comment":true,
                "is_like":0,
                "can_delete":1,
                "can_share":1,
                "feed_menus":{  
                    "like":{  
                        "name":"like",
                        "label":"Like",
                        "url":"like",
                        "urlParams":{  
                            "action_id":209
                        }
                    },
                    "delete":{  
                        "name":"delete",
                        "label":"Delete",
                        "url":"activity-feed/delete",
                        "urlParams":{  
                            "action_id":209
                        }
                    },
                    "share":{  
                        "name":"share",
                        "label":"Share",
                        "url":"activity/share",
                        "urlParams":{  
                            "type":"music_playlist",
                            "id":6
                        }
                    }
                }
            }
        ],
        "maxid":162,
        "enable_composer":true,
        "enable_composer_photo":true,
        "feed_post_menu":{  
            "status":1,
            "emotions":1,
            "photo":1
        }
}

Post New Feed

Post New Feed
POST/activity/post

Share(Post) the new feed

To post the feed photo, send the file in multipart / form-data format with the API request parameters.

Parameter Required Type Example Description
body yes string Save Earth new feed description
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Body
{
    "body": "Merry Christmas",
}
Response  201
Response  401
HideShow
Headers
Content-Type: application/json
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Delete Feed and Comment

Delete Feed and Comment
DELETE/activity/delete

Delete the feed and feed comment

Parameter Required Type Example Description
action_id yes integer 562 activity feed id
comment_id no integer 122 activity comment id
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "action_id": 562,
  "comment_id": 122
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Like

Like
POST/activity/like

Like to any feed OR feed comment by log-in user

Parameter Required Type Example Description
action_id yes integer 562 activity feed id
comment_id no integer 122 feed comment id
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
    "action_id": 562,
    "comment_id": 871,
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Unlike

Unlike
POST/activity/unlike

Unlike to any feed OR feed comment by log-in user

Parameter Required Type Example Description
action_id yes integer 562 activity feed id
comment_id no integer 122 feed comment id
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
    "action_id": 562,
    "comment_id": 871,
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Post Feed Comment

Post Feed Comment
POST/activity/comment

Post the comment for the feed by log-in user

Parameter Required Type Example Description
action_id yes integer 562 activity feed id
body yes string great job!! comment body
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "action_id": 562,
  "body": "great job!!"
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "action_id": 195,
  "comment_id": 28,
  "image": "http://localhost/socialEngineApi/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
  "image_normal": "http://localhost/socialEngineApi/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
  "image_profile": "http://localhost/socialEngineApi/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
  "image_icon": "http://localhost/socialEngineApi/application/modules/User/externals/images/nophoto_user_thumb_icon.png",
  "content_url": "http://example.com/profile/dario",
  "author_title": "M Dario",
  "comment_body": "great job!!",
  "comment_date": "2015-06-22 10:56:54",
  "delete": {
    "name": "delete",
    "label": "Delete",
    "url": "comment-delete",
    "urlParams": {
      "action_id": 195,
      "subject_type": "activity_action",
      "subject_id": 195,
      "comment_id": 28
    }
  },
  "like": {
    "name": "like",
    "label": "Like",
    "url": "like",
    "urlParams": {
      "action_id": 195,
      "subject_type": "activity_action",
      "subject_id": 195,
      "comment_id": 28
    }
  }
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Get Likes and Comments

Get Likes and Comments
GET/activity/likes-comments

Get the paginated list of likes and comments respect of any feed or feed-comment.

Parameter Required Type Example Description
action_id yes integer 122 activity feed id
comment_id no integer 89 activity feed comment id
viewAllLikes no integer 1 get list of users, who like to this feed
viewAllComments no integer 1 get list of users, who comment to this feed
Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "viewAllLikesBy": [
    {
      "user_id": 1,
      "username": "admin",
      "displayname": "Jennifer Aniston",
      "photo_id": 0,
      "status": "Bmcjgfigf",
      "status_date": "2015-03-10 08:11:45",
      "locale": "auto",
      "language": "en_US",
      "timezone": "US/Pacific",
      "search": 1,
      "show_profileviewers": 1,
      "level_id": 1,
      "enabled": 1,
      "verified": 1,
      "approved": 1,
      "creation_date": "2014-11-15 08:27:34",
      "modified_date": "2015-03-10 08:11:45",
      "lastlogin_date": "2015-03-20 06:12:08",
      "update_date": null,
      "member_count": 2,
      "view_count": 87,
      "location": "",
      "url": "http://example.com/profile/admin",
      "photo_url": "http://dev1.bigsteptech.in"
    }
  ],
  "viewAllComments": [
    {
      "action_id": "670",
      "comment_id": 50,
      "author_photo": "http://dev1.bigsteptech.in",
      "author_title": "Jennifer Aniston",
      "comment_body": "my first comment",
      "comment_date": "2015-03-20 09:59:31",
      "delete": {
        "name": "delete",
        "label": "Delete",
        "url": "comment-delete",
        "urlParams": {
          "action_id": "670",
          "subject_type": "group",
          "subject_id": 74,
          "comment_id": 50
        }
      },
      "like": {
        "name": "like",
        "label": "Like",
        "url": "like",
        "urlParams": {
          "action_id": "670",
          "subject_type": "group",
          "subject_id": 74,
          "comment_id": 50
        },
        "isLike": 0
      }
    },
    {
      "action_id": "670",
      "comment_id": 51,
      "author_photo": "http://dev1.bigsteptech.in",
      "author_title": "Jennifer Aniston",
      "comment_body": "My second comment",
      "comment_date": "2015-03-20 09:59:49",
      "delete": {
        "name": "delete",
        "label": "Delete",
        "url": "comment-delete",
        "urlParams": {
          "action_id": "670",
          "subject_type": "group",
          "subject_id": 74,
          "comment_id": 51
        }
      },
      "like": {
        "name": "like",
        "label": "Like",
        "url": "like",
        "urlParams": {
          "action_id": "670",
          "subject_type": "group",
          "subject_id": 74,
          "comment_id": 51
        },
        "isLike": 0
      }
    }
  ],
  "isLike": 0,
  "canComment": 1,
  "canDelete": 1,
  "getTotalComments": 2,
  "getTotalLikes": 1
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Tag Friend in Feed

Tag Friend in Feed
POST/activity/tag-friend

Tag the friend for the respective feed by log-in user

Parameter Required Type Example Description
action_id yes integer 276 feed id
users yes string 2,5,6 tagged friend ids
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Body
{
  "action_id": 276,
  "users": "2,5,6"
}
Response  204
Response  401
HideShow
Headers
Content-Type: application/json
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Advanced Activity Feeds / Wall Plugin

These are the APIs for the Xiglute Plugin: Advanced Activity Feeds / Wall Plugin.

Get Activity Feeds

Get Activity Feeds
GET/advancedactivity/feeds{?limit}

Get the activity feeds for member home, user profile, or content profile. Activity feeds can also be obtained based on feed_type. Count of new activity feeds can also be obtained.

To get New feeds count call this API after some time interval [example: in every 30 second] with minid and feed_count_only, and the available new feeds count will be returned in response.

In case of pagination, we need to use 2 parameters limit and maxid. Use limit to set the number of feeds in response and use maxid for the feed id after which limit number of feeds are to be fetched. Note that as feeds are shown in descending order of ids, feeds returned in response will have ids lesser than maxid.

Parameters
HideShow
post_elements
boolean (optional) Example: post_elements=0

get list of feed elements that can be posted like: status, emoticons, photo, checkin, withtags, userprivacy, etc. Default value is 1.

subject_type
string (optional) Example: subject_type=blog

subject type. Required to get activity feeds of a content or user profile.

subject_id
integer (optional) Example: subject_id=128

subject id. ID of content / user.

minid
integer (optional) Example: minid=75

first feed’s id. Note that in a response set of feeds, minid will be greater than maxid as feeds are shown in descending order of ids. minid is used to get the count of new feeds.

feed_count_only
boolean (optional) Example: feed_count_only=1

get only feed count in response. Required to get count of new feeds. Default value is 0.

action_id
integer (optional) Example: action_id=167

feed id. Get information of a single activity feed.

feed_filter
boolean (optional) Example: boolean=1

get list of available feed filters in response. Default value is 0.

feed_type
string (optional) Example: feed_type=all

filter the activity feeds response to get feeds of a particular type ().

subject_info
boolean (optional) Example: subject_info=1

get subject array with every feed in response. Default value is 0.

object_info
boolean (optional) Example: object_info=1

get object array with every feed in response. Default value is 0.

maxid
integer (optional) Example: maxid=128

last feed’s id. Required in pagination as explained above.

limit
integer (optional) Example: limit=20

number of feeds. Default limit is 15.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "activity_feed": [
    {
      "data": {
        "action_id": 668,
        "type": "sitetagcheckin_post_self",
        "subject_type": "user",
        "subject_id": 3,
        "object_type": "user",
        "object_id": 3,
        "body": "He Hugh",
        "params": {
          "0": "[]",
          "checkin": {
            "resource_guid": "0",
            "type": "place",
            "id": "sitetagcheckin_0",
            "label": "Franklin Institute, North 20th Street, Philadelphia, PA, United States",
            "place_id": "ChIJ05tdhjTGxokReHRD0wXejyE",
            "latitude": "39.9582109",
            "vicinity": "The Franklin Institute, 222 North 20th Street, Philadelphia, PA 19103, USA",
            "longitude": "-75.1731347",
            "prefixadd": "in"
          }
        },
        "date": "2015-03-19 07:30:52",
        "attachment_count": 1,
        "comment_count": 1,
        "like_count": 1,
        "privacy": "everyone",
        "commentable": 1,
        "shareable": 1,
        "user_agent": "seiosnativeapp/1 CFNetwork/711.0.6 Darwin/14.0.0",
        "time_value": 1426750252,
        "feed_title": "Robert Desuza\r\nHe Hugh",
        "action_type_body": "{item:$subject}\r\n{body:$body}",
        "action_type_body_params": [
          {
            "search": "{item:$subject}",
            "label": "Robert Desuza",
            "type": "user",
            "id": 3
          },
          {
            "search": "{body:$body}",
            "label": "He Hugh"
          }
        ],
        "feed_icon": "http://example.com/public/user/0c/000c_1719.png",
        "tags": [
          {
            "tagmap_id": 91,
            "resource_type": "activity_action",
            "resource_id": 668,
            "tagger_type": "user",
            "tagger_id": 3,
            "tag_type": "user",
            "tag_id": 1,
            "creation_date": "2015-03-19 07:30:52",
            "extra": null,
            "tag_obj": {
              "user_id": 1,
              "username": "mikealen",
              "displayname": "M Mike",
              "photo_id": 0,
              "status": "Bmcjgfigf",
              "status_date": "2015-03-10 08:11:45",
              "locale": "auto",
              "language": "en_US",
              "timezone": "US/Pacific",
              "search": 1,
              "show_profileviewers": 1,
              "level_id": 1,
              "enabled": 1,
              "verified": 1,
              "approved": 1,
              "creation_date": "2014-11-15 08:27:34",
              "modified_date": "2015-03-10 08:11:45",
              "lastlogin_date": "2015-03-18 10:18:31",
              "update_date": null,
              "member_count": 27,
              "view_count": 187,
              "location": "",
              "image_icon": ""
            }
          }
        ],
        "attachment": [
          {
            "title": "",
            "body": "",
            "attachment_type": "album_photo",
            "attachment_id": 11,
            "likes_count": 1,
            "comment_count": 1,
            "is_like": 1,
            "image_main": {
              "src": "http://example.com/public/album_photo/31/03/032e_bf05.png",
              "size": {
                "width": 640,
                "height": 480
              }
            },
            "image_icon": {
              "src": "http://example.com/public/album_photo/31/03/032e_bf05.png",
              "size": {
                "width": 640,
                "height": 480
              }
            },
            "image_profile": {
              "src": "http://example.com/public/album_photo/31/03/032e_bf05.png",
              "size": {
                "width": 640,
                "height": 480
              }
            },
            "image_normal": {
              "src": "http://example.com/public/album_photo/32/03/032f_252d.png",
              "size": {
                "width": 140,
                "height": 105
              }
            },
            "image_medium": {
              "src": "http://example.com/public/album_photo/33/03/0330_3768.png",
              "size": {
                "width": 375,
                "height": 281
              }
            },
            "mode": 1
          }
        ],
        "photo_attachment_count": 1
      },
      "can_comment": true,
      "is_like": 1,
      "can_share": 1,
      "feed_menus": {
        "like": {
          "name": "unlike",
          "label": "Unlike",
          "url": "unlike",
          "urlParams": {
            "action_id": 668
          }
        },
        "share": {
          "name": "share",
          "label": "Share",
          "url": "activity/share",
          "urlParams": {
            "type": "album_photo",
            "id": 89
          }
        },
        "save_feed": {
          "name": "update_save_feed",
          "label": "Save Feed",
          "url": "advancedactivity/update-save-feed",
          "urlParams": {
            "action_id": 668
          }
        },
        "delete": {
          "name": "delete_feed",
          "label": "Delete Feed",
          "url": "advancedactivity/delete",
          "urlParams": {
            "action_id": 668
          }
        },
        "disable_comment": {
          "name": "disable_comment",
          "label": "Disable Comments",
          "url": "advancedactivity/update-commentable",
          "urlParams": {
            "action_id": 668
          }
        },
        "lock_feed": {
          "name": "lock_this_feed",
          "label": "Lock this Feed",
          "url": "advancedactivity/update-shareable",
          "urlParams": {
            "action_id": 668
          }
        }
      }
    }
  ],
  "activityCount": 1,
  "enable_composer": true,
  "enable_composer_photo": true,
  "maxid": 667,
  "minid": 669,
  "feed_post_menu": {
    "status": 1,
    "emotions": 1,
    "withtags": 1,
    "photo": 1,
    "checkin": 1,
    "userprivacy": {
      "everyone": "Everyone",
      "networks": "Friends & Networks",
      "friends": "Friends Only",
      "onlyme": "Only Me"
    }
  }
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Post New Feed

Post New Feed
POST/advancedactivity/feeds/post

Post a new update in activity feeds. Share a new post from status update box.

To post the feed photo, send the file in multipart / form-data format with the API request parameters.

To tag a friend, call Tag Friend in Feed API.

In this API request the parameter composer is dependent on the "Geo-Location, Geo-Tagging, Check-Ins & Proximity Search Plugin". So, this parameter is not required to be sent if this plugin is not installed on the website.

Parameter Required Type Example Description
body yes string Save Earth status update post’s content
toValues no string 2,5,6 comma-separated IDs of tagged friends
auth_view no string everyone authorization permission (privacy) to view feed / status update
composer no array {“checkin”: {…}} location information for checkin
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Body
{
  "body": "Merry Christmas",
  "toValues": "2,5,6",
  "auth_view": "everyone",
  "composer": {
    "checkin": {
      "id": "sitetagcheckin_3",
      "label": "Alexandria, VA, United States",
      "place_id": "ChIJ8aukkz5NtokRLAHB24Ym9dc",
      "prefixadd": "in",
      "resource_guid": 0,
      "type": "place"
    }
  }
}
Response  201
Response  401
HideShow
Headers
Content-Type: application/json
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Post Feed Comment

Post Feed Comment
POST/advancedactivity/comment

Post a comment on an activity feed.

Parameter Required Type Example Description
action_id yes integer 562 activity feed id
body yes string great job!! comment body
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "action_id": 562,
  "body": "great job!!"
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "action_id": 195,
  "comment_id": 28,
  "image": "http://localhost/socialEngineApi/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
  "image_normal": "http://localhost/socialEngineApi/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
  "image_profile": "http://localhost/socialEngineApi/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
  "image_icon": "http://localhost/socialEngineApi/application/modules/User/externals/images/nophoto_user_thumb_icon.png",
  "content_url": "http://example.com/profile/dario",
  "author_title": "M Michael",
  "comment_body": "great job!!",
  "comment_date": "2015-06-22 10:56:54",
  "delete": {
    "name": "delete",
    "label": "Delete",
    "url": "comment-delete",
    "urlParams": {
      "action_id": 195,
      "subject_type": "activity_action",
      "subject_id": 195,
      "comment_id": 28
    }
  },
  "like": {
    "name": "like",
    "label": "Like",
    "url": "like",
    "urlParams": {
      "action_id": 195,
      "subject_type": "activity_action",
      "subject_id": 195,
      "comment_id": 28
    }
  }
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Save / Unsave a Feed

Save / Unsave a Feed
POST/advancedactivity/update-save-feed

Save or Unsave a feed.

Parameter Required Type Example Description
action_id yes integer 562 activity feed id
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "action_id": "562"
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
1
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Delete a Feed

Delete Feed
DELETE/advancedactivity/delete

Delete an activity feed.

Parameter Required Type Example Description
action_id yes integer 562 activity feed id
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "action_id": 562
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Delete a Feed Comment

Delete Feed Comment
DELETE/advancedactivity/delete

Delete an activity feed’s comment.

Parameter Required Type Example Description
comment_id yes integer 122 activity feed comment id
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "comment_id": 122
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Enable / Disable Comments

Enable / Disable Comments
POST/advancedactivity/update-commentable

Enable or Disable comments commenting on an activity feed.

Parameter Required Type Example Description
action_id yes integer 562 activity feed id
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "action_id": 562
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
1
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Lock / Unlock Feed

Lock / Unlock Feed
POST/advancedactivity/update-shareable

Lock or Unlock an activity feed. When an activity feed is locked, then it cannot be shared.

Parameter Required Type Example Description
action_id yes integer 562 activity feed id
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "action_id": 562
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
0
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Like a Feed

Like a Feed
POST/advancedactivity/like

Like an activity feed.

Parameter Required Type Example Description
action_id yes integer 562 activity feed id
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "action_id": 562
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Like a Feed Comment

Like a Feed Comment
POST/advancedactivity/like

Like an activity feed comment.

Parameter Required Type Example Description
comment_id yes integer 122 feed comment id
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "comment_id": 871
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Unlike a Feed

Unlike a Feed
POST/advancedactivity/unlike

Unlike an activity feed.

Parameter Required Type Example Description
action_id yes integer 562 activity feed id
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "action_id": 562
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Unlike a Feed Comment

Unlike a Feed Comment
POST/advancedactivity/unlike

Unlike an activity feed comment.

Parameter Required Type Example Description
comment_id yes integer 122 feed comment id
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "comment_id": 871
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "type": "activity_action",
  "id": 122
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "undo": {
    "name": "undo",
    "label": "This story is now hidden from your Activity Feed.",
    "url": "advancedactivity/feeds/un-hide-item",
    "urlParams": {
      "type": "activity_action",
      "id": "671"
    }
  },
  "hide_all": {
    "name": "hide_all",
    "label": "Hide all by Robert De Souza",
    "url": "advancedactivity/feeds/hide-item",
    "urlParams": {
      "type": "user",
      "id": 3
    }
  }
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Undo Feed Hiding

Undo Feed Hiding
POST/advancedactivity/feeds/un-hide-item

Un-hide activity feeds.

Parameter Required Type Example Description
type yes integer activity_action table item type
id yes integer 122 activity feed id
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "type": "activity_action",
  "id": 122
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Get Likes and Comments

Get Likes and Comments
GET/advancedactivity/feeds/likes-comments

Get the paginated list of likes and comments respect of any feed or feed-comment.

Parameter Required Type Example Description
action_id yes integer 122 activity feed id
comment_id no integer 89 activity feed comment id
viewAllLikes no integer 1 get list of users, who like to this feed
viewAllComments no integer 1 get list of users, who comment to this feed
Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "viewAllLikesBy": [
    {
      "user_id": 1,
      "username": "admin",
      "displayname": "Jennifer Aniston",
      "photo_id": 0,
      "status": "Bmcjgfigf",
      "status_date": "2015-03-10 08:11:45",
      "locale": "auto",
      "language": "en_US",
      "timezone": "US/Pacific",
      "search": 1,
      "show_profileviewers": 1,
      "level_id": 1,
      "enabled": 1,
      "verified": 1,
      "approved": 1,
      "creation_date": "2014-11-15 08:27:34",
      "modified_date": "2015-03-10 08:11:45",
      "lastlogin_date": "2015-03-20 06:12:08",
      "update_date": null,
      "member_count": 2,
      "view_count": 87,
      "location": "",
      "url": "http://example.com/profile/admin",
      "photo_url": "http://dev1.bigsteptech.in"
    }
  ],
  "viewAllComments": [
    {
      "action_id": "670",
      "comment_id": 50,
      "author_photo": "http://dev1.bigsteptech.in",
      "author_title": "Jennifer Aniston",
      "comment_body": "my first comment",
      "comment_date": "2015-03-20 09:59:31",
      "delete": {
        "name": "delete",
        "label": "Delete",
        "url": "comment-delete",
        "urlParams": {
          "action_id": "670",
          "subject_type": "group",
          "subject_id": 74,
          "comment_id": 50
        }
      },
      "like": {
        "name": "like",
        "label": "Like",
        "url": "like",
        "urlParams": {
          "action_id": "670",
          "subject_type": "group",
          "subject_id": 74,
          "comment_id": 50
        },
        "isLike": 0
      }
    },
    {
      "action_id": "670",
      "comment_id": 51,
      "author_photo": "http://dev1.bigsteptech.in",
      "author_title": "Jennifer Aniston",
      "comment_body": "My second comment",
      "comment_date": "2015-03-20 09:59:49",
      "delete": {
        "name": "delete",
        "label": "Delete",
        "url": "comment-delete",
        "urlParams": {
          "action_id": "670",
          "subject_type": "group",
          "subject_id": 74,
          "comment_id": 51
        }
      },
      "like": {
        "name": "like",
        "label": "Like",
        "url": "like",
        "urlParams": {
          "action_id": "670",
          "subject_type": "group",
          "subject_id": 74,
          "comment_id": 51
        },
        "isLike": 0
      }
    }
  ],
  "isLike": 0,
  "canComment": 1,
  "canDelete": 1,
  "getTotalComments": 2,
  "getTotalLikes": 1
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Photo Albums Plugin

APIs allow to Xiglute members to manage there Xiglute - Photo Albums Plugin plugin and allow to get paginated list of albums, create album, edit album and delete album. Find the respective APIs following:

Browse Albums

Browse Albums
GET/albums{?search}

Get the paginated list of browse albums.

In case of pagination, we need to use 2 parameters limit and page. Use limit to set the number of albums in response and use page for the page number. [i.e: If you have 100 albums and the first request has limit=20 and page=1, then in that case the recent 20 albums will be returned in response, and if limit=20 and page=2 is sent in request, then the next 20 recent albums will be returned.]

Parameters
HideShow
search
string (optional) Example: search=california

getting similar title and description albums.

sort
string (optional) Example: sort=recent

getting most recent or most viewed albums.

category_id
integer (optional) Example: category_id=13

getting all albums of the category.

user_id
integer (optional) Example: user_id=125

user id of profile owner. Default value is logged-in user’s ID.

page
integer (optional) Example: page=2

return the ‘limit’ number of albums of that page of album listings.

limit
integer (optional) Example: limit=20

number of albums. Default limit is 20.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
    "canCreate":0,
    "totalItemCount":2,
    "response":[
        {
            "album_id":39,
            "title":"Most Beautiful Celebs",
            "description":"These are the beautiful women we all adore",
            "owner_type":"user",
            "owner_id":15,
            "category_id":7,
            "creation_date":"2015-02-17 10:13:40",
            "modified_date":"2015-04-09 08:32:06",
            "photo_id":620,
            "view_count":276,
            "comment_count":39,
            "search":1,
            "type":"wall",
            "location":"",
            "image":"http://example.com/public/album_photo/9b/009b_0443.jpg",
            "image_normal":"http://example.com/public/album_photo/9c/009c_3288.jpg",
            "image_profile":"http://example.com/public/album_photo/9b/009b_0443.jpg",
            "image_icon":"http://example.com/public/album_photo/9b/009b_0443.jpg",
            "content_url":"http://example.com/albums/view/1,
            "is_like":0,
            "like_count":156,
            "allow_to_view":1,
            "owner_title":"Emma Wise",
            "photo_count":13
        },
        {  
            "album_id":47,
            "title":"Super Heroes",
            "description":"They are out to destroy evil and save the world.",
            "owner_type":"user",
            "owner_id":165,
            "category_id":1,
            "creation_date":"2014-11-12 10:40:34",
            "modified_date":"2015-04-09 06:37:37",
            "photo_id":134,
            "view_count":451,
            "comment_count":70,
            "search":1,
            "type":"profile",
            "location":"",
            "image":"http://example.com/public/album_photo/05/0005_c767.jpg",
            "image_normal":"http://example.com/public/album_photo/06/0006_3508.jpg",
            "image_profile":"http://example.com/public/album_photo/05/0005_c767.jpg",
            "image_icon":"http://example.com/public/album_photo/05/0005_c767.jpg",
            "content_url":"http://example.com/albums/view/1",
            "is_like":1,
            "like_count":122,
            "allow_to_view":1,
            "owner_title":"Emma Wise",
            "photo_count":2
        }
    ]
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

My Albums

My Albums
GET/albums/manage{?search}

Get the paginated list of my albums respect of log-in user

In case of pagination, we need to use 2 parameters limit and page. Use limit to set the number of albums in response and use page for the page number. [i.e: If you have 100 albums and the first request has limit=20 and page=1, then in that case the recent 20 albums will be returned in response, and if limit=20 and page=2 is sent in request, then the next 20 recent albums will be returned.]

Parameters
HideShow
search
string (optional) Example: search=california

getting similar title and description albums.

sort
string (optional) Example: sort=recent

getting most recent or most viewed albums.

category_id
integer (optional) Example: category_id=13

getting all albums of the category.

page
integer (optional) Example: page=2

return the ‘limit’ number of albums of that page of album listings.

limit
integer (optional) Example: limit=20

number of albums. Default limit is 20.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "canCreate": 1,
  "totalItemCount": 3,
  "response": [
    {
      "album_id": 34,
      "title": "My Birthday Party",
      "description": "All of our parties are 45 to 60-minutes in home.",
      "owner_type": "user",
      "owner_id": 11,
      "category_id": 0,
      "creation_date": "2015-05-07 12:21:05",
      "modified_date": "2015-05-07 12:21:06",
      "photo_id": 21,
      "view_count": 20,
      "comment_count": 10,
      "search": 0,
      "type": "message",
      "location": "",
      "image": "http://example.com/public/album_photo/b6/00b6_8dfb.jpeg",
      "image_normal": "http://example.com/public/album_photo/b7/00b7_831c.jpeg",
      "image_profile": "http://example.com/public/album_photo/b6/00b6_8dfb.jpeg",
      "image_icon": "http://example.com/public/album_photo/b6/00b6_8dfb.jpeg",
      "content_url": "http://example.com/albums/view/1",
      "is_like": 1,
      "like_count": 54,
      "owner_title": "Alex Uyerr",
      "photo_count": 18,
      "menu": [
        {
          "label": "Edit Settings",
          "name": "edit",
          "url": "albums/album/edit",
          "urlParams": {
            "album_id": 34
          }
        },
        {
          "label": "Delete Album",
          "name": "delete",
          "url": "albums/album/delete",
          "urlParams": {
            "album_id": 34
          }
        }
      ]
    },
    {
      "album_id": 35,
      "title": "Most Beautiful Celebs",
      "description": "These are the beautiful women we all adore..",
      "owner_type": "user",
      "owner_id": 11,
      "category_id": 0,
      "creation_date": "2015-02-17 10:13:40",
      "modified_date": "2015-04-09 08:32:06",
      "photo_id": 20,
      "view_count": 23,
      "comment_count": 92,
      "search": 1,
      "type": "wall",
      "location": "",
      "image": "http://example.com/public/album_photo/9b/009b_0443.jpg",
      "image_normal": "http://example.com/public/album_photo/9c/009c_3288.jpg",
      "image_profile": "http://example.com/public/album_photo/9b/009b_0443.jpg",
      "image_icon": "http://example.com/public/album_photo/9b/009b_0443.jpg",
      "content_url": "http://example.com/albums/view/1",
      "is_like": 0,
      "like_count": 12,
      "owner_title": "Alex Uyerr",
      "photo_count": 13,
      "menu": [
        {
          "label": "Edit Settings",
          "name": "edit",
          "url": "albums/album/edit",
          "urlParams": {
            "album_id": 35
          }
        },
        {
          "label": "Delete Album",
          "name": "delete",
          "url": "albums/album/delete",
          "urlParams": {
            "album_id": 35
          }
        }
      ]
    }
  ]
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Browse Search Form

Browse Search Form
GET/albums/search-form

Get browse search form to filter on Browse Albums and My Albums

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "type": "Text",
    "name": "search",
    "label": "Search Albums"
  },
  {
    "type": "Select",
    "name": "sort",
    "label": "Browse By",
    "multiOptions": {
      "recent": "Most Recent",
      "popular": "Most Viewed"
    }
  },
  {
    "type": "Select",
    "name": "category_id",
    "label": "Category",
    "multiOptions": {
      "0": "All Categories",
      "1": "Arts & Culture",
      "2": "Business",
      "3": "Entertainment",
      "5": "Family & Home",
      "6": "Health",
      "7": "Recreation",
      "8": "Personal",
      "9": "Shopping",
      "10": "Society",
      "11": "Sports",
      "12": "Technology",
      "13": "Other"
    }
  },
  {
    "type": "Submit",
    "name": "submit",
    "label": "Search"
  }
]
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Create Album

Get Album Form
GET/albums/upload

Get the create album form

If user select “Create A New Album” in form then show all the form elements otherwise hide all the elements and show only photo uploading option.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "type": "Select",
    "name": "album",
    "label": "Choose Album",
    "multiOptions": {
      "0": "Create A New Album",
      "1": "My Album",
      "3": "Test Album Title",
      "4": "Message Photos"
    },
    "hasValidator": true
  },
  {
    "type": "Text",
    "name": "title",
    "label": "Album Title",
    "hasValidator": true
  },
  {
    "type": "Select",
    "name": "category_id",
    "label": "Category",
    "multiOptions": {
      "0": "All Categories",
      "1": "Arts & Culture",
      "2": "Business",
      "3": "Entertainment",
      "5": "Family & Home",
      "6": "Health",
      "7": "Recreation",
      "8": "Personal",
      "9": "Shopping",
      "10": "Society",
      "11": "Sports",
      "12": "Technology",
      "13": "Other"
    },
    "hasValidator": true
  },
  {
    "type": "Textarea",
    "name": "description",
    "label": "Album Description",
    "hasValidator": true
  },
  {
    "type": "Checkbox",
    "name": "search",
    "label": "Show this album in search results"
  },
  {
    "type": "Select",
    "name": "auth_view",
    "label": "Privacy",
    "description": "Who may see this album?",
    "multiOptions": {
      "everyone": "Everyone",
      "owner_network": "Friends and Networks",
      "owner_member_member": "Friends of Friends",
      "owner_member": "Friends Only",
      "owner": "Just Me"
    },
    "hasValidator": true
  },
  {
    "type": "Select",
    "name": "auth_comment",
    "label": "Comment Privacy",
    "description": "Who may post comments on this album?",
    "multiOptions": {
      "everyone": "Everyone",
      "owner_network": "Friends and Networks",
      "owner_member_member": "Friends of Friends",
      "owner_member": "Friends Only",
      "owner": "Just Me"
    },
    "hasValidator": true
  },
  {
    "type": "Select",
    "name": "auth_tag",
    "label": "Tagging",
    "description": "Who may tag photos in this album?",
    "multiOptions": {
      "everyone": "Everyone",
      "owner_network": "Friends and Networks",
      "owner_member_member": "Friends of Friends",
      "owner_member": "Friends Only",
      "owner": "Just Me"
    },
    "hasValidator": true
  },
  {
    "type": "File",
    "name": "photo",
    "label": "Main Photo"
  },
  {
    "type": "Submit",
    "name": "submit",
    "label": "Save Photos"
  }
]
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Post Album Form
POST/albums/upload

Post the create album form values

Parameter Required Type Example Description
album yes integer 0 album id [0 to create new album and give album id to upload photos]
title yes string Most Beautiful Celebs album title
category_id yes integer 2 category id
description yes string These are the beautiful women we all adore… album description
search no boolean 1 searchable or not
auth_view yes string everyone authorization permission to view album
auth_comment yes string everyone authorization permission to comment on album
auth_tag yes string everyone authorization permission to tag for album
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "album": 0,
  "title": "Most Beautiful Celebs",
  "category_id": 3,
  "description": "These are the beautiful women we all adore",
  "search": 1,
  "auth_view": "everyone",
  "auth_comment": "everyone",
  "auth_tag": "everyone"
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "canEdit": 1,
  "totalPhotoCount": 2,
  "album": {
    "album_id": 432,
    "title": "Most Beautiful Celebs",
    "description": "These are the beautiful women we all adore...",
    "owner_type": "user",
    "owner_id": 132,
    "category_id": 2,
    "creation_date": "2014-11-12 10:40:34",
    "modified_date": "2015-04-09 06:37:37",
    "photo_id": 1,
    "view_count": 176,
    "comment_count": 56,
    "search": 1,
    "type": "profile",
    "location": "",
    "image": "http://example.com/public/album_photo/05/0005_c767.jpg",
    "image_normal": "http://example.com/public/album_photo/06/0006_3508.jpg",
    "image_profile": "http://example.com/public/album_photo/05/0005_c767.jpg",
    "image_icon": "http://example.com/public/album_photo/05/0005_c767.jpg",
    "content_url": "http://example.com/albums/view/1",
    "owner_image": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
    "owner_image_normal": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
    "owner_image_profile": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
    "owner_image_icon": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_icon.png",
    "owner_title": "Emma Wise",
    "is_like": 1,
    "like_count": 189
  },
  "albumPhotos": [
    {
      "photo_id": 176,
      "album_id": 432,
      "title": "",
      "description": "",
      "creation_date": "2014-11-12 10:40:34",
      "modified_date": "2014-11-12 10:40:34",
      "order": 0,
      "owner_type": "user",
      "owner_id": 1,
      "file_id": 5,
      "view_count": 0,
      "comment_count": 120,
      "skip_photo": 0,
      "is_like": 1,
      "like_count": 45,
      "image": "http://example.com/public/album_photo/05/0005_c767.jpg",
      "image_normal": "http://example.com/public/album_photo/06/0006_3508.jpg",
      "image_profile": "http://example.com/public/album_photo/05/0005_c767.jpg",
      "image_icon": "http://example.com/public/album_photo/05/0005_c767.jpg",
      "content_url": "http://example.com/albums/photo/view/album_id/1/photo_id/1",
      "menu": [
        {
          "label": "Edit",
          "name": "edit",
          "url": "albums/photo/edit",
          "urlParams": {
            "album_id": 432,
            "photo_id": 176
          }
        },
        {
          "label": "Delete",
          "name": "delete",
          "url": "albums/photo/delete",
          "urlParams": {
            "album_id": 432,
            "photo_id": 176
          }
        },
        {
          "label": "Share",
          "name": "share",
          "url": "activity/share",
          "urlParams": {
            "type": "album_photo",
            "id": 176
          }
        },
        {
          "label": "Report",
          "name": "report",
          "url": "report/create/subject/album_photo_176",
          "urlParams": {
            "type": "album_photo",
            "id": 176
          }
        },
        {
          "label": "Make Profile Photo",
          "name": "make_profile_photo",
          "url": "members/edit/external-photo",
          "urlParams": {
            "photo": "album_photo_176"
          }
        }
      ]
    },
    {
      "photo_id": 187,
      "album_id": 432,
      "title": "",
      "description": "",
      "creation_date": "2015-01-30 09:43:25",
      "modified_date": "2015-01-30 09:43:25",
      "order": 0,
      "owner_type": "user",
      "owner_id": 1,
      "file_id": 49,
      "view_count": 70,
      "comment_count": 12,
      "skip_photo": 0,
      "is_like": 0,
      "like_count": 0,
      "image": "http://example.com/public/album_photo/31/0031_8f27.jpg",
      "image_normal": "http://example.com/public/album_photo/32/0032_20ff.jpg",
      "image_profile": "http://example.com/public/album_photo/31/0031_8f27.jpg",
      "image_icon": "http://example.com/public/album_photo/31/0031_8f27.jpg",
      "content_url": "http://example.com/albums/photo/view/album_id/1/photo_id/1",
      "menu": [
        {
          "label": "Edit",
          "name": "edit",
          "url": "albums/photo/edit",
          "urlParams": {
            "album_id": 432,
            "photo_id": 187
          }
        },
        {
          "label": "Delete",
          "name": "delete",
          "url": "albums/photo/delete",
          "urlParams": {
            "album_id": 432,
            "photo_id": 187
          }
        },
        {
          "label": "Share",
          "name": "share",
          "url": "activity/share",
          "urlParams": {
            "type": "album_photo",
            "id": 187
          }
        },
        {
          "label": "Report",
          "name": "report",
          "url": "report/create/subject/album_photo_187",
          "urlParams": {
            "type": "album_photo",
            "id": 187
          }
        },
        {
          "label": "Make Profile Photo",
          "name": "make_profile_photo",
          "url": "members/edit/external-photo",
          "urlParams": {
            "photo": "album_photo_187"
          }
        }
      ]
    }
  ],
  "gutterMenu": [
    {
      "label": "Add More Photos",
      "name": "add",
      "url": "albums/upload",
      "urlParams": {
        "album_id": 432
      }
    },
    {
      "label": "Edit Settings",
      "name": "edit",
      "url": "albums/edit/432",
      "urlParams": {}
    },
    {
      "label": "Delete Album",
      "name": "delete",
      "url": "albums/delete/432",
      "urlParams": {}
    }
  ]
}
Response  400
HideShow
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "validation_fail",
  "message": {
    "title": "Please complete this field - it is required.",
    "description": "Please complete this field - it is required."
  }
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Album Profile

Album Profile
GET/albums/view/{album_id}{?gutter_menu}

Get the album profile page

Get gutterMenu and response in case of Response 200. In the gutterMenu get the array of album profile gutter menus and in response get the array of requested album.

Parameters
HideShow
album_id
integer (required) Example: 123

album id

gutter_menu
boolean (optional) Example: gutter_menu=1 OR 0

return array of gutter menus. Default limit is 1

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "canEdit": 1,
  "totalPhotoCount": 2,
  "album": {
    "album_id": 432,
    "title": "Most Beautiful Celebs",
    "description": "These are the beautiful women we all adore...",
    "owner_type": "user",
    "owner_id": 132,
    "category_id": 2,
    "creation_date": "2014-11-12 10:40:34",
    "modified_date": "2015-04-09 06:37:37",
    "photo_id": 1,
    "view_count": 176,
    "comment_count": 56,
    "search": 1,
    "type": "profile",
    "location": "",
    "image": "http://example.com/public/album_photo/05/0005_c767.jpg",
    "image_normal": "http://example.com/public/album_photo/06/0006_3508.jpg",
    "image_profile": "http://example.com/public/album_photo/05/0005_c767.jpg",
    "image_icon": "http://example.com/public/album_photo/05/0005_c767.jpg",
    "content_url": "http://example.com/albums/view/1",
    "owner_image": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
    "owner_image_normal": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
    "owner_image_profile": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_profile.png",
    "owner_image_icon": "http://example.com/application/modules/User/externals/images/nophoto_user_thumb_icon.png",
    "owner_title": "Emma Wise",
    "is_like": 1,
    "like_count": 189
  },
  "albumPhotos": [
    {
      "photo_id": 176,
      "album_id": 432,
      "title": "",
      "description": "",
      "creation_date": "2014-11-12 10:40:34",
      "modified_date": "2014-11-12 10:40:34",
      "order": 0,
      "owner_type": "user",
      "owner_id": 1,
      "file_id": 5,
      "view_count": 0,
      "comment_count": 120,
      "skip_photo": 0,
      "is_like": 1,
      "like_count": 45,
      "image": "http://example.com/public/album_photo/05/0005_c767.jpg",
      "image_normal": "http://example.com/public/album_photo/06/0006_3508.jpg",
      "image_profile": "http://example.com/public/album_photo/05/0005_c767.jpg",
      "image_icon": "http://example.com/public/album_photo/05/0005_c767.jpg",
      "content_url": "http://example.com/albums/photo/view/album_id/2/photo_id/6",
      "menu": [
        {
          "label": "Edit",
          "name": "edit",
          "url": "albums/photo/edit",
          "urlParams": {
            "album_id": 432,
            "photo_id": 176
          }
        },
        {
          "label": "Delete",
          "name": "delete",
          "url": "albums/photo/delete",
          "urlParams": {
            "album_id": 432,
            "photo_id": 176
          }
        },
        {
          "label": "Share",
          "name": "share",
          "url": "activity/share",
          "urlParams": {
            "type": "album_photo",
            "id": 176
          }
        },
        {
          "label": "Report",
          "name": "report",
          "url": "report/create/subject/album_photo_176",
          "urlParams": {
            "type": "album_photo",
            "id": 176
          }
        },
        {
          "label": "Make Profile Photo",
          "name": "make_profile_photo",
          "url": "members/edit/external-photo",
          "urlParams": {
            "photo": "album_photo_176"
          }
        }
      ]
    },
    {
      "photo_id": 187,
      "album_id": 432,
      "title": "",
      "description": "",
      "creation_date": "2015-01-30 09:43:25",
      "modified_date": "2015-01-30 09:43:25",
      "order": 0,
      "owner_type": "user",
      "owner_id": 1,
      "file_id": 49,
      "view_count": 70,
      "comment_count": 12,
      "skip_photo": 0,
      "is_like": 0,
      "like_count": 0,
      "image": "http://example.com/public/album_photo/31/0031_8f27.jpg",
      "image_normal": "http://example.com/public/album_photo/32/0032_20ff.jpg",
      "image_profile": "http://example.com/public/album_photo/31/0031_8f27.jpg",
      "image_icon": "http://example.com/public/album_photo/31/0031_8f27.jpg",
      "content_url": "http://example.com/albums/photo/view/album_id/2/photo_id/6",
      "menu": [
        {
          "label": "Edit",
          "name": "edit",
          "url": "albums/photo/edit",
          "urlParams": {
            "album_id": 432,
            "photo_id": 187
          }
        },
        {
          "label": "Delete",
          "name": "delete",
          "url": "albums/photo/delete",
          "urlParams": {
            "album_id": 432,
            "photo_id": 187
          }
        },
        {
          "label": "Share",
          "name": "share",
          "url": "activity/share",
          "urlParams": {
            "type": "album_photo",
            "id": 187
          }
        },
        {
          "label": "Report",
          "name": "report",
          "url": "report/create/subject/album_photo_187",
          "urlParams": {
            "type": "album_photo",
            "id": 187
          }
        },
        {
          "label": "Make Profile Photo",
          "name": "make_profile_photo",
          "url": "members/edit/external-photo",
          "urlParams": {
            "photo": "album_photo_187"
          }
        }
      ]
    }
  ],
  "gutterMenu": [
    {
      "label": "Add More Photos",
      "name": "add",
      "url": "albums/upload",
      "urlParams": {
        "album_id": 432
      }
    },
    {
      "label": "Edit Settings",
      "name": "edit",
      "url": "albums/edit/432",
      "urlParams": {}
    },
    {
      "label": "Delete Album",
      "name": "delete",
      "url": "albums/delete/432",
      "urlParams": {}
    }
  ]
}
Response  400
HideShow
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "parameter_missing",
  "message": "Missing Parameters: photo_id OR album_id"
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Edit Album

Get Album Form
GET/albums/edit/{album_id}

Get the edit album form

Returns the form and formValues as response. In form we get the complete edit album form and in formValues we get the form’s values.

Parameters
HideShow
album_id
integer (required) Example: 1246

album id

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "form": [
    {
      "type": "Text",
      "name": "title",
      "label": "Album Title",
      "hasValidator": true
    },
    {
      "type": "Select",
      "name": "category_id",
      "label": "Category",
      "multiOptions": {
        "0": "All Categories",
        "1": "Arts & Culture",
        "2": "Business",
        "3": "Entertainment",
        "5": "Family & Home",
        "6": "Health",
        "7": "Recreation",
        "8": "Personal",
        "9": "Shopping",
        "10": "Society",
        "11": "Sports",
        "12": "Technology",
        "13": "Other"
      },
      "hasValidator": true
    },
    {
      "type": "Textarea",
      "name": "description",
      "label": "Album Description",
      "hasValidator": true
    },
    {
      "type": "Checkbox",
      "name": "search",
      "label": "Show this album in search results"
    },
    {
      "type": "Select",
      "name": "auth_view",
      "label": "Privacy",
      "description": "Who may see this album?",
      "multiOptions": {
        "everyone": "Everyone",
        "owner_network": "Friends and Networks",
        "owner_member_member": "Friends of Friends",
        "owner_member": "Friends Only",
        "owner": "Just Me"
      },
      "hasValidator": true
    },
    {
      "type": "Select",
      "name": "auth_comment",
      "label": "Comment Privacy",
      "description": "Who may post comments on this album?",
      "multiOptions": {
        "everyone": "Everyone",
        "owner_network": "Friends and Networks",
        "owner_member_member": "Friends of Friends",
        "owner_member": "Friends Only",
        "owner": "Just Me"
      },
      "hasValidator": true
    },
    {
      "type": "Select",
      "name": "auth_tag",
      "label": "Tagging",
      "description": "Who may tag photos in this album?",
      "multiOptions": {
        "everyone": "Everyone",
        "owner_network": "Friends and Networks",
        "owner_member_member": "Friends of Friends",
        "owner_member": "Friends Only",
        "owner": "Just Me"
      },
      "hasValidator": true
    },
    {
      "type": "Submit",
      "name": "submit",
      "label": "Save Album"
    }
  ],
  "formValues": {
    "album_id": 178,
    "title": "My Birthday Party",
    "description": "All of our parties are 45 to 60-minutes in leng..",
    "owner_type": "user",
    "owner_id": 123,
    "category_id": 1,
    "creation_date": "2014-11-12 10:40:34",
    "modified_date": "2015-04-09 06:37:37",
    "photo_id": 1,
    "view_count": 541,
    "comment_count": 54,
    "search": 1,
    "type": "profile",
    "location": "",
    "auth_view": "everyone",
    "auth_comment": "everyone",
    "auth_tag": "owner_member_member"
  }
}
Response  400
HideShow
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "parameter_missing",
  "message": "Missing Parameters: photo_id OR album_id"
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Put Album Form
PUT/albums/edit/{album_id}

Put the edit album form values

Parameter Required Type Example Description
title yes string Most Beautiful Celebs album title
category_id yes integer 2 category id
description yes string These are the beautiful women we all adore… album description
search no boolean 1 searchable or not
auth_view yes string everyone authorization permission to view album
auth_comment yes string everyone authorization permission to comment on album
auth_tag yes string everyone authorization permission to tag for album
Parameters
HideShow
album_id
integer (required) Example: album_id=1246

album id

Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "title": "Most Beautiful Celebs",
  "category_id": 3,
  "description": "These are the beautiful women we all adore",
  "search": 1,
  "auth_view": "everyone",
  "auth_comment": "everyone",
  "auth_tag": "everyone"
}
Response  204
Response  400
HideShow
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "validation_fail",
  "message": {
    "title": "Please complete this field - it is required.",
    "description": "Please complete this field - it is required."
  }
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Delete Album

Delete Album
DELETE/albums/delete/{album_id}

Delete the album by log-in user

Parameters
HideShow
album_id
integer (required) Example: 148

album id

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  204
Response  400
HideShow
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "parameter_missing",
  "message": "Missing Parameters: photo_id OR album_id"
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}
Response  404
HideShow
Body
{
  "status_code": 404,
  "error": true,
  "error_code": "no_record",
  "message": "No record found"
}

Photo Albums Plugin / Photos

APIs allow to Xiglute members to manage Photo Albums Plugin / Photos and allow to get paginated list of album photos, delete photo, flip photo and rotate photo. Please find APIs following:

Photos List

Get Photos List
GET/albums/photo/list/{album_id}{?page}

Get the paginated list of album photos

In case of pagination, we need to use 2 parameters limit and page. Use limit to set the number of photos in response and use page for the page number. [i.e: If you have 100 photos and the first request has limit=20 and page=1, then in that case the recent 20 photos will be returned in response, and if limit=20 and page=2 is sent in request, then the next 20 recent photos will be returned.]

Parameters
HideShow
album_id
integer (required) Example: album_id=58

get the list of photos

page
integer (optional) Example: page=2

return the ‘limit’ number of photos of that page of photo listings.

limit
integer (optional) Example: limit=20

number of photos. Default limit is 10.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "canUpload": 0,
  "photos": [
    {
      "photo_id": 20,
      "album_id": 3,
      "title": "",
      "description": "",
      "creation_date": "2015-04-09 07:49:21",
      "modified_date": "2015-06-22 14:05:46",
      "order": 0,
      "owner_type": "user",
      "owner_id": 1,
      "file_id": 306,
      "view_count": 0,
      "comment_count": 0,
      "skip_photo": 0,
      "owner_title": "Mike Husstle",
      "album_title": "Blog Photos",
      "is_like": 0,
      "like_count": 0,
      "image": "http://example.com/public/album_photo/33/01/0132_9083.jpg",
      "image_normal": "http://example.com/public/album_photo/34/01/0133_798f.jpg",
      "image_profile": "http://example.com/public/album_photo/33/01/0132_9083.jpg",
      "image_icon": "http://example.com/public/album_photo/33/01/0132_9083.jpg",
      "content_url": "http://example.com/albums/photo/view/album_id/2/photo_id/6",
      "menu": [
        {
          "label": "Share",
          "name": "share",
          "url": "activity/share",
          "urlParams": {
            "type": "album_photo",
            "id": 20
          }
        },
        {
          "label": "Report",
          "name": "report",
          "url": "report/create/subject/album_photo_20",
          "urlParams": {
            "type": "album_photo",
            "id": 20
          }
        },
        {
          "label": "Make Profile Photo",
          "name": "make_profile_photo",
          "url": "members/edit/external-photo",
          "urlParams": {
            "photo": "album_photo_20"
          }
        }
      ]
    },
    {
      "photo_id": 25,
      "album_id": 3,
      "title": "",
      "description": "",
      "creation_date": "2015-04-09 07:49:21",
      "modified_date": "2015-06-22 14:05:46",
      "order": 0,
      "owner_type": "user",
      "owner_id": 1,
      "file_id": 306,
      "view_count": 0,
      "comment_count": 0,
      "skip_photo": 0,
      "owner_title": "Mike Husstle",
      "album_title": "Blog Photos",
      "is_like": 0,
      "like_count": 0,
      "image": "http://example.com/public/album_photo/33/01/0132_9083.jpg",
      "image_normal": "http://example.com/public/album_photo/34/01/0133_798f.jpg",
      "image_profile": "http://example.com/public/album_photo/33/01/0132_9083.jpg",
      "image_icon": "http://example.com/public/album_photo/33/01/0132_9083.jpg",
      "content_url": "http://example.com/albums/photo/view/album_id/2/photo_id/6",
      "menu": [
        {
          "label": "Share",
          "name": "share",
          "url": "activity/share",
          "urlParams": {
            "type": "album_photo",
            "id": 20
          }
        },
        {
          "label": "Report",
          "name": "report",
          "url": "report/create/subject/album_photo_20",
          "urlParams": {
            "type": "album_photo",
            "id": 20
          }
        },
        {
          "label": "Make Profile Photo",
          "name": "make_profile_photo",
          "url": "members/edit/external-photo",
          "urlParams": {
            "photo": "album_photo_20"
          }
        }
      ]
    }
  ]
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Upload Photos
POST/albums/photo/list/{album_id}{?page}

Upload the photos into the album

To upload the album photos, send the files as an array of multipart / form-data elements with the API request parameters.

Parameters
HideShow
album_id
integer (required) Example: album_id=58

get the list of photos

page
integer (optional) Example: page=2

use page to get next limit of photos

limit
integer (optional) Example: limit=20

number of photos. Default limit is 10

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Photo View

Photo View
GET/albums/photo/view/{photo_id}{?menu}

Get the photo view page information

Parameters
HideShow
photo_id
integer (required) Example: photo_id=947

photo id

menu
integer (optional) Example: menu=0

menu in response. Default value is 1

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "message_view": false,
  "response": {
    "photo_id": 29,
    "album_id": 3,
    "title": "",
    "description": "",
    "creation_date": "2015-06-22 12:42:44",
    "modified_date": "2015-06-23 04:54:25",
    "order": 6,
    "owner_type": "user",
    "owner_id": 1,
    "file_id": 315,
    "view_count": 0,
    "comment_count": 0,
    "skip_photo": 0
  },
  "canEdit": 1,
  "canDelete": 1,
  "canTag": 1,
  "canUntagGlobal": true,
  "nextPhoto": {
    "photo_id": 12,
    "album_id": 3,
    "title": "",
    "description": "",
    "creation_date": "2015-02-17 10:13:40",
    "modified_date": "2015-04-09 08:32:06",
    "order": 7,
    "owner_type": "user",
    "owner_id": 1,
    "file_id": 120,
    "view_count": 0,
    "comment_count": 0,
    "skip_photo": 0
  },
  "previousPhoto": {
    "skipAlbumDeleteHook": null
  },
  "tags": [],
  "menu": [
    {
      "label": "Edit",
      "name": "edit",
      "url": "albums/photo/edit",
      "urlParams": {
        "album_id": 3,
        "photo_id": 29
      }
    },
    {
      "label": "Delete",
      "name": "delete",
      "url": "albums/photo/delete",
      "urlParams": {
        "album_id": 3,
        "photo_id": 29
      }
    },
    {
      "label": "Share",
      "name": "share",
      "url": "activity/index/share",
      "urlParams": {
        "type": "album_photo",
        "id": 29
      }
    },
    {
      "label": "Report",
      "name": "report",
      "url": "report/create/subject/album_photo_29"
    },
    {
      "label": "Make Profile Photo",
      "name": "make_profile_photo",
      "url": "members/edit/external-photo",
      "urlParams": {
        "photo": "album_photo_29"
      }
    }
  ]
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Edit Photo Info

Get Photo Info Form
GET/albums/photo/edit/{photo_id}

Get edit photo form

Returns the form and formValues as response. In form we get the complete edit photo form and in formValues we get the form’s values.

Parameters
HideShow
photo_id
integer (required) Example: photo_id=523

photo id

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Accept: application/json
Body
{
  "form": [
    {
      "type": "Text",
      "name": "title",
      "label": "Title",
      "hasValidator": true
    },
    {
      "type": "Textarea",
      "name": "description",
      "label": "Caption",
      "hasValidator": true
    },
    {
      "type": "Submit",
      "name": "submit",
      "label": "Submit"
    }
  ],
  "formValues": {
    "photo_id": 29,
    "album_id": 3,
    "title": "",
    "description": "",
    "creation_date": "2015-06-22 12:42:44",
    "modified_date": "2015-06-23 04:54:25",
    "order": 6,
    "owner_type": "user",
    "owner_id": 1,
    "file_id": 315,
    "view_count": 0,
    "comment_count": 0,
    "skip_photo": 0
  }
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Put Photo Info Form
PUT/albums/photo/edit/{photo_id}

Put the edit photo form values

Parameter Required Type Example Description
title yes string Harry Potter Series-1 Photo photo title
description yes string This photo is from harry potter first… photo description
Parameters
HideShow
photo_id
integer (required) Example: photo_id=523

photo id

Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Body
{
  "title": "Harry Potter Series-1 Photo",
  "description": "This photo is from harry potter first series."
}
Response  204
Response  400
HideShow
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "validation_fail",
  "message": {
    "title": "Please complete this field - it is required.",
    "description": "Please complete this field - it is required."
  }
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Delete Photo

Delete Photo
DELETE/albums/photo/delete/{photo_id}

Delete the album photo by log-in user

Parameters
HideShow
photo_id
integer (required) Example: photo_id=947

photo id

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
    "photo_id": 873,
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Rotate Photo

Rotate Photo
POST/albums/photo/rotate/{photo_id}

Rotate the album photo by the log-in user

Parameter Required Type Example Description
angle yes integer 90 photo angle [Only 90 and 270 allow]
Parameters
HideShow
photo_id
integer (required) Example: photo_id=947

photo id

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "photo_id": 873,
  "angle": 270
}
Response  200
HideShow
Headers
Accept: application/json
Body
{  
    "image":"http://example.com/public/album_photo/54/01/0153_23e0.jpg",
    "image_normal":"http://example.com/public/album_photo/55/01/0154_fb49.jpg",
    "image_profile":"http://example.com/public/album_photo/54/01/0153_23e0.jpg",
    "image_icon":"http://example.com/public/album_photo/54/01/0153_23e0.jpg",
    "content_url":"http://example.com/albums/photo/view/album_id/2/photo_id/6",
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Flip Photo

Flip Photo
POST/albums/photo/flip/{photo_id}

Flip the album photo by log-in user

Parameter Required Type Example Description
direction yes string vertical photo flip [Only “vertical” and “horizontal” allow]
Parameters
HideShow
photo_id
integer (required) Example: photo_id=947

photo id

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "photo_id": 873,
  "direction": "horizontal"
}
Response  200
HideShow
Headers
Accept: application/json
Body
{
  "image": "http://example.com/public/album_photo/54/01/0153_23e0.jpg",
  "image_normal": "http://example.com/public/album_photo/55/01/0154_fb49.jpg",
  "image_profile": "http://example.com/public/album_photo/54/01/0153_23e0.jpg",
  "image_icon": "http://example.com/public/album_photo/54/01/0153_23e0.jpg",
  "content_url": "http://example.com/albums/photo/view/album_id/2/photo_id/6"
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Blogs Plugin

These are the APIs for Xiglute’s official Blogs Plugin.

Browse Blogs

Browse Blogs
GET/blogs{?search}

Get the blogs listing. Blogs can also be browsed and searched based on keywords, categories, etc.

In case of pagination, we need to use 2 parameters limit and page. Use limit to set the number of blogs in response and use page for the page number. [i.e: If you have 100 blogs and the first request has limit=20 and page=1, then in that case the recent 20 blogs will be returned in response, and if limit=20 and page=2 is sent in request, then the next 20 recent blogs will be returned.]

Parameters
HideShow
search
string (optional) Example: search=bl

get blogs that contain this keyword in title or description.

orderby
string (optional) Example: orderby=creation_date

get blog listings in the order of descending creation date (creation_date) or descending number of views (view_count).

show
integer (optional) Example: show=1

get blogs of all users (1) or only of the member’s friends (2).

category
integer (optional) Example: category=13

get all blogs of a particular category ID.

user_id
integer (optional) Example: user_id=125

user id of profile owner. Default value is logged-in user’s ID.

page
integer (optional) Example: page=2

return the ‘limit’ number of blogs of that page of blog listings.

limit
integer (optional) Example: limit=20

number of blogs. Default limit is 20.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "canCreate": 1,
  "totalItemCount": 238,
  "response": [
    {
      "blog_id": 178,
      "title": "Head of Banking Operations",
      "body": "This is an excellent opportunity for a Senior Operations professional to play a leadership role in the expansion of our Clients' European Wealth Management/ Private Banking operation based in Frankfurt. This person will be responsible for supervising all daily operations for the German onshore business as well as the expansion and on-boarding of key E.U clients.",
      "owner_type": "user",
      "owner_id": 2,
      "category_id": 1,
      "creation_date": "2014-03-18 06:54:48",
      "modified_date": "2014-03-18 06:54:48",
      "view_count": 1748,
      "comment_count": 70,
      "search": 1,
      "draft": 0,
      "category_title": "Arts & Culture",
      "url": "http://example.com/blogs/2/178/hello-new-blog",
      "owner_image": "http://example.com/public/user/41/02/023f_eabf.jpg",
      "owner_title": "James Robert",
      "allow_to_view": 1
    },
    {
      "blog_id": 177,
      "title": "Leiter Personalentwicklung (m/w)",
      "body": "Die Cornelsen Schulverlage bündeln Erfolgsmarken wie Cornelsen, Duden Schulbuch, Oldenbourg und Volk und Wissen und gehören seit über 60 Jahren zu den Top-Playern im Markt der deutschsprachigen Bildungsmedien. Wir sind die größte Einheit innerhalb der Franz Cornelsen Bildungsgruppe, die mit über 1.500 Mitarbeitern für innovative Bildungsangebote in Deutschland, Österreich und der Schweiz sorgt. Um den Ausbau interaktiver Lernangebote weiter voran zu treiben, suchen wir Mitarbeiterinnen und Mitarbeiter, die unseren Erfolg mit ihrer Inspiration, ihrer Begeisterung und ihrem Know-How steigern. Wenn Sie Spaß daran haben, die Zukunft der Bildungsbranche aktiv mitzugestalten und einen Arbeitsplatz schätzen, der Ihnen ein hohes Maß an Eigenverantwortung und Freiraum bietet, dann sind Sie bei uns richtig.",
      "owner_type": "user",
      "owner_id": 2,
      "category_id": 1,
      "creation_date": "2014-06-22 08:15:16",
      "modified_date": "2014-07-12 08:15:16",
      "view_count": 1127,
      "comment_count": 38,
      "search": 1,
      "draft": 0,
      "category_title": "Arts & Culture",
      "url": "http://example.com/blogs/2/177/hello",
      "owner_image": "http://example.com/public/user/41/02/023f_eabf.jpg",
      "owner_title": "James Robert",
      "allow_to_view": 1
    }
  ]
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Manage Blogs

Manage Blogs
GET/blogs/manage{?search}

Get the blogs of a member. Blogs can also be browsed and searched based on keywords, categories, etc.

In case of pagination, we need to use 2 parameters limit and page. Use limit to set the number of blogs in response and use page for the page number. [i.e: If you have 100 blogs and the first request has limit=20 and page=1, then in that case the recent 20 blogs will be returned in response, and if limit=20 and page=2 is sent in request, then the next 20 recent blogs will be returned.]

Parameters
HideShow
search
string (optional) Example: search=bl

get blogs that contain this keyword in title or description.

orderby
string (optional) Example: orderby=creation_date

get blog listings in the order of descending creation date (creation_date) or descending number of views (view_count).

show
integer (optional) Example: show=1

get blogs of all users (1) or only of the member’s friends (2).

category
integer (optional) Example: category=13

get all blogs of a particular category ID.

page
integer (optional) Example: page=2

return the ‘limit’ number of blogs of that page of blog listings.

limit
integer (optional) Example: limit=20

number of blogs. Default limit is 20.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "canCreate": 1,
  "totalItemCount": 78,
  "response": [
    {
      "blog_id": 178,
      "title": "Head of Banking Operations",
      "body": "This is an excellent opportunity for a Senior Operations professional to play a leadership role in the expansion of our Clients' European Wealth Management/ Private Banking operation based in Frankfurt. This person will be responsible for supervising all daily operations for the German onshore business as well as the expansion and on-boarding of key E.U clients.",
      "owner_type": "user",
      "owner_id": 2,
      "category_id": 1,
      "creation_date": "2014-03-18 06:54:48",
      "modified_date": "2014-03-18 06:54:48",
      "view_count": 1748,
      "comment_count": 70,
      "search": 1,
      "draft": 0,
      "menu": [
        {
          "label": "Edit Blog",
          "name": "edit",
          "url": "blogs/edit/178",
          "urlParams": []
        },
        {
          "label": "Delete Blog",
          "name": "delete",
          "url": "blogs/delete/178",
          "urlParams": []
        }
      ],
      "category_title": "Arts & Culture",
      "url": "http://example.com/blogs/2/178/hello-new-blog",
      "owner_image": "http://example.com/public/user/41/02/023f_eabf.jpg",
      "owner_title": "James Robert",
      "allow_to_view": 1
    },
    {
      "blog_id": 177,
      "title": "Leiter Personalentwicklung (m/w)",
      "body": "Die Cornelsen Schulverlage bündeln Erfolgsmarken wie Cornelsen, Duden Schulbuch, Oldenbourg und Volk und Wissen und gehören seit über 60 Jahren zu den Top-Playern im Markt der deutschsprachigen Bildungsmedien. Wir sind die größte Einheit innerhalb der Franz Cornelsen Bildungsgruppe, die mit über 1.500 Mitarbeitern für innovative Bildungsangebote in Deutschland, Österreich und der Schweiz sorgt. Um den Ausbau interaktiver Lernangebote weiter voran zu treiben, suchen wir Mitarbeiterinnen und Mitarbeiter, die unseren Erfolg mit ihrer Inspiration, ihrer Begeisterung und ihrem Know-How steigern. Wenn Sie Spaß daran haben, die Zukunft der Bildungsbranche aktiv mitzugestalten und einen Arbeitsplatz schätzen, der Ihnen ein hohes Maß an Eigenverantwortung und Freiraum bietet, dann sind Sie bei uns richtig.",
      "owner_type": "user",
      "owner_id": 2,
      "category_id": 1,
      "creation_date": "2014-06-22 08:15:16",
      "modified_date": "2014-07-12 08:15:16",
      "view_count": 1127,
      "comment_count": 38,
      "search": 1,
      "draft": 0,
      "menu": [
        {
          "label": "Edit Blog",
          "name": "edit",
          "url": "blogs/edit/177",
          "urlParams": []
        },
        {
          "label": "Delete Blog",
          "name": "delete",
          "url": "blogs/delete/177",
          "urlParams": []
        }
      ],
      "category_title": "Arts & Culture",
      "url": "http://example.com/blogs/2/177/hello",
      "owner_image": "http://example.com/public/user/41/02/023f_eabf.jpg",
      "owner_title": "James Robert",
      "allow_to_view": 1
    }
  ]
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Blogs Search Form

Blogs Search Form
GET/blogs/search-form

Get the blogs search form.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "type": "Text",
    "name": "search",
    "label": "Search Blogs"
  },
  {
    "type": "Select",
    "name": "orderby",
    "label": "Browse By",
    "multiOptions": {
      "creation_date": "Most Recent",
      "view_count": "Most Viewed"
    }
  },
  {
    "type": "Select",
    "name": "show",
    "label": "Show",
    "multiOptions": {
      "1": "Everyone's Blogs",
      "2": "Only My Friends' Blogs"
    }
  },
  {
    "type": "Select",
    "name": "category",
    "label": "Category",
    "multiOptions": {
      "0": "All Categories",
      "1": "Arts & Culture",
      "2": "Business",
      "3": "Entertainment",
      "5": "Family & Home",
      "6": "Health",
      "7": "Recreation",
      "8": "Personal",
      "9": "Shopping",
      "10": "Society",
      "11": "Sports",
      "12": "Technology",
      "13": "Other"
    }
  },
  {
    "type": "Submit",
    "name": "submit",
    "label": "Search"
  }
]
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Create Blog

Get Blog Creation Form
GET/blogs/create

Get the blog creation form.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "type": "Text",
    "name": "title",
    "label": "Title",
    "hasValidator": true
  },
  {
    "type": "Text",
    "name": "tags",
    "label": "Tags (Keywords)",
    "hasValidator": true
  },
  {
    "type": "Select",
    "name": "category_id",
    "label": "Category",
    "multiOptions": {
      "1": "Arts & Culture",
      "2": "Business",
      "3": "Entertainment",
      "5": "Family & Home",
      "6": "Health",
      "7": "Recreation",
      "8": "Personal",
      "9": "Shopping",
      "10": "Society",
      "11": "Sports",
      "12": "Technology",
      "13": "Other"
    }
  },
  {
    "type": "Select",
    "name": "draft",
    "label": "Status",
    "multiOptions": [
      "Published",
      "Saved As Draft"
    ],
    "description": "If this entry is published, it cannot be switched back to draft mode."
  },
  {
    "type": "Textarea",
    "name": "body",
    "label": "body"
  },
  {
    "type": "Checkbox",
    "name": "search",
    "label": "Show this blog entry in search results"
  },
  {
    "type": "Select",
    "name": "auth_view",
    "label": "Privacy",
    "multiOptions": {
      "everyone": "Everyone",
      "owner_network": "Friends and Networks",
      "owner_member_member": "Friends of Friends",
      "owner_member": "Friends Only",
      "owner": "Just Me"
    },
    "value": "everyone"
  },
  {
    "type": "Select",
    "name": "auth_comment",
    "label": "Comment Privacy",
    "description": "Who may post comments on this blog entry?",
    "multiOptions": {
      "everyone": "Everyone",
      "owner_network": "Friends and Networks",
      "owner_member_member": "Friends of Friends",
      "owner_member": "Friends Only",
      "owner": "Just Me"
    },
    "value": "everyone"
  },
  {
    "type": "Submit",
    "name": "submit",
    "label": "Post Entry"
  }
]
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Create Blog
POST/blogs/create

Create a new blog by posting the blog creation form.

Parameter Required Type Example Description
title yes string Head of Banking Operations blog title
tags no string banking, operations blog tags (comma separated)
category_id yes integer 2 category id
draft yes integer 1 save in draft (1), or publish (0)
body yes string This is an excellent opportunity… blog content
search no boolean 1 make blog searchable (1) or not (0)
auth_view yes string everyone view authorization (everyone, owner_network, etc.)
auth_comment yes string everyone comment authorization (everyone, owner_network, etc.)
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "title": "Head of Banking Operations",
  "tags": "banking, operations",
  "category_id": 3,
  "draft": 0,
  "body": "This is an excellent opportunity for a Senior Operations professional to play a leadership role in the expansion of our Clients' European Wealth Management/ Private Banking operation based in Frankfurt. This person will be responsible for supervising all daily operations for the German onshore business as well as the expansion and on-boarding of key E.U clients.",
  "search": 1,
  "auth_view": "everyone",
  "auth_comment": "everyone"
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
    "gutterMenu": {
        "share": {  
            "label": "Share",
            "url": "activity/share",
            "urlParams": {
                "type": "blog",
                "id": 8
            }
        },
        "report": {  
            "label": "Report",
            "url": "report/create/subject/blog_8",
            "urlParams": {  
                "type": "blog",
                "id": 8
            }
        },
        "subscribe": {  
            "label": "Subscribe",
            "url": "blogs/subscribe",
            "urlParams": {  
                "user_id": 2
            }
        }
    },

    "response": {  
        "blog_id": 178,
        "title": "Head of Banking Operations",
        "body": "This is an excellent opportunity for a Senior Operations professional to play a leadership role in the expansion of our Clients' European Wealth Management/ Private Banking operation based in Frankfurt. This person will be responsible for supervising all daily operations for the German onshore business as well as the expansion and on-boarding of key E.U clients.",
        "owner_type": "user",
        "owner_id": 2,
        "category_id": 1,
        "creation_date": "2014-03-18 06:54:48",
        "modified_date": "2014-03-18 06:54:48",
        "view_count": 1748,
        "comment_count": 70,
        "search": 1,
        "draft": 0,
        "url": "http://example.com/blogs/2/8/non-not",
        "owner_image": "http://example.com/public/user/3f/02/023d_0ab4.jpg",
        "owner_title": "James Robert",
        "tags": [
            "3" => "banking",
            "8" => "operations"
        ],
        "category_title": "Arts & Culture"
    }
}
Response  400
HideShow
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "validation_fail",
  "message": {
    "title": "Please complete this field - it is required.",
    "body": "Please complete this field - it is required."
  }
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Blog Profile

Blog Profile
GET/blogs/view/{blog_id}{?gutter_menu}

Get a blog post and its gutter menu’s (edit, delete, share, report, subscribe) information.

Parameters
HideShow
blog_id
integer (required) Example: 20

blog id

gutter_menu
boolean (optional) Example: gutter_menu=1 OR 0

get gutter menu’s array. Default valus is 1.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
    "gutterMenu": {
        "share": {  
            "label": "Share",
            "url": "activity/share",
            "urlParams": {
                "type": "blog",
                "id": 8
            }
        },
        "report": {  
            "label": "Report",
            "url": "report/create/subject/blog_8",
            "urlParams": {  
                "type": "blog",
                "id": 8
            }
        },
        "subscribe": {  
            "label": "Subscribe",
            "url": "blogs/subscribe",
            "urlParams": {  
                "user_id": 2
            }
        }
    },

    "response": {  
        "blog_id": 178,
        "title": "Head of Banking Operations",
        "body": "This is an excellent opportunity for a Senior Operations professional to play a leadership role in the expansion of our Clients' European Wealth Management/ Private Banking operation based in Frankfurt. This person will be responsible for supervising all daily operations for the German onshore business as well as the expansion and on-boarding of key E.U clients.",
        "owner_type": "user",
        "owner_id": 2,
        "category_id": 1,
        "creation_date": "2014-03-18 06:54:48",
        "modified_date": "2014-03-18 06:54:48",
        "view_count": 1748,
        "comment_count": 70,
        "search": 1,
        "draft": 0,
        "url": "http://example.com/blogs/2/8/non-not",
        "owner_image": "http://example.com/public/user/3f/02/023d_0ab4.jpg",
        "owner_title": "James Robert",
        "tags": [
            "3" => "banking",
            "8" => "operations"
        ],
        "category_title": "Arts & Culture"
    }
}
Response  400
HideShow
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "parameter_missing",
  "message": "Missing Parameters: blog_id"
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}
Response  404
HideShow
Body
{
  "status_code": 404,
  "error": true,
  "error_code": "no_record",
  "message": "No record found"
}

Edit Blog

Get Edit Blog Form
GET/blogs/edit/{blog_id}

Get the form for editing a blog-post.

Returns the form and formValues as response. In form we get the complete blog form and in formValues we get the form’s values.

Parameters
HideShow
blog_id
integer (required) Example: 1246

blog id

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "form": [
    {
      "type": "Text",
      "name": "title",
      "label": "Title",
      "hasValidator": true
    },
    {
      "type": "Text",
      "name": "tags",
      "label": "Tags (Keywords)",
      "hasValidator": true
    },
    {
      "type": "Select",
      "name": "category_id",
      "label": "Category",
      "multiOptions": {
        "1": "Arts & Culture",
        "2": "Business",
        "3": "Entertainment",
        "5": "Family & Home",
        "6": "Health",
        "7": "Recreation",
        "8": "Personal",
        "9": "Shopping",
        "10": "Society",
        "11": "Sports",
        "12": "Technology",
        "13": "Other"
      }
    },
    {
      "type": "Select",
      "name": "draft",
      "label": "Status",
      "multiOptions": [
        "Published",
        "Saved As Draft"
      ],
      "description": "If this entry is published, it cannot be switched back to draft mode."
    },
    {
      "type": "Textarea",
      "name": "body",
      "label": "body"
    },
    {
      "type": "Checkbox",
      "name": "search",
      "label": "Show this blog entry in search results"
    },
    {
      "type": "Select",
      "name": "auth_view",
      "label": "Privacy",
      "multiOptions": {
        "everyone": "Everyone",
        "owner_network": "Friends and Networks",
        "owner_member_member": "Friends of Friends",
        "owner_member": "Friends Only",
        "owner": "Just Me"
      },
      "value": "everyone"
    },
    {
      "type": "Select",
      "name": "auth_comment",
      "label": "Comment Privacy",
      "description": "Who may post comments on this blog entry?",
      "multiOptions": {
        "everyone": "Everyone",
        "owner_network": "Friends and Networks",
        "owner_member_member": "Friends of Friends",
        "owner_member": "Friends Only",
        "owner": "Just Me"
      },
      "value": "everyone"
    },
    {
      "type": "Submit",
      "name": "submit",
      "label": "Post Entry"
    }
  ],
  "formValues": {
    "blog_id": 178,
    "title": "Head of Banking Operations",
    "body": "This is an excellent opportunity for a Senior Operations professional to play a leadership role in the expansion of our Clients' European Wealth Management/ Private Banking operation based in Frankfurt. This person will be responsible for supervising all daily operations for the German onshore business as well as the expansion and on-boarding of key E.U clients.",
    "owner_type": "user",
    "owner_id": 2,
    "category_id": 1,
    "creation_date": "2014-03-18 06:54:48",
    "modified_date": "2014-03-18 06:54:48",
    "view_count": 1748,
    "comment_count": 70,
    "search": 1,
    "draft": 0,
    "auth_view": "everyone",
    "auth_comment": "everyone",
    "tags": "banking, operations"
  }
}
Response  400
HideShow
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "parameter_missing",
  "message": "Missing Parameters: blog_id"
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Edit Blog
PUT/blogs/edit/{blog_id}

Edit a blog-post.

Parameter Required Type Example Description
title yes string Head of Banking Operations blog title
tags no string banking, operations blog tags (comma separated)
category_id yes integer 2 category id
draft yes integer 1 save in draft (1), or publish (0)
body yes string This is an excellent opportunity… blog content
search no boolean 1 make blog searchable (1) or not (0)
auth_view yes string everyone view authorization (everyone, owner_network, etc.)
auth_comment yes string everyone comment authorization (everyone, owner_network, etc.)
Parameters
HideShow
blog_id
integer (required) Example: blog_id=1246

blog id

Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
    "blog_id": 278,
    "title": "Head of Banking Operations"
    "tags": "banking, operations"
    "category_id": 2,
    "draft": 0,
    "body": "This is an excellent opportunity for a Senior Operations professional to play a leadership role in the expansion of our Clients' European Wealth Management/ Private Banking operation based in Frankfurt. This person will be responsible for supervising all daily operations for the German onshore business as well as the expansion and on-boarding of key E.U clients.",
    "search": 1,
    "auth_view": "everyone",
    "auth_comment": "everyone"
}
Response  204
Response  400
HideShow
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "validation_fail",
  "message": {
    "title": "Please complete this field - it is required.",
    "body": "Please complete this field - it is required."
  }
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Get User's Blog Categories

Get User's Blog Categories
GET/blogs/category{?owner_id}

Get the categories of all the blog posts created by a user.

Parameters
HideShow
owner_id
integer (required) Example: owner_id=923

owner id

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "1": "Arts & Culture",
  "2": "Business",
  "3": "Entertainment",
  "5": "Family & Home",
  "6": "Health",
  "7": "Recreation"
}
Response  400
HideShow
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "parameter_missing",
  "message": "Missing Parameters: owner_id"
}
Response  404
HideShow
Body
{
  "status_code": 404,
  "error": true,
  "error_code": "no_record",
  "message": "No record found"
}

Get User's Blog Tags

Get User's Blog Tags
GET/blogs/tag{?owner_id}

Get the tags of all the blog posts created by a user.

Parameters
HideShow
owner_id
integer (required) Example: owner_id=924

owner id

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
[
  {
    "tag_id": 1,
    "text": "pentagon"
  },
  {
    "tag_id": 2,
    "text": "algeria"
  },
  {
    "tag_id": 6,
    "text": "farming"
  }
]
Response  400
HideShow
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "parameter_missing",
  "message": "Missing Parameters: owner_id"
}
Response  404
HideShow
Body
{
  "status_code": 404,
  "error": true,
  "error_code": "no_record",
  "message": "No record found"
}

Blogs Subscribe

Blogs Subscribe
POST/blogs/subscribe

Subscribe to the blog-posts of a user.

Parameter Required Type Example Description
owner_id yes integer 924 owner id
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "owner_id": 924
}
Response  204
Response  400
HideShow
Headers
Content-Type: application/json
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "parameter_missing",
  "message": "Missing Parameters: owner_id"
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Blogs Unsubscribe

Blogs Unsubscribe
POST/blogs/unsubscribe

Unsubscribe from the blog-posts of a user.

Parameter Required Type Example Description
owner_id yes integer 924 owner id
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "owner_id": 924
}
Response  204
Response  400
HideShow
Headers
Content-Type: application/json
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "parameter_missing",
  "message": "Missing Parameters: owner_id"
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Delete Blog

Delete Blog
DELETE/blogs/delete/{blog_id}

Delete a blog-post.

Parameters
HideShow
blog_id
integer (required) Example: 148

blog id

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  204
Response  400
HideShow
Headers
Content-Type: application/json
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "parameter_missing",
  "message": "Missing Parameters: blog_id"
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}
Response  404
HideShow
Body
{
  "status_code": 404,
  "error": true,
  "error_code": "no_record",
  "message": "No record found"
}

Classifieds Plugin

These are the APIs for Xiglute’s official Classifieds Plugin.

Browse Classifieds

Browse Classifieds
GET/classifieds{?search}{?page}

Get the classified listings. Classifieds can also be browsed and searched based on keywords, categories, etc.

In case of pagination, we need to use 2 parameters limit and page. Use limit to set the number of classifieds in response and use page for the page number. [i.e: If you have 100 classifieds and the first request has limit=20 and page=1, then in that case the recent 20 classifieds will be returned in response, and if limit=20 and page=2 is sent in request, then the next 20 recent classifieds will be returned.]

Parameters
HideShow
search
string (optional) Example: search=bl

get classifieds that contain this keyword in title or description.

orderby
string (optional) Example: orderby=creation_date

get classified listings in the order of descending creation date (creation_date) or descending number of views (view_count).

show
integer (optional) Example: show=1

get classified of all users (1) or only of the member’s friends (2).

closed
integer (optional) Example: closed=1

get open (closed=0) or closed (closed=1) classified listings.

category
integer (optional) Example: category=13

get all classifieds of a particular category ID.

user_id
integer (optional) Example: user_id=125

user id of profile owner. Default value is logged-in user’s ID.

page
integer (optional) Example: page=2

return the ‘limit’ number of classifieds of that page of classified listings.

limit
integer (optional) Example: limit=20

number of classifieds. Default limit is 20.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
    "canCreate": 1,
    "response": [
        {
            "classified_id": 242,
            "title": "Oxford Dictionary of Biology 6th Edition",
            "body": "<p>Students of biology at A level and undergraduate level.</p><p>Students of related subjects. Professionals, teachers, and anyone coming into contact with terms and concepts in biology.</p>",
            "owner_id": 1,
            "category_id": 1,
            "photo_id": 836,
            "creation_date": "2014-08-17 06:48:44",
            "modified_date": "2014-08-17 06:48:44",
            "view_count": 430,
            "comment_count": 120,
            "search": 1,
            "closed": 0,
            "category_title": "Arts & Culture",
            "profile_fields":{  
                "Price":"200",
                "Locations":"California"
            },
            "url": "http://example.com/classifieds/1/2/classified-title-2",
            "image": "http://example.com/public/classified/49/03/0346_64ec.png",
            "image_icon": "http://example.com/public/classified/49/03/0346_65ec.png",
            "image_profile": "http://example.com/public/classified/49/03/0346_66ec.png",
            "image_normal": "http://example.com/public/classified/49/03/0346_67ec.png",
            "owner_title": "Jennifer Aniston"
            "allow_to_view":1,
            "is_edit":1,
            "is_delete":1
        },
        {
            "classified_id": 244,
            "title": "Neuromancer",
            "body": "<p>Spine tight and slightly bent with stress lines noticeable. Slight creases or bends in the cover. Pages mostly white. Light wear and minor rubbing noticeable on extremities. Winner of the Nebula, Philip K. Dick, SF Chronicle, Ditmar (International), and the Hugo Awards for Best SF Novel. 51st printing.</p>",
            "owner_id": 1,
            "category_id": 1,
            "photo_id": 832,
            "creation_date": "2014-08-25 06:47:40",
            "modified_date": "2014-08-25 06:47:40",
            "view_count": 650,
            "comment_count": 67,
            "search": 1,
            "closed": 0,
            "category_title": "Arts & Culture",
            "profile_fields":{  
                "Price":"200",
                "Locations":"California"
            },
            "url": "http://example.com/classifieds/1/1/classified-title",
            "image": "http://example.com/public/classified/49/03/0346_64ec.png",
            "image_icon": "http://example.com/public/classified/49/03/0346_65ec.png",
            "image_profile": "http://example.com/public/classified/49/03/0346_66ec.png",
            "image_normal": "http://example.com/public/classified/49/03/0346_67ec.png",
            "owner_title": "Jennifer Aniston"
            "allow_to_view":1,
            "is_edit":1,
            "is_delete":1
        }
    ]
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

My Classifieds

My Classifieds
GET/classifieds/manage{?search}

Get the classifieds of a member. Classifieds can also be browsed and searched based on keywords, categories, etc.

In case of pagination, we need to use 2 parameters limit and page. Use limit to set the number of classifieds in response and use page for the page number. [i.e: If you have 100 classifieds and the first request has limit=20 and page=1, then in that case the recent 20 classifieds will be returned in response, and if limit=20 and page=2 is sent in request, then the next 20 recent classifieds will be returned.]

Parameters
HideShow
search
string (optional) Example: search=bl

get classifieds that contain this keyword in title or description.

orderby
string (optional) Example: orderby=creation_date

get classified listings in the order of descending creation date (creation_date) or descending number of views (view_count).

show
integer (optional) Example: show=1

get classified of all users (1) or only of the member’s friends (2).

closed
integer (optional) Example: closed=1

get open (closed=0) or closed (closed=1) classified listings.

category
integer (optional) Example: category=13

get all classifieds of a particular category ID.

page
integer (optional) Example: page=2

return the ‘limit’ number of classifieds of that page of classified listings.

limit
integer (optional) Example: limit=20

number of classifieds. Default limit is 20.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "canCreate": 1,
  "response": [
    {
      "classified_id": 242,
      "title": "Oxford Dictionary of Biology 6th Edition",
      "body": "<p>Students of biology at A level and undergraduate level.</p><p>Students of related subjects. Professionals, teachers, and anyone coming into contact with terms and concepts in biology.</p>",
      "owner_id": 1,
      "category_id": 1,
      "photo_id": 836,
      "creation_date": "2014-08-17 06:48:44",
      "modified_date": "2014-08-17 06:48:44",
      "view_count": 430,
      "comment_count": 120,
      "search": 1,
      "closed": 0,
      "menu": [
        {
          "label": "Edit Listing",
          "name": "edit",
          "url": "classifieds/edit/242",
          "urlParams": []
        },
        {
          "label": "Delete Listing",
          "name": "delete",
          "url": "classifieds/delete/242",
          "urlParams": []
        }
      ],
      "category_title": "Arts & Culture",
      "profile_fields": {
        "Price": "200",
        "Locations": "California"
      },
      "url": "http://example.com/classifieds/1/2/classified-title-2",
      "image": "http://example.com/public/classified/49/03/0346_64ec.png",
      "image_icon": "http://example.com/public/classified/49/03/0346_65ec.png",
      "image_profile": "http://example.com/public/classified/49/03/0346_66ec.png",
      "image_normal": "http://example.com/public/classified/49/03/0346_67ec.png",
      "owner_title": "Jennifer Aniston"
    },
    {
      "classified_id": 244,
      "title": "Neuromancer",
      "body": "<p>Spine tight and slightly bent with stress lines noticeable. Slight creases or bends in the cover. Pages mostly white. Light wear and minor rubbing noticeable on extremities. Winner of the Nebula, Philip K. Dick, SF Chronicle, Ditmar (International), and the Hugo Awards for Best SF Novel. 51st printing.</p>",
      "owner_id": 1,
      "category_id": 1,
      "photo_id": 832,
      "creation_date": "2014-08-25 06:47:40",
      "modified_date": "2014-08-25 06:47:40",
      "view_count": 650,
      "comment_count": 67,
      "search": 1,
      "closed": 0,
      "menu": [
        {
          "label": "Edit Listing",
          "name": "edit",
          "url": "classifieds/edit/244",
          "urlParams": []
        },
        {
          "label": "Delete Listing",
          "name": "delete",
          "url": "classifieds/delete/244",
          "urlParams": []
        }
      ],
      "category_title": "Arts & Culture",
      "profile_fields": {
        "Price": "200",
        "Locations": "California"
      },
      "url": "http://example.com/classifieds/1/1/classified-title",
      "image": "http://example.com/public/classified/49/03/0346_64ec.png",
      "image_icon": "http://example.com/public/classified/49/03/0346_65ec.png",
      "image_profile": "http://example.com/public/classified/49/03/0346_66ec.png",
      "image_normal": "http://example.com/public/classified/49/03/0346_67ec.png",
      "owner_title": "Jennifer Aniston"
    }
  ]
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Classifieds Search Form

Classifieds Search Form
GET/classifieds/search-form

Get the classifieds search form.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Response  200
HideShow
Headers
Content-Type: application/json
Body
[
    "search": {
        "type": "Text",
        "name": "search",
        "label": "Search Classifieds"
    },
    "orderby": {  
        "type": "Select",
        "name": "orderby",
        "label": "Browse By",
        "multiOptions": {  
            "creation_date": "Most Recent",
            "view_count": "Most Viewed"
        }
    },
    "show": {  
        "type": "Select",
        "name": "show",
        "label": "Show",
        "multiOptions": {  
            "1": "Everyone's Posts",
            "2": "Only My Friends' Posts"
        }
    },
    "closed": {  
        "type": "Select",
        "name": "closed",
        "label": "Status",
        "multiOptions": {  
            "": "All Listings",
            "0": "Only Open Listings",
            "1": "Only Closed Listings"
        }
    },
    "category": {  
        "type": "Select",
        "name": "category",
        "label": "Category",
        "multiOptions": [  
            "All Categories",
            "Arts & Culture",
            "Business",
            "Entertainment",
            "Family & Home",
            "Health",
            "Other",
            "Personal",
            "Recreation",
            "Shopping",
            "Society",
            "Sports",
            "Technology"
        ]
    },
    "has_photo": {  
        "type": "Checkbox",
        "name": "has_photo",
        "label": "Only Classifieds With Photos"
    }
]
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Create Classified

Get Classified Creation Form
GET/classifieds/create

Get the classified creation form.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "title": {
    "type": "Text",
    "name": "title",
    "label": "Listing Title",
    "hasValidator": true
  },
  "tags": {
    "type": "Text",
    "name": "tags",
    "label": "Tags (Keywords)"
  },
  "category_id": {
    "type": "Select",
    "name": "category_id",
    "label": "Category",
    "multiOptions": {
      "1": "Arts & Culture",
      "2": "Business",
      "3": "Entertainment",
      "5": "Family & Home",
      "6": "Health",
      "7": "Recreation",
      "8": "Personal",
      "9": "Shopping",
      "10": "Society",
      "11": "Sports",
      "12": "Technology",
      "13": "Other"
    }
  },
  "body": {
    "type": "Textarea",
    "name": "body",
    "label": "Description",
    "hasValidator": true
  },
  "photo": {
    "type": "File",
    "name": "photo",
    "label": "Main Photo"
  },
  "auth_view": {
    "type": "Select",
    "name": "auth_view",
    "label": "Privacy",
    "description": "Who may see this classified listing?",
    "multiOptions": {
      "everyone": "Everyone",
      "owner_network": "Friends and Networks",
      "owner_member_member": "Friends of Friends",
      "owner_member": "Friends Only",
      "owner": "Just Me"
    },
    "value": "everyone"
  },
  "auth_comment": {
    "type": "Select",
    "name": "auth_comment",
    "label": "Comment Privacy",
    "description": "Who may post comments on this classified listing?",
    "multiOptions": {
      "everyone": "Everyone",
      "owner_network": "Friends and Networks",
      "owner_member_member": "Friends of Friends",
      "owner_member": "Friends Only",
      "owner": "Just Me"
    },
    "value": "everyone"
  },
  "submit": {
    "type": "Submit",
    "name": "submit",
    "label": "Post Listing"
  }
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Create Classified
POST/classifieds/create

Create a new classified by posting the classified creation form.

To upload the listing photo, send the file in multipart / form-data format with the API request parameters.

Parameter Required Type Example Description
title yes string Oxford Dictionary of Biology 6th Edition classified title
tags no string dictionary, biology classified tags (comma separated)
category_id yes integer 2 category id
body yes string Students of biology at A level and undergraduate level… classified content
auth_view yes string everyone view authorization (everyone, owner_network, etc.)
auth_comment yes string everyone comment authorization (everyone, owner_network, etc.)
Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Body
{
  "title": "Oxford Dictionary of Biology 6th Edition",
  "tags": "dictionary, biology",
  "category_id": 3,
  "body": "Students of biology at A level and undergraduate level. Students of related subjects. Professionals, teachers, and anyone coming into contact with terms and concepts in biology.",
  "auth_view": "everyone",
  "auth_comment": "everyone"
}
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "classified_id": 244,
  "title": "Oxford Dictionary of Biology 6th Edition",
  "body": "Students of biology at A level and undergraduate level...</p>",
  "owner_id": 1,
  "category_id": 1,
  "photo_id": 832,
  "creation_date": "2014-08-24 06:47:40",
  "modified_date": "2014-08-24 06:47:40",
  "view_count": 650,
  "comment_count": 67,
  "search": 1,
  "closed": 0,
  "category_title": "Arts & Culture",
  "url": "http://example.com/classifieds/1/1/classified-title",
  "images": [
    {
      "main": "http://example.com/public/classified/43/03/0340_3c26.png",
      "profile": "http://example.com/public/classified/44/03/0341_0453.png",
      "normal": "http://example.com/public/classified/45/03/0342_64ec.png",
      "icon": "http://example.com/public/classified/46/03/0343_b8a4.png"
    }
  ],
  "owner_image": "http://dev1.bigsteptech.in/public/classified/46/03/0343_b8a4.png",
  "owner_title": "Jennifer Aniston",
  "gutterMenu": {
    "edit": {
      "label": "Edit",
      "url": "classifieds/edit/244",
      "urlParams": {}
    },
    "delete": {
      "label": "Delete",
      "url": "classifieds/delete/244",
      "urlParams": {}
    },
    "close": {
      "label": "Close",
      "url": "classifieds/close/244",
      "urlParams": {
        "closed": 1
      }
    },
    "share": {
      "label": "Share",
      "url": "activity/share",
      "urlParams": {
        "type": "classified",
        "id": 1
      }
    }
  }
}
Response  400
HideShow
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "validation_fail",
  "message": {
    "title": "Please complete this field - it is required.",
    "body": "Please complete this field - it is required."
  }
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Classified Profile

Classified Profile
GET/classifieds/view/{classified_id}{?gutter_menu}

Get a classified post and its gutter menu’s (edit, delete, share, report) information.

Parameters
HideShow
classified_id
integer (required) Example: classified_id=20

classified id

gutter_menu
boolean (optional) Example: gutter_menu=1 OR 0

get gutter menu’s array. Default valus is 1.

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Response  200
HideShow
Headers
Content-Type: application/json
Body
{
  "classified_id": 244,
  "title": "Neuromancer",
  "body": "<p>Spine tight and slightly bent with stress lines noticeable. Slight creases or bends in the cover. Pages mostly white. Light wear and minor rubbing noticeable on extremities. Winner of the Nebula, Philip K. Dick, SF Chronicle, Ditmar (International), and the Hugo Awards for Best SF Novel. 51st printing.</p>",
  "owner_id": 1,
  "category_id": 1,
  "photo_id": 832,
  "creation_date": "2014-08-24 06:47:40",
  "modified_date": "2014-08-24 06:47:40",
  "view_count": 650,
  "comment_count": 67,
  "search": 1,
  "closed": 0,
  "category_title": "Arts & Culture",
  "url": "http://example.com/classifieds/1/1/classified-title",
  "images": [
    {
      "main": "http://example.com/public/classified/43/03/0340_3c26.png",
      "profile": "http://example.com/public/classified/44/03/0341_0453.png",
      "normal": "http://example.com/public/classified/45/03/0342_64ec.png",
      "icon": "http://example.com/public/classified/46/03/0343_b8a4.png"
    }
  ],
  "owner_image": "http://dev1.bigsteptech.in/public/classified/46/03/0343_b8a4.png",
  "owner_title": "Jennifer Aniston",
  "gutterMenu": {
    "edit": {
      "label": "Edit",
      "url": "classifieds/edit/244",
      "urlParams": {}
    },
    "delete": {
      "label": "Delete",
      "url": "classifieds/delete/244",
      "urlParams": {}
    },
    "close": {
      "label": "Close",
      "url": "classifieds/close/244",
      "urlParams": {
        "closed": 1
      }
    },
    "share": {
      "label": "Share",
      "url": "activity/share",
      "urlParams": {
        "type": "classified",
        "id": 1
      }
    }
  }
}
Response  400
HideShow
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "parameter_missing",
  "message": "Missing Parameters: classified_id"
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}
Response  404
HideShow
Body
{
  "status_code": 404,
  "error": true,
  "error_code": "no_record",
  "message": "No record found"
}

Edit Classified

Get Edit Classified Form
GET/classifieds/edit/{classified_id}

Get the form for editing a classified-post.

Returns the form and formValues as response. In form we get the complete classified form and in formValues we get the form’s values.

Parameters
HideShow
classified_id
integer (required) Example: 8

classified id

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Response  200
HideShow
Headers
Accept: application/json
Body
{
  "form": {
    "title": {
      "type": "Text",
      "name": "title",
      "label": "Listing Title",
      "hasValidator": true
    },
    "tags": {
      "type": "Text",
      "name": "tags",
      "label": "Tags (Keywords)"
    },
    "category_id": {
      "type": "Select",
      "name": "category_id",
      "label": "Category",
      "multiOptions": {
        "1": "Arts & Culture",
        "2": "Business",
        "3": "Entertainment",
        "5": "Family & Home",
        "6": "Health",
        "7": "Recreation",
        "8": "Personal",
        "9": "Shopping",
        "10": "Society",
        "11": "Sports",
        "12": "Technology",
        "13": "Other"
      }
    },
    "body": {
      "type": "Textarea",
      "name": "body",
      "label": "Description",
      "hasValidator": true
    },
    "photo": {
      "type": "File",
      "name": "photo",
      "label": "Main Photo"
    },
    "auth_view": {
      "type": "Select",
      "name": "auth_view",
      "label": "Privacy",
      "description": "Who may see this classified listing?",
      "multiOptions": {
        "everyone": "Everyone",
        "owner_network": "Friends and Networks",
        "owner_member_member": "Friends of Friends",
        "owner_member": "Friends Only",
        "owner": "Just Me"
      },
      "value": "everyone"
    },
    "auth_comment": {
      "type": "Select",
      "name": "auth_comment",
      "label": "Comment Privacy",
      "description": "Who may post comments on this classified listing?",
      "multiOptions": {
        "everyone": "Everyone",
        "owner_network": "Friends and Networks",
        "owner_member_member": "Friends of Friends",
        "owner_member": "Friends Only",
        "owner": "Just Me"
      },
      "value": "everyone"
    },
    "submit": {
      "type": "Submit",
      "name": "submit",
      "label": "Post Listing"
    }
  },
  "formValues": {
    "classified_id": 243,
    "title": "Oxford Dictionary of Biology 6th Edition",
    "body": "<p>Students of biology at A level and undergraduate level. Students of related subjects. Professionals, teachers, and anyone coming into contact with terms and concepts in biology.</p>",
    "owner_id": 1,
    "category_id": 3,
    "photo_id": 836,
    "creation_date": "2015-03-25 06:48:44",
    "modified_date": "2015-03-25 06:48:44",
    "view_count": 0,
    "comment_count": 0,
    "search": 1,
    "closed": 0,
    "auth_view": "everyone",
    "auth_comment": "everyone",
    "tags": "dictionary, biology"
  }
}
Response  400
HideShow
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "parameter_missing",
  "message": "Missing Parameters: classified_id"
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Edit Classified
PUT/classifieds/edit/{classified_id}

Edit a classified-post.

Parameter Required Type Example Description
title yes string Oxford Dictionary of Biology 6th Edition classified title
tags no string dictionary, biology classified tags (comma separated)
category_id yes integer 2 category id
body yes string Students of biology at A level and undergraduate level… classified content
auth_view yes string everyone view authorization (everyone, owner_network, etc.)
auth_comment yes string everyone comment authorization (everyone, owner_network, etc.)
Parameters
HideShow
classified_id
integer (required) Example: classified_id=8

listing id

Request  valid
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
Body
{
  "classified_id": 243,
  "title": "Oxford Dictionary of Biology 6th Edition",
  "tags": "dictionary, biology",
  "category_id": 3,
  "body": "<p>Students of biology at A level and undergraduate level. Students of related subjects. Professionals, teachers, and anyone coming into contact with terms and concepts in biology.</p>",
  "auth_view": "everyone",
  "auth_comment": "everyone"
}
Response  204
Response  400
HideShow
Body
{
  "status_code": 400,
  "error": true,
  "error_code": "validation_fail",
  "message": {
    "title": "Please complete this field - it is required.",
    "body": "Please complete this field - it is required."
  }
}
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}

Open / Close Classified

Open / Close Classified
POST/classifieds/close/{classified_id}

Open / close a classified-post.

Parameter Required Type Example Description
closed yes boolean 0 open / close classified post. Default limit is 1
Parameters
HideShow
classified_id
integer (required) Example: 244

listing id

Request
HideShow
Headers
Accept: application/json
oauth_consumer_key: e6a5845684bf49df63d9eef489acfee1
oauth_consumer_secret: 42b9eef48e96c65f9ca29d07712d39fb
oauth_token: 276ed9327d0478c2606adea438f4fd15
oauth_secret: ffaff6754b5d4ca5f2fc4cc2a3a75478
Body
{
  "closed": 0
}
Response  204
Response  401
HideShow
Body
{
  "status_code": 401,
  "error": true,
  "error_code": "unauthorized",
  "message": "User does not have access to this resource."
}
Response  404
HideShow
Body
{
  "status_code": 404,
  "error": true,
  "error_code": "no_record",
  "message": "No record found"
}

Delete Classified