CloudObjects / Directory / 10Centuries / API
Sign in

API

a wa:WebAPI & wa:HTTPEndpoint in 10Centuries
Base URL

The 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 content_copy
Revision
5-7982ddf2c32ff6d3b0a1b50dc0e29647 content_copy
Short ID
10centuries:API content_copy
Reference URL
https://coid.link/10centuries.org/API content_copy
Last updated
2017-03-21 11:49 (UTC)
Export
RDF
Objects in this namespace