Tang Emperors API

Overview

This skill provides integration with a local backend API that returns information about the first three emperors of the Tang Dynasty (唐朝前3代皇帝). The API is deployed locally at http://127.0.0.1:8080 with the endpoint GET /api/v1/test.

Quick Start

Fetch Tang Dynasty emperor information:

python3 scripts/get_tang_emperors.py

Output formatted as human-readable text:

python3 scripts/get_tang_emperors.py

Output raw JSON:

python3 scripts/get_tang_emperors.py --json

API Details

Base URL: http://127.0.0.1:8080
Endpoint: /api/v1/test
Method: GET
Returns: JSON data about the first three Tang Dynasty emperors

Error Handling

The script includes comprehensive error handling:

Connection errors: Backend not running or unreachable
Timeout errors: API response timeout (10s default)
HTTP errors: Invalid HTTP responses (404, 500, etc.)
JSON parsing errors: Malformed response data
Unexpected errors: Other runtime errors

Usage Patterns

Direct API call:

curl http://127.0.0.1:8080/api/v1/test

Via Python script (recommended):

python3 scripts/get_tang_emperors.py

Programmatic access in Python:

from scripts.get_tang_emperors import get_tang_emperors, format_emperor_data

data = get_tang_emperors()
formatted = format_emperor_data(data)
print(formatted)

Resources

scripts/get_tang_emperors.py

Python client for the Tang Emperors API with:

get_tang_emperors(): Fetches raw JSON data from API
format_emperor_data(): Formats data for human-readable output
CLI support with --json flag for raw JSON output
Comprehensive error handling and timeout management

The script can be:

Executed directly from command line
Imported as a module in other Python code
Used by Codex for automated API interactions

Notes

Ensure the local backend is running before making API calls
The API expects a GET request with no parameters
Response format may vary; the script handles common patterns (list, dict with 'emperors' key, dict with 'data' key)
Default timeout is 10 seconds; adjust in script if needed for your environment