Articles

Articles are an essential part of the platform — they contain content that is shared between users, such as blog posts, news articles, and other informational content. On this page, we’ll dive into the different article endpoints you can use to manage articles programmatically. We'll look at how to query articles.

The article model

The article model contains all the information about the articles. Each article can have a title, content, an author, and a publish date, along with other metadata like tags and categories.

Properties

Name
id
Type
string
Description
Unique identifier for the article.
Name
title
Type
string
Description
The title of the article.
Name
content
Type
string
Description
The main content of the article.
Name
author_id
Type
string
Description
Unique identifier for the author of the article.
Name
published_at
Type
timestamp
Description
Timestamp of when the article was published.
Name
created_at
Type
timestamp
Description
Timestamp of when the article was created.
Name
updated_at
Type
timestamp
Description
Timestamp of when the article was last updated.
Name
status
Type
string
Description
The current status of the article (e.g., "draft", "published").
Name
tags
Type
array
Description
An array of tags associated with the article for categorization.

GET/v1/fetchArticle

Fetch Article Details

This endpoint allows you to retrieve details about a specific article based on the provided articleUrl. You must also provide a valid tokenID to authenticate the request.

Required attributes

Name
articleUrl
Type
string
Description
The URL of the article you want to fetch.
Name
tokenID
Type
string
Description
The user's token ID for authentication.

Request

GET

/v1/fetchArticle

curl -G "https://api.shkolafit.com/v1/fetchArticle" \
  -d "articleUrl=article_example_1" \
  -d "tokenID=b9d32969-e8aa-42fd-8755-61f6a6ef8f8d"

Response

{
  "apirequest": {
    "tid": "b9d32969-e8aa-42fd-8755-61f6a6ef8f8d",
    "trequestmade": "fetch_article:article_example_1",
    "ttimemade": "2025-01-22T13:41:06.689Z",
    "trequestcost": 1
  },
  "requestresult": {
    "articleID": "12345",
    "articleContent": "This is the content of the article. It contains all the important information regarding the topic at hand."
  }
}

ShkolaFit