Et komplett REST API for å automatisere bestillingene dine
https://nakrytka.vip/api/v1Bruk et Bearer-token i Authorization-headeren.
# Pass your API key in the Authorization header
curl -X GET "https://nakrytka.vip/api/v1/balance" \
-H "Authorization: Bearer YOUR_API_KEY"Alle forespørsler går over HTTPS, og svarene kommer tilbake som JSON.
Alle endepunktene nedenfor legges til basis-URL-en.
Grensen avhenger av nivået ditt; hvert svar inneholder headere for ratebegrensning.
curl -X POST "https://nakrytka.vip/api/v1/orders" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"service_id": "svc_abc123",
"link": "https://instagram.com/yourprofile",
"quantity": 1000
}'Fullstendig liste over tilgjengelige API-metoder
/api/v1/balanceGet account balance
Returns the current account balance and currency.
Forespørsel
curl -X GET "https://nakrytka.vip/api/v1/balance" \
-H "Authorization: Bearer YOUR_API_KEY"Respons
{
"success": true,
"balance": 1250.50,
"currency": "RUB"
}/api/v1/servicesList services
Returns all active services with rates, min/max and average time.
Parametere
platformstring— Filter by platform (e.g. instagram)categorystring— Filter by category slugForespørsel
curl -X GET "https://nakrytka.vip/api/v1/services?platform=instagram" \
-H "Authorization: Bearer YOUR_API_KEY"Respons
{
"success": true,
"services": [
{
"id": "svc_abc123",
"name": "Instagram Followers — Premium",
"platform": "instagram",
"ratePer1000": 89.0,
"minOrder": 10,
"maxOrder": 100000,
"averageTime": "0-1 hour"
}
]
}/api/v1/ordersPlace new order
Creates a new order for a service. Auto-starts within 30 seconds.
Parametere
service_idrequiredstring— Service ID from /serviceslinkrequiredstring— Target URL (post, profile, channel)quantityrequiredinteger— Number of units (min/max per service)Forespørsel
curl -X POST "https://nakrytka.vip/api/v1/orders" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"service_id": "svc_abc123",
"link": "https://instagram.com/yourprofile",
"quantity": 1000
}'Respons
{
"success": true,
"order": {
"id": "ord_xyz789",
"orderNumber": "SMB-2026-001234",
"status": "PENDING",
"totalAmount": 89.0,
"currency": "RUB",
"startCount": 0,
"remains": 1000,
"createdAt": "2026-01-15T10:30:00Z"
}
}/api/v1/orders/:idGet order status
Returns detailed status of a single order, including progress and start count.
Parametere
idrequiredstring— Order ID (path param)Forespørsel
curl -X GET "https://nakrytka.vip/api/v1/orders/ord_xyz789" \
-H "Authorization: Bearer YOUR_API_KEY"Respons
{
"success": true,
"order": {
"id": "ord_xyz789",
"status": "IN_PROGRESS",
"progress": 65,
"startCount": 1200,
"remains": 350,
"completedAt": null,
"updatedAt": "2026-01-15T11:05:00Z"
}
}/api/v1/ordersList user orders
Returns paginated list of the authenticated user's orders.
Parametere
pageinteger— Page number (default 1)limitinteger— Page size (default 20, max 100)statusstring— Filter by status (PENDING, IN_PROGRESS, COMPLETED, ...)Forespørsel
curl -X GET "https://nakrytka.vip/api/v1/orders?limit=10&status=COMPLETED" \
-H "Authorization: Bearer YOUR_API_KEY"Respons
{
"success": true,
"orders": [ { "id": "ord_xyz789", "status": "COMPLETED", "..." : "..." } ],
"pagination": { "page": 1, "limit": 10, "total": 47, "pages": 5 }
}/api/v1/orders/:id/cancelCancel order
Cancels a pending or partially-completed order. Refund is credited to the balance for the unfinished quantity.
Parametere
idrequiredstring— Order ID (path param)Forespørsel
curl -X POST "https://nakrytka.vip/api/v1/orders/ord_xyz789/cancel" \
-H "Authorization: Bearer YOUR_API_KEY"Respons
{
"success": true,
"order": {
"id": "ord_xyz789",
"status": "CANCELED",
"refundedAmount": 31.15,
"currency": "RUB"
}
}Vi sender POST til URL-en din hver gang en abonnert hendelse inntreffer.
Vi prøver på nytt opptil 5 ganger med økende forsinkelse.
Eksempel på forespørsel
POST https://your.webhook.url HTTP/1.1
Content-Type: application/json
X-Nakrytka-Event: ORDER_COMPLETED
X-Nakrytka-Signature: sha256=6d5f2a01c9e8b7...
{
"event": "ORDER_COMPLETED",
"orderNo": "ord_xyz789",
"status": "COMPLETED",
"timestamp": "2026-01-15T11:05:00Z"
}Leveringssignatur
Hver levering signeres med X-Nakrytka-Signature-headeren: sha256=<HMAC-SHA256 av forespørselskroppen, beregnet med webhook-hemmeligheten>. Hemmeligheten settes når webhooken opprettes i dashbordet, "API"-seksjonen.
const crypto = require('crypto');
// rawBody — тело запроса как буфер/строка ДО любого парсинга JSON
const expected =
'sha256=' +
crypto.createHmac('sha256', WEBHOOK_SECRET).update(rawBody).digest('hex');
const received = req.headers['x-nakrytka-signature'] ?? '';
const ok =
received.length === expected.length &&
crypto.timingSafeEqual(Buffer.from(received), Buffer.from(expected));
if (!ok) return res.status(401).end(); // не наша доставка| Code | Name | Description |
|---|---|---|
| 200 | OK | Request completed successfully |
| 400 | Bad Request | Invalid or missing parameter |
| 401 | Unauthorized | Missing or invalid API key |
| 402 | Payment Required | Insufficient account balance |
| 403 | Forbidden | API key lacks required permission |
| 404 | Not Found | Resource does not exist |
| 409 | Conflict | Order cannot be canceled in current status |
| 429 | Too Many Requests | Rate limit exceeded — back off and retry |
| 500 | Server Error | Internal server error — contact support |
Hvert svar inneholder headere for ratebegrensning.
Når grensen overskrides, returnerer API-et 429 — bruk eksponentiell backoff.
Generer en API-nøkkel på 30 sekunder rett i dashbordet.
Finn tjenester, artikler, guider og sider