This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description
# Summics REST API
The *Summics API* is available at `https://api.summics.com`.
Every Request should be at most 100MB of content. If it is more you will receive an 413 error code.

# Authentication [/auth]
Provides a token to be included with every REST request. The token expires when it is not used for 6 hours.

## Authenticate [POST]

+ Parameters
+ `clientId` Your client ID string.
+ `secret` Your API secret key.

+ Response 200 (application/json)

{
"token": <string>
}

# Authorization
All further API calls requires an API `token` in the request `Header`.

+ Headers

Authorization: <token string="">

# Projects [/projects]

## List projects [GET]
Retrieves a list with all projects.

+ Response 200 (application/json)

[
{
"id": <string>,
"name": <string>,
"sources": [
"id": <string>,
"name": <string>
]
},
...
]

# Topics [/topics]

## List topics [GET]
Retrieves a list with all topics for a given `projectId`. It *must* be any ID returned by `/projects` request.

+ Parameters
+ `projectId` The ID of a project.

+ Response 200 (application/json)

[
{
"id": <string>,
"name": <string>
},
...
]

# Topics Overview [/topics/overview]

## Lists all active topics within a time period [GET]
Retrieves a list with all `sources`'s active topics between `fromDate` and `toDate` . `sources` *must* an array with IDs returned by `/projects` request.

+ Parameters
+ `sources`:
`[<string>]` An array with source IDs that were returned with a project.
+ `fromDate`:
`<string>` It *must* be an **ISO Date** string.
+ `toDate`:
`<string>` It *must* be an **ISO Date** string.

+ Response 200 (application/json)

[
{
"id": <string>,
"name": <string>,
"postCount": {
"current": <number>,
"previous: <number>
},
"charCount": {
"current": <number>,
"previous: <number>
},
"userCount": {
"current": <number>,
"previous: <number>
},
"sentimentScore": {
"current": <number>,
"previous: <number>
}
},
...
]

# Texts [/texts]

## List texts [GET]
Retrieves a list with all texts for the parameters below.

+ Parameters
+ `sources`:
`[<string>]` An array with source IDs that were returned with a project.
+ `fromDate`:
`<string>` It *must* be an **ISO Date** string.
+ `toDate`:
`<string>` It *must* be an **ISO Date** string.
+ `topics`:
`[<string>]` *Optional* An array with topic IDs that were returned with `/topics` request.

+ Response 200 (application/json)

[
{
"id": <string>,
"text": <string>,
"sentiment": <number>,
"author": <string>,
"timestamp": <string>,
"source": <string>,
"postLink": <string>,
"topics": [
{
"id": <string>,
"name": <string>
}
]
},
...
]

## Add Texts [PUT]
Pushes some texts into Summics.

+ Parameters
+ `sourceId`:
`<string>` The ID of the source to add the texts to. Source IDs are provided together with projects.
+ `texts`:
`[<object>]` The list of texts to insert. See Structure below.
+ `text`:
`<string>` The text body
+ `postId`:
`<string|number>` The unique identifier of a text
+ `timestamp`:
`<string>` The timestamp of the text
+ `user`:
`<string>` The author
+ `customField1`
`<string>` Custom field value
+ `customField2`
`<string>` Custom field value


+ Response 200 (application/json)

{
"imported": [<string>],
"errors": [
{
"original": { ... },
"error": <string>
}
]
}

### Additional Information
Each text is processed individually. If an error occurs on one text the other texts may be imported nonetheless.
The result indicates which texts where imported correctly. For each erroneous text the reason is returned.

The `postId` supplied with each text should be unique within the context of one source.
*If a text with the same ID already exists, it will be overwritten.*

The request only returns after the initial processing of all texts is finished, so it may take some time.

The `timestamp` should be a valid ISO 8601 string.

The fields `customField1`, `customField2` ... are custom defined fields. You can create an unlimited amount of custom fields
and name them anything except for the predefined names (user, postId, text etc.).

# Dashboard [/dashboard]

## View dashboard data [GET]
The information displayed on *Summics Dashboard* is returned.

+ Parameters
+ `sources`:
`[<string>]` An array with source IDs that were returned with a project.
+ `fromDate`:
`<string>` It *must* be an **ISO Date** string.
+ `toDate`:
`<string>` It *must* be an **ISO Date** string.

+ Response 200 (application/json)

{
"contentAndSentiment": <object>,
"activityPerHour": <array>,
"generalActivity": <object>
}

+ `contentAndSentiment`:

{
"contentDistribution":
{
"meaningful": <number>,
"noTopics": <number>,
"total": <number>
},
"sentimentDistribution":
{
"negativeCount": <number>,
"neutralCount": <number>,
"positiveCount": <number>
}
}

+ `activityPerHour`:

[
{
"hour": <number>,
"count": <number>
},
...
]

+ `generalActivity`:

{
"timestamp": <string>,
"source": <string>,
"charCount": <number>,
"textCount": <number>,
"negativeCount": <number>,
"neutralCount": <number>,
"positiveCount": <number>
}
Release History

Release History

1.1.0

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
summics-1.1.0.zip (3.5 kB) Copy SHA256 Checksum SHA256 Source Jul 3, 2015

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting