1. Generate API Key:

- First, you need to create a website for your account.

- In the Connect Your CMS section, you need to choose the API option and generate an API key.

- You need to keep a secret and save that API Key to use API access. You can see the below screenshot to generate the API Key.

2. Get Published Posts:

This API documentation describes how to use the "Get Published Posts" endpoint of the PostCheetah API. Below, I'll break down the documentation into understandable parts:

API Request:

To retrieve published posts, you need to send a POST request to the specified endpoint (`https://postcheetah.com/api/latest-posts`) along with the API key provided in the request body. Here's an example of how you can make the request using curl:

curl -d '{"api_key": "tKCtnJ59CYMy4mqim8mt", "page": "1"}' -H "Content-Type: application/json" -X POST https://postcheetah.com/api/latest-posts

Success Response:

If the request is successful, you'll receive a JSON response containing an array of published posts. Each post object in the array includes the following fields:

- id: The unique identifier for the post.

- title: The title of the post.

- body: The content/body of the post.

- slug: A URL-friendly version of the title.

- meta_description: Meta description for the post.

- featured_image: URL to the featured image of the post.

- status: The status of the post (which should be "publish" in this case).

Here's an example of a successful response with two published posts:

{
   
   "data": [
        {
            "id": 1,
            "title": "This is sample title",
            "body": "This is sample body",
            "slug": "this-is-sample-slug",
            "meta_description": "This is sample Meta Description",
            "featured_image": "https://postcheetah.com/uploads/frontSetting/logo-new_SGn1698673541.svg",
            "status": "draft",
            "publish_at": "",
        },
        {
            "id": 2,
            "title": "This is sample title 2",
            "body": "This is sample body 2",
            "slug": "this-is-sample-slug 2",
            "meta_description": "This is sample Meta Description",
            "featured_image": "https://postcheetah.com/uploads/demo.svg",
            "status": "publish",
            "publish_at": "07-08-2024",
        }
   ],
   "current_page": 4,
   "per_page": 10,
   "total": 105,
   "last_page": 11
}

Error Responses:

The API provides error responses for cases when something goes wrong with the request. There are two possible error responses described:

1. Missing API Key: If the API key field is not provided in the request body, you'll receive an error response indicating that the API key field is required.

{
    "error": "The api_key field is required."
}

2. Wrong API Key: If the provided API key is invalid, you'll receive an error response indicating that the API key is invalid.

{
    "error": "The api_key field is invalid."
}

These error responses help in troubleshooting and handling errors gracefully in your application when interacting with the PostCheetah API.

3. Get Published Pages:

This API documentation describes how to use the "Get Published Pages" endpoint of the PostCheetah API. Below, I'll break down the documentation into understandable parts:

API Request:

To retrieve published posts, you need to send a POST request to the specified endpoint (`https://postcheetah.com/api/latest-pages`) along with the API key provided in the request body. Here's an example of how you can make the request using curl:

curl -d '{"api_key": "tKCtnJ59CYMy4mqim8mt", "page": "1"}' -H "Content-Type: application/json" -X POST https://postcheetah.com/api/latest-pages

Success Response:

If the request is successful, you'll receive a JSON response containing an array of published pages. Each post object in the array includes the following fields:

- id: The unique identifier for the post.

- title: The title of the post.

- body: The content/body of the post.

- slug: A URL-friendly version of the title.

- meta_description: Meta description for the post.

- featured_image: URL to the featured image of the post.

- status: The status of the post (which should be "publish" in this case).

Here's an example of a successful response with two published posts:

{
   "data": [
       {
          "id": 1,
          "title": "This is sample title",
          "body": "This is sample body",
          "slug": "this-is-sample-slug",
          "meta_description": "This is sample Meta Description",
          "featured_image": "https://postcheetah.com/uploads/frontSetting/logo-new_SGn1698673541.svg",
          "status": "publish",
          "publish_at": "07-08-2024",
       },
       {
          "id": 2,
          "title": "This is sample title 2",
          "body": "This is sample body 2",
          "slug": "this-is-sample-slug 2",
          "meta_description": "This is sample Meta Description",
          "featured_image": "https://postcheetah.com/uploads/demo.svg",
          "status": "draft",
          "publish_at": "",
       }
   ],
   "current_page": 4,
   "per_page": 10,
   "total": 105,
   "last_page": 11
}

Error Responses:

The API provides error responses for cases when something goes wrong with the request. There are two possible error responses described:

1. Missing API Key: If the API key field is not provided in the request body, you'll receive an error response indicating that the API key field is required.

{
    "error": "The api_key field is required."
}

2. Wrong API Key: If the provided API key is invalid, you'll receive an error response indicating that the API key is invalid.

{
    "error": "The api_key field is invalid."
}

These error responses help in troubleshooting and handling errors gracefully in your application when interacting with the PostCheetah API.