API Responses

This page documents the data returned by the SpaceHey mobile API.

Note: The API returns JSON for data endpoints and HTML for "hosted" endpoints (webviews used inside the app).

---

JSON Data Endpoints

User Profile (Self)

GET /users/me - Returns own profile info and stats.

{
  "ok": true,
  "data": {
    "user": {
      "id": 12345,
      "name": "Display Name",
      "username": "url_slug",
      "url": "[https://spacehey.com/url_slug](https://spacehey.com/url_slug)",
      "picture": { ... },
      "private": false,
      "verified": false,
      "mod": false,
      "show_online": true,
      "last_active": 1767296419,
      "joined": 1715399540
    },
    "stats": {
      "profile_views": { "value": 5681, "display_value": "5681" },
      "friends": { "value": 2, "display_value": "2" },
      "open_friend_requests": { "value": 0, "display_value": "0" },
      "unread_messages": { "value": 0, "display_value": "0" }
    },
    "statuses": {
      "status": { "value": "..." },
      "mood": { "value": "..." },
      "you": { "value": "..." }
    }
  }
}

User Profile (Public)

GET /users/{id}/profile - Returns basic info for another user.

{
  "ok": true,
  "data": {
    "user": { ... },
    "relationship": {
      "are_friends": false,
      "is_blocked": false,
      "pending_request": false
    }
  }
}

Friend List

GET /users/{id}/friends

{
  "ok": true,
  "data": {
    "friends": [
      {
        "user": { ... },
        "statuses": { ... },
        "relationship": { ... }
      }
    ],
    "last_page": true
  }
}

Bulletins List

GET /bulletins

{
  "ok": true,
  "data": {
    "bulletins": [
      {
        "id": 6239931,
        "time": 1767259269,
        "subject": "Title",
        "comment_count": 281,
        "user": { ... },
        "relationship": { ... }
      }
    ],
    "last_page": true
  }
}

Blog Entries

GET /blog/recent | /blog/top | /blog/category/{id}

{
  "ok": true,
  "data": {
    "entries": [
      {
        "id": 2037190,
        "time": 1767296289,
        "privacy": 1,
        "subject": "Title",
        "comment_count": 0,
        "category": { "id": 25, "name": "Friends" },
        "user": { ... }
      }
    ],
    "last_page": false
  }
}

Token Validation

GET /auth/validate

{
  "ok": true,
  "data": {
    "message": "Auth Token valid",
    "user_id": 12345,
    "valid_until": 1775071789
  }
}

Hosted Endpoints (HTML)

These endpoints return full HTML pages intended to be displayed in a WebView within the mobile app. They often contain spacehey:// custom protocol links to handle navigation back to the native app.

Profile Editor

GET /hosted/editprofile

• Returns an HTML form with textarea elements for about_me, meet, etc.
• Includes a live preview iframe and color picker logic.

View Profile (Native View)

GET /hosted/profile/me

• Returns the HTML representation of your profile layout (including custom CSS).

View Blog Entry

GET /hosted/blog/{id}

• Displays the full blog post and comments section.
• Contains links like spacehey://addcomment?id=....

Write/Edit Blog

GET /hosted/blog/new | /hosted/blog/edit?id={id}

• Returns an HTML form with a WYSIWYG editor (Trumbowyg) for writing posts.

Comments

GET /hosted/comments/{type}/{id}

• Displays the comment thread.

Feature Voting

GET /hosted/featurevoting

• Displays the roadmap and voting interface.