CloudObjects / Directory / 10Centuries / API
Sign in

API

a wa:WebAPI in 10Centuries
Base URL

The API endpoint is located at the following URL:
https://api.10centuries.org/

Authentication

No authentication methods were specified. Please contact the API provider to get this information!

API Methods

These are the methods supported by the API:

  • POST /content Create Post
    Required parameters:
    content The post content can be between 1 and 8192 bytes in length.
    Optional parameters:
    title Title for Blog Post, Draft, Page, or Podcast.
    channel_id Channel ID to publish content to.
    post_id Post ID of Blog Post, Draft, Page, or Podcast being updated.
    reply_to Post ID of object being replied to.
    slug URL slug for a Blog Post, Draft, Page, or Podcast.
    type The Post Object Type (can be overridden by API).
    send_blurb Write a Blurb to notify followers of new Blog Post/Podcast (Y/N value only).
    pubdts Publication date in YYYY-MM-DD HH:MM:SS format.
    Defaults to now.
    expydts Expiration date in YYYY-MM-DD HH:MM:SS format.
    Defaults to never.
    expyhrs Number of hours to expire post object in (overrides expydts).
    privacy_type Privacy type of post.
    passwd Access password for published Blog Post, Page, or Podcast.
    simple_posts Return a "simple" data set [Y/N].
    Success response:
    Status Code 200
    Content Type application/json
    Body (Example):
    {
        "meta": {
            "code": 200
        },
        "data": [
            {
                "id": 3511,
                "parent_id": false,
                "title": "",
                "slug": "3511",
                "type": "post.micro",
                "privacy": "visibility.public",
                "guid": "1c887cc2388bb13100ed5734e16d95dd8df5bf7a",
                "content": {
                    "text": "This is, perhaps, one of the most boring posts in the history of the universe.",
                    "html": "<p>This is, perhaps, one of the most boring posts in the history of the universe.</p>",
                    "summary": false,
                    "banner": false
                },
                "audio": false,
                "tags": false,
                "urls": {
                    "canonical_url": "/posts/3511",
                    "full_url": "10centuries.org/posts/3511",
                    "alt_url": "10centuries.org/3511",
                    "is_https": true
                },
                "thread": false,
                "mentions": false,
                "account": [{account object}],
                "channel": {channel object},
                "client": {client object},
                "created_at": "2016-02-20T10:42:34Z",
                "created_unix": 1455964954,
                "publish_at": "2016-02-20T10:42:34Z",
                "publish_unix": 1455964954,
                "updated_at": "2016-02-20T10:42:34Z",
                "updated_unix": 1455964954,
                "expires_at": false,
                "expires_unix": false,
                "is_mention": false,
                "you_starred": false,
                "you_pinned": false,
                "you_reblurbed": false,
                "stars": false,
                "blurbs": false,
                "parent_post": false,
                "follows_you": true,
                "you_follow": true,
                "you_muted": false,
                "you_blocked": false,
                "is_visible": true,
                "is_deleted": false
            }
        ]
    }
    Error responses:
    Status Code 404
    Content Type application/json
    Body (Example):
    {
        "meta": {
            "code": 404,
            "text": "Duplicate Post!"
        },
        "data": false
    }
    Status Code 404
    Content Type application/json
    Body (Example):
    {
        "meta": {
            "code": 404,
            "text": "No Text to Post"
        },
        "data": false
    }
    
    
  • DELETE /content/{postId} Delete Post
    Required parameters:
    post_id A valid Post ID.
    Success response:
    Status Code 200
    Content Type application/json
    Body (Example):
    {
        "meta": {
            "code": 200
        },
        "data": {
            "id": {Post ID},
            "is_visible": false,
            "is_deleted": true
        }
    }
    
    
  • GET /content/{postId} Retrieve specific Post
    Required parameters:
    post_id A valid Post ID.
    Success response:
    Status Code 200
    Content Type application/json
    Body (Example):
    {
        "meta": {
            "code": 200
        },
        "data": [
            {
                "id": 1,
                "parent_id": false,
                "title": "",
                "slug": "1",
                "type": "post.micro",
                "privacy": "visibility.public",
                "guid": "c4febde74f8f84917845c0cce9dd2253bace5293",
                "content": {
                    "text": "Hello world. Welcome to 2016.",
                    "html": "<p>Hello world. Welcome to 2016.</p>",
                    "summary": false,
                    "banner": false
                },
                "audio": false,
                "tags": [{Tags Object}],
                "urls": {
                    "canonical_url": "/posts/1",
                    "full_url": "10centuries.org/posts/1",
                    "alt_url": "10centuries.org/1",
                    "is_https": true
                },
                "thread": false,
                "mentions": false,
                "account": [{Account Object}],
                "channel": {Channel Object},
                "client": {Client Object},
                "created_at": "2016-01-01T09:00:00Z",
                "created_unix": 1451638800,
                "publish_at": "2016-01-01T09:00:00Z",
                "publish_unix": 1451638800,
                "updated_at": "2016-01-01T09:00:00Z",
                "updated_unix": 1451638800,
                "expires_at": false,
                "expires_unix": false,
                "is_mention": false,
                "you_starred": false,
                "you_pinned": false,
                "you_reblurbed": false,
                "stars": false,
                "blurbs": false,
                "parent_post": false,
                "follows_you": true,
                "you_follow": true,
                "you_muted": false,
                "you_blocked": false,
                "is_visible": true,
                "is_deleted": false
            }
        ]
    }
    Error response:
    Status Code 404
    Content Type application/json
    Body (Example):
    {
        "meta": {
            "code": 404,
            "text": "Post Does Not Exist"
        },
        "data": false
    }
    
    
  • GET /content Retrieve multiple Posts
    Required parameters:
    post_ids -
    
    
  • GET /content/blurbs/global Retrieve Global Timeline
    Optional parameters:
    count The number of posts to retrieve (1-200).
    before_id Retrieve only Posts before a specified ID.
    before_unix Retrieve only Posts published before a specified Unix Timestamp.
    since_id Retrieve only Posts after a specified ID.
    since_unix Retrieve only Posts published after a specified Unix Timestamp.
    simple_posts Return a "simple" data set [Y/N].
    
    
  • POST /content/blurbs/search Search Social Posts
    Required parameters:
    filter An account name, a word or series of words.
    
    
  • GET /content/blurbs/home Retrieve Account's Home Timeline
    Optional parameters:
    count The number of posts to retrieve (1-200).
    before_id Retrieve only Posts before a specified ID.
    before_unix Retrieve only Posts published before a specified Unix Timestamp.
    since_id Retrieve only Posts after a specified ID.
    since_unix Retrieve only Posts published after a specified Unix Timestamp.
    simple_posts Return a "simple" data set [Y/N].
    
    
  • GET /content/blurbs/interactions Retrieve Account's Interactions
    Optional parameters:
    count The number of posts to retrieve (1-200).
    before_id Retrieve only Posts before a specified ID.
    before_unix Retrieve only Posts published before a specified Unix Timestamp.
    since_id Retrieve only Posts after a specified ID.
    since_unix Retrieve only Posts published after a specified Unix Timestamp.
    simple_posts Return a "simple" data set [Y/N].
    
    
  • GET /content/blurbs/mentions Retrieve Account's Mentions
    Optional parameters:
    count The number of posts to retrieve (1-200).
    before_id Retrieve only Posts before a specified ID.
    before_unix Retrieve only Posts published before a specified Unix Timestamp.
    since_id Retrieve only Posts after a specified ID.
    since_unix Retrieve only Posts published after a specified Unix Timestamp.
    simple_posts Return a "simple" data set [Y/N].
    
    
  • GET /content/blurbs/pins Retrieve Account's Pins
    Optional parameters:
    count The number of posts to retrieve (1-200).
    before_id Retrieve only Posts before a specified ID.
    before_unix Retrieve only Posts published before a specified Unix Timestamp.
    since_id Retrieve only Posts after a specified ID.
    since_unix Retrieve only Posts published after a specified Unix Timestamp.
    simple_posts Return a "simple" data set [Y/N].
    
    
  • POST /content/pin Pin Post
    Required parameters:
    post_id A valid Post ID.
    color A hex color; one of #000000 (black), #0000ff (blue), #00ff00 (green), #ffa500 (orange), #ff0000 (red), #ffff00 (yellow).
    
    
  • POST /content/repost/{postId} Repost Post
    Required parameters:
    post_id A valid Post ID.
    
    
  • POST /content/repost/{postId} Star Post
    Required parameters:
    post_id A valid Post ID.
    Success response:
    Status Code 200
    Content Type application/json
    Body (Example):
    {
        "meta": {
            "code": 200
        },
        "data": [
            {
                ⋮
                "stars": [
                    {
                        "id": 1,
                        "name": "@matigo",
                        "avatar_url": "//cdn.10centuries.org/NtyZNP/325a0899a1f05a31d6bc1d54bccb0967.jpg",
                        "starred_at": "2016-02-20 13:40:39",
                        "starred_unix": 1455975639
                    }
                ],
                ⋮
            }
        ]
    }
    
    
  • POST /parser Parse Text Object

    Anything that is published goes through a single text formatter. This API method will let people see what the end result will look like before publishing.

    Required parameters:
    content Post content.
    Optional parameters:
    title Title for Blog Post, Draft, Page, or Podcast.
    Success response:
    Status Code 200
    Content Type application/json
    Body (Example):
    {
        "meta": {
            "code": 200
        },
        "data": {
            "title": "",
            "content": {
                "text": "This is, perhaps, one of the most boring posts in the history of the universe.",
                "html": "<p>This is, perhaps, one of the most boring posts in the history of the universe.</p>"
            }
        }
    }
    Error response:
    Status Code 400
    Content Type application/json
    Body (Example):
    {
        "meta": {
            "code": 400,
            "text": "No Text Received"
        },
        "data": false
    }
    
    
  • POST /preferences Set Preference
    Required parameters:
    key Any string up to 64 multi-byte characters.
    value Any string up to 128 multi-byte characters.
    Success response:
    Status Code 200
    Content Type application/json
    Body (Example):
    {
        "meta": {
            "code": 200
        },
        "data": {
            "key": "puppy_name",
            "value": "nozomi 🐶",
            "updated_at": "2009-02-13 23:31:30",
            "updated_unix": 1234567890
        }
    }
    Error response:
    Status Code 400
    Content Type application/json
    Body (Example):
    {
        "meta": {
            "code": 400,
            "text": "Preference Value Is Too Long. Maximum Length is 128 Characters."
        },
        "data": false
    }
    
    
  • GET /preferences Retrieve Preferences

    There are no parameters for this request.

    Success response:
    Status Code 200
    Content Type application/json
    Body (Example):
    {
        "meta": {
            "code": 200
        },
        "data": [
            {
                "key": "puppy_name",
                "value": "nozomi 🐶",
                "updated_at": "2009-02-13 23:31:30",
                "updated_unix": 1234567890
            },
            {
                "key": "baby_name",
                "value": "Leonard James Akaar",
                "updated_at": "2009-02-13 23:31:30",
                "updated_unix": 1234567890
            },
            {
                "key": "iguana_name",
                "value": "Quincey",
                "updated_at": "2009-02-13 23:31:30",
                "updated_unix": 1234567890
            }
        ]
    }
    Error response:
    Status Code 404
    Content Type application/json
    Body (Example):
    {
        "meta": {
            "code": 404,
            "text": "No Preference Information Found"
        },
        "data": false
    }
    
    
  • DELETE /preferences Delete Preference
    Required parameters:
    key Any string up to 64 multi-byte characters.
    Success response:
    Status Code 200
    Content Type application/json
    Body (Example):
    {
        "meta": {
            "code": 200
        },
        "data": [
            {
                "key": "puppy_name",
                "value": "nozomi 🐶",
                "updated_at": "2009-02-13 23:31:30",
                "updated_unix": 1234567890
            },
            {
                "key": "baby_name",
                "value": "Leonard James Akaar",
                "updated_at": "2009-02-13 23:31:30",
                "updated_unix": 1234567890
            }
        ]
    }
    Error response:
    Status Code 400
    Content Type application/json
    Body (Example):
    {
        "meta": {
            "code": 400,
            "text": "Could Not Delete Preference"
        },
        "data": false
    }
    
    
  • POST /marker Set Marker
    Required parameters:
    since_unix Any Unix timestamp greater than 0.
    Optional parameters:
    channel_guid The guid for the Channel the Marker belongs to.
    channel_id The ID for the Channel the Marker belongs to (overrides channel_guid).
    type The type of Marker for the Channel.
    Defaults to global.
    Success response:
    Status Code 200
    Content Type application/json
    Body (Example):
    {
        "meta": {
            "code": 200
        },
        "data": {
            "type": "marker.1.global",
            "value": 1234567890
        }
    }
    Error response:
    Status Code 404
    Content Type application/json
    Body (Example):
    {
        "meta": {
            "code": 404,
            "text": "Invalid Channel Information"
        },
        "data": false
    }
    
    
  • GET /marker Retrieve Marker Information
    Optional parameters:
    channel_guid The guid for the Channel the Marker belongs to.
    channel_id The ID for the Channel the Marker belongs to (overrides channel_guid).
    type The type of Marker for the Channel.
    Defaults to global.
    Success response:
    Status Code 200
    Content Type application/json
    Body (Example):
    {
        "meta": {
            "code": 200
        },
        "data": {
            "type": "marker.1.global",
            "value": 1234567890
        }
    }
    Error response:
    Status Code 404
    Content Type application/json
    Body (Example):
    {
        "meta": {
            "code": 404,
            "text": "Invalid Channel Information"
        },
        "data": false
    }
    
    
  • GET /marker/counts Retrieve Channel Post Counts
    Optional parameters:
    since_unix The Unix timestamp to start data collection from, defaults to last Marker position.
    channel_guid The guid for the Channel the Marker belongs to.
    channel_id The ID for the Channel the Marker belongs to (overrides channel_guid).
    type The type of Marker for the Channel.
    Defaults to global.
    Success response:
    Status Code 200
    Content Type application/json
    Body (Example):
    {
        "meta": {
            "code": 200
        },
        "data": [
            {
                "post_type": "post.long",
                "post_count": 4,
                "post_mentions": 1,
                "accounts": 2
            },
            {
                "post_type": "post.micro",
                "post_count": 3207,
                "post_mentions": 967,
                "accounts": 24
            },
            {
                "post_type": "post.short",
                "post_count": 647,
                "post_mentions": 193,
                "accounts": 18
            },
            {
                "post_type": "post.tiny",
                "post_count": 1134,
                "post_mentions": 321,
                "accounts": 23
            }
        ]
    }
    Error response:
    Status Code 404
    Content Type application/json
    Body (Example):
    {
        "meta": {
            "code": 404,
            "text": "Invalid Channel Information"
        },
        "data": false
    }
    
    
  • GET /service/current Check Current Activity Levels on 10Centuries

    There are no parameters for this request.

    Success response:
    Status Code 200
    Content Type application/json
    Body (Example):
    {
        "meta": {
            "code": 200,
            "server": "0.100"
        },
        "data": {
            "sites": {
                "items_total": 4981,
                "items_30day": 105,
                "accounts_total": 25,
                "accounts_30day": 15
            },
            "social": {
                "items_total": 50102,
                "items_30day": 10037,
                "accounts_total": 69,
                "accounts_30day": 54
            },
            "todo": {
                "items_total": 73,
                "items_30day": 73,
                "accounts_total": 7,
                "accounts_30day": 7
            },
            "account": {
                "created_total": 104,
                "created_30day": 28
            },
            "invitation": {
                "items_total": 175,
                "items_30day": 56,
                "accounts_total": 21,
                "accounts_30day": 10
            }
        }
    }
    Error response:
    Status Code 404
    Content Type application/json
    Body (Example):
    {
        "meta": {
            "code": 404,
            "text": "Unable to Retrieve Service Status"
        },
        "data": false
    }
    
    
Meta
URI / COID
coid://10centuries.org/API
Revision
4-a80e27b3f9928b646c751a6ffa7bcaf1
Last updated
2017-03-21 11:49 (UTC)
Created at
2017-08-23 17:53 (UTC)
Usage permission
co:Private
Objects in this namespace
  • API