API-документация
Один ключ, четыре сервиса
Base URL — https://api.osnova.dev/v1. Каждый запрос требует заголовок Authorization: Bearer OSNOVA_API_KEY. Ответы — JSON, лимиты зависят от тарифа и считаются отдельно по каждому сервису.
Домены
curl
curl -G https://api.osnova.dev/v1/domains/search \
-H "Authorization: Bearer $OSNOVA_API_KEY" \
--data-urlencode "query=osnova-shop"Ответ · 200 OK
{
"query": "osnova-shop",
"results": [
{ "domain": "osnova-shop.dev", "available": true, "price": "$14.00" },
{ "domain": "osnova-shop.com", "available": false }
]
}CDN
curl
curl -X POST https://api.osnova.dev/v1/cdn/zones \
-H "Authorization: Bearer $OSNOVA_API_KEY" \
-d '{ "domain": "example.com" }'Ответ · 201 Created
{
"zone_id": "zn_8f2a",
"domain": "example.com",
"nameservers": ["ns1.osnova.dev", "ns2.osnova.dev"],
"status": "pending"
}Парсер
curl
curl -X POST https://api.osnova.dev/v1/parser/extract \
-H "Authorization: Bearer $OSNOVA_API_KEY" \
-d '{
"url": "https://shop.example.com/sku/4471",
"selectors": { "price": ".price" },
"render_js": true
}'Ответ · 200 OK
{
"status": "ok",
"data": { "price": "$49.00" },
"duration_ms": 412
}curl
curl https://api.osnova.dev/v1/parser/jobs/job_9c21 \
-H "Authorization: Bearer $OSNOVA_API_KEY"Ответ · 200 OK
{
"id": "job_9c21",
"status": "completed",
"result": { "price": "$49.00" }
}Шортлинкер
curl
curl -X POST https://api.osnova.dev/v1/links \
-H "Authorization: Bearer $OSNOVA_API_KEY" \
-d '{ "url": "https://example.com/blog/launch", "domain": "os.li", "slug": "launch" }'Ответ · 201 Created
{
"short_url": "https://os.li/launch",
"clicks": 0
}curl
curl https://api.osnova.dev/v1/links/launch/stats \
-H "Authorization: Bearer $OSNOVA_API_KEY"Ответ · 200 OK
{
"slug": "launch",
"clicks": 2481,
"top_referrer": "twitter.com"
}