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:

CODEBLOCK0

Output formatted as human-readable text:
CODEBLOCK1

Output raw JSON:
CODEBLOCK2

API Details

• - Base URL: INLINECODE2
• Endpoint: INLINECODE3
• 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:
CODEBLOCK3

Via Python script (recommended):
CODEBLOCK4

Programmatic access in Python:
CODEBLOCK5

Resources

scripts/gettangemperors.py

Python client for the Tang Emperors API with:

• - get_tang_emperors(): Fetches raw JSON data from API
• INLINECODE5: 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