Typicode APIjsonplaceholder.typicode.com ↗

"""JSONPlaceholder SDK — bounded, re-runnable walkthrough."""
from parse_apis.jsonplaceholder_api import JSONPlaceholder, Completed, UserId, ResourceNotFound

client = JSONPlaceholder()

# List posts filtered by user ID using the UserId enum.
for post in client.posts.list(user_id=UserId._1, limit=3):
    print(f"Post #{post.id}: {post.title[:50]}")

# Fetch a user and explore sub-resources.
user = client.users.list(limit=1).first()
if user:
    print(f"User: {user.name} (@{user.username}), company={user.company.name}")
    for todo in user.todos.list(limit=3):
        print(f"  Todo #{todo.id}: completed={todo.completed}, {todo.title[:40]}")

# Drill into a post's comments via sub-resource.
first_post = client.posts.list(limit=1).first()
if first_post:
    for comment in first_post.comments.list(limit=2):
        print(f"  Comment by {comment.email}: {comment.body[:40]}...")

# Create a new todo with Completed enum.
new_todo = client.todos.create(title="Buy groceries", user_id=1, completed=Completed.FALSE)
print(f"Created todo #{new_todo.id}: {new_todo.title}")

# Typed error handling on a non-existent resource.
try:
    missing = client.post(id=99999).refresh()
except ResourceNotFound as exc:
    print(f"Caught ResourceNotFound: {exc}")

# Album photos via sub-resource navigation.
album = client.album(id=1).refresh()
photo = album.photos.list(limit=1).first()
if photo:
    print(f"Album '{album.title}' photo: {photo.title}, url={photo.url}")

print("Exercised: posts.list / users.list / user.todos.list / post.comments.list / todos.create / post.refresh (error) / album.photos.list")