Files
homeclaw/.smallclaw/templates/api-integration.md
T
2026-04-29 11:45:59 +09:00

1.2 KiB

name, version, description
name version description
{{SKILL_NAME}} 1.0 {{SKILL_DESCRIPTION}}

{{SKILL_NAME}}

{{SKILL_DESCRIPTION}}

Requirements

  • curl or network access for API calls
  • {{API_KEY_ENV}} environment variable set with your API key

Setup

Get an API key from {{API_PROVIDER_URL}} and set it:

export {{API_KEY_ENV}}=your_api_key_here

Or add it to .smallclaw/config.json under the appropriate section.

Usage

{{ACTION_LABEL}}

curl -s -H "Authorization: Bearer ${{API_KEY_ENV}}" {{API_ENDPOINT}}

Available Endpoints

Endpoint Method Description
{{API_ENDPOINT}} GET Describe what this endpoint returns
{{API_ENDPOINT}} POST Describe what this endpoint accepts

Response Format

Responses are JSON. Typical structure:

{
  "status": "ok",
  "data": {}
}

Error Handling

  • 401 Unauthorized — Check that {{API_KEY_ENV}} is set correctly
  • 429 Too Many Requests — Rate limit reached, retry after a few seconds
  • 500 Server Error — Temporary issue, retry later

Safety

  • Requires {{API_KEY_ENV}} credential
  • All requests go to {{API_BASE_URL}}
  • Confirm before making write operations (POST, PUT, DELETE)