PLEASE READ: This is a sample documentation for a fictional blog posts API that allows developers to create, retrieve, update, and delete blog posts for a simple content-driven web application.

• Obtain an API key from your dashboard

• Add the key to the Authorization header

• Make your first request using the /posts endpoint

Base URL: https://api.iyanu.com/v1

Creates a new blog post.

Endpoint: POST /posts

  curl -X POST "https://api.iyanu.com/v1/posts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Understanding APIs", "content": "APIs allow applications to communicate with each other."}'

{
  "id": "post_12345",
  "title": "Understanding APIs",
  "content": "APIs allow applications to communicate with each other.",
  "created_at": "2026-01-05T12:00:00Z"
}

Returns a list of all blog posts.

Endpoint: GET /posts

curl -X GET "https://api.iyanu.com/v1/posts" \
  -H "Authorization: Bearer YOUR_API_KEY"

[
  {
    "id": "post_12345",
    "title": "Understanding APIs",
    "created_at": "2026-01-05T12:00:00Z"
  },
  {
    "id": "post_67890",
    "title": "Getting Started with REST",
    "created_at": "2026-01-04T09:30:00Z"
  }
]

Returns a specific blog post by ID.

Endpoint: GET /posts/{id}

curl -X GET "https://api.iyanu.com/v1/posts/post_12345" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "id": "post_12345",
  "title": "Understanding APIs",
  "content": "APIs allow applications to communicate with each other.",
  "created_at": "2026-01-05T12:00:00Z"
}

Updates an existing blog post.

Endpoint: PUT /posts/{id}

curl -X PUT "https://api.iyanu.com/v1/posts/post_12345" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Understanding REST APIs", "content": "REST APIs use standard HTTP methods for communication."}'

{
  "id": "post_12345",
  "title": "Understanding REST APIs",
  "content": "REST APIs use standard HTTP methods for communication.",
  "updated_at": "2026-01-06T08:15:00Z"
}

Deletes a blog post permanently.

Endpoint: DELETE /posts/{id}

curl -X DELETE "https://api.iyanu.com/v1/posts/post_12345" \
  -H "Authorization: Bearer YOUR_API_KEY"

{
  "message": "Blog post deleted successfully."
}

All error responses follow a consistent structure. For example:

{
  "error": {
    "status": 401,
    "message": "invalid API key provided"
  }

• This API uses Bearer token authentication.

• Include your API key in the Authorization header for every request.

• Requests without a valid API key will return a 401 Unauthorized response.