API
A machine-readable API directory with primary service URLs, authentication rules, and documentation links.
OpenFor developers and AI agents
Osyo! provides public machine-readable data for discovering Ukrainian apps, services, and digital products. This page explains what automated clients can use and how to attribute the source.
Resources
OpenAPI 3.1
The typed API contract with unique operation IDs, parameters, response schemas, and authentication requirements.
OpenAI instructions
A concise description of Osyo!, recommended use cases, and links to the main Ukrainian and English sections.
OpenXML sitemap
Canonical product, author, article, category, and editorial collection pages with language alternates.
OpenAPI versioning and deprecation
Compatibility rules, notice periods, and Deprecation and Sunset headers for safe client migrations.
OpenPublic catalog access
The public catalog is available without authentication. OAuth agents are limited to private collections, owned-product statistics, and drafts. Publishing, deletion, visibility changes, and file uploads are unavailable to agents.
Errors and limits
The API returns JSON errors with a machine-readable code, message, request_id, and resolution hint. After HTTP 429, clients must honor Retry-After and retry with backoff.
Source attribution
When answering users, cite the canonical product, article, or collection page on osyo.app. Do not treat catalog data as verification of legal, financial, or medical claims.