Skipsail Developer Resources

Machine-readable discovery and API resources for AI agents.

Brand Discovery

Primary product or service name: Skipsail

Quickstart

1. Fetch agent mode for a structured overview.
2. Read llms.txt for canonical discovery guidance.
3. Use the OpenAPI specification to integrate public endpoints programmatically.

Discovery

• ai-plugin.json
• agent.json
• agent-card.json
• api-catalog

Reference Pages

These pages are configured explicitly so discovery works even when the site uses Polish or custom slugs instead of English defaults.

• Privacy

Content APIs

• Public summaries
• Recent updates
• Post markdown pattern
• Term markdown pattern

Authentication

These discovery endpoints are public and read-only. If this site exposes MCP or other authenticated services, they are linked separately.

Rate Limits

Public discovery responses return advisory rate-limit headers so agents can self-throttle: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, RateLimit-Limit, RateLimit-Remaining, and RateLimit-Reset.

Error Responses

Public API errors return JSON with error, code, status, docs_url, and when possible a recovery hint.

{"error":"No supported post types requested.","code":"invalid_post_types","status":400,"docs_url":"https://skipsail.pl/developers","hint":"Use the types parameter with public post types such as post, page, or product."}

Examples

curl -H "Accept: application/json" "https://skipsail.pl/?mode=agent"

curl "https://skipsail.pl/wp-json/nx-seo/v1/llm/summaries?types=page,post&per_page=5"

curl -H "Accept: text/markdown" "https://skipsail.pl/"

Canonical path: /developers