Skip to content
Permalink
master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

backpack-api/sections/status.md

Go to file
 
 
Cannot retrieve contributors at this time
Status List Show Update
62 lines (46 sloc) 1.13 KB
Raw Blame
Open in GitHub Desktop

Status

List

  • GET /statuses.xml lists all statuses in your account. Users who have not posted a status will not be included.

Response:

<statuses type="array">
  <status>
    <id type="integer">...</id>
    <message>...</message>
    <updated-at type="datetime">...</updated-at>
    <user-id type="integer">...</user-id>
    <user>
      <id type="integer">...</id>
      <name>...</name>
    </user>
  </status>
  ...
</statuses>

Show

  • GET /users/#{user_id}/status.xml retrieves the status for a specific user.

If the user has never set their status, this will return a 404 Not Found response.

Response:

<status>
  <id type="integer">...</id>
  <message>...</message>
  <updated-at type="datetime">...</updated-at>
  <user-id type="integer">...</user-id>
</status>

Update

  • PUT /users/#{user_id}/status.xml update the status for the given user-id.

You may only update your own status; attempting to update someone else's status will result in a 403 Forbidden response.

Request:

<status>
  <message>...</message>
</status>

Response:

Status: 200 OK