Tang Emperors API

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