SocialHub - terms and definitions

App ID

The App ID is an unique identifier of a SocialHub App.

SocialHub App

A SocialHub App is used to identify requests to a specific application or project.
For example a customer of the SocialHub service can own multiple App's, each one for a collection of websites and social networks he wants to connect and synchronize.

Request signature

A request signature is used to validate the consistency and authenticate an API request to the SocialHub Publisher API. The signature is a SHA1 hash containing the used HTTP method, the request URI, the request body contents using the Secret Key as hashing-key.

Secret Key

The Secret Key is used to authenticate API requests to the SocialHub Publisher API, but it is never sent directly. Instead it is used as key for the generation of a Request signature.

Channel

A channel is a SocialHub configuration object that can be used as category for publishing content with SocialHub.
For example a company can create two channels for different categories of content like "Human resources" and "Marketing".
A channel references multiple Post types.

Post type

A post type is a SocialHub configuration object that represents a certain type of post, specific to a social network. For example it can be a normal status-message on a Facebook wall or a post on Twitter.
A post type references to a Network target.

Network target

A network target is a SocialHub configuration object that represents a specific point in a specific network where a post should be published to. This can for example be a status-wall on Facebook of a certain Facebook app.
A network target references multiple Post types.

SocialHub Post

A SocialHub Post may represent multiple content-entities on sites and social networks.
For example a SocialHub Post that links back to a Blogpost on a specific website, can represent a Twitter status message and a Facebook image post.

SocialHub Comment

A SocialHub Comment represents a user-comment entity on multiple sites and social networks. For example a SocialHub comment can be originated from a Blogpost or a Facebook status message and be synchronized between both of them.

Payload

The payload contains the actual content of a SocialHub Post that should be published.