API документация

• API адрес
• Автентикация
• Кодове за грешка
• Сигнали (reports)
• Файлове
• Градове
• API ключове

Максимум 10 заявки в минута по подразбиране! Актуалният лимит за вашия план можете да видите чрез /api/v1/api-keys/current/usage.

IP whitelist: всеки API ключ работи само от IP адресите, зададени при създаването му (или редакцията му чрез /api/v1/api-keys). Заявки от всеки друг IP адрес получават отговор 403.

Всички отговори са във формат JSON. При грешка HTTP кодът е различен от 200, а в полето message има описание на проблема:

{
    "message": "Невалиден телефон",
    "server": { "date": "2026-10-06 12:00:00", "httpCode": 400 }
}Копирай

{
    "message": "Методът не се поддържа за този адрес.",
    "server": { "date": "2026-10-06 12:00:00", "httpCode": 405 }
}Копирай

curl --location --request GET 'https://api.nekorekten.com/api/v1/reports?phone=359888888888' \
    --header 'Api-Key: xxxxxxxxxxxxxxxxxxxxxxxx'Копирай

{
    "message": null,
    "items": [
        {
            "id": "0obgyGbp1Ms",
            "firstName": "Ив**",
            "lastName": "Ив****",
            "email": "ivan.p*****@example.com",
            "phone": "+359888888888",
            "text": "Не плати поръчката и не вдига телефона.",
            "facebookUrl": null,
            "siteUrl": "example.com/profile/123",
            "siteUrlMapped": "http://example.com/profile/123",
            "user": {
                "id": "k3Jd9aWq2Lp",
                "firstName": "Петър",
                "lastName": "Петров",
                "email": "se****@shop.bg"
            },
            "city": {
                "id": 1,
                "name": "София",
                "region": "София-град",
                "postCode": 1000,
                "phoneCode": 2
            },
            "parent": null,
            "children": [],
            "categories": [],
            "files": [
                {
                    "file": { "id": "Xy7bN2mQ4Ta", "name": "chat.webp", "mimeType": "image/webp" }
                }
            ],
            "createDate": "2026-10-01T10:15:00+03:00",
            "views": 12,
            "liked": 0,
            "visibleOnlyForCreator": false,
            "isArchived": false
        }
    ],
    "count": 1,
    "currentPage": 1,
    "itemsPerPage": 20,
    "server": { "date": "2026-10-06 12:00:00", "httpCode": 200 }
}Копирай

curl --location --request POST 'https://api.nekorekten.com/api/v1/reports' \
    --header 'Api-Key: xxxxxxxxxxxxxxxxxxxxxxxx' \
    --header 'Content-Type: application/json' \
    --data-raw '{ "text": "Не плати поръчката", "firstName": "Иван", "lastName": "Иванов", "phone": "359888888888" }'Копирай

{
    "message": "Сигналът е изпратен успешно.",
    "details": {
        "id": "0obgyGbp1Ms",
        "firstName": "Иван",
        "lastName": "Иванов",
        "email": null,
        "phone": "+359888888888",
        "facebookUrl": null,
        "siteUrl": null,
        "text": "Не плати поръчката",
        "user": {
            "id": "k3Jd9aWq2Lp",
            "firstName": "Петър",
            "lastName": "Петров",
            "email": "[email protected]"
        },
        "city": null,
        "parent": null,
        "categories": [],
        "files": [],
        "children": [],
        "createDate": "2026-10-06T12:00:00+03:00",
        "views": 0,
        "liked": 0,
        "isView": false,
        "visibleOnlyForCreator": false
    },
    "server": { "date": "2026-10-06 12:00:00", "httpCode": 200 }
}Копирай

curl --location --request PATCH 'https://api.nekorekten.com/api/v1/reports/XXXXXXX' \
    --header 'Api-Key: xxxxxxxxxxxxxxxxxxxxxxxx' \
    --header 'Content-Type: application/json' \
    --data-raw '{ "firstName": "Иван", "lastName": "Иванов", "phone": "359888888888" }'Копирай

{
    "message": "Сигналът е редактиран успешно",
    "server": { "date": "2026-10-06 12:00:00", "httpCode": 200 }
}Копирай

curl --location --request DELETE 'https://api.nekorekten.com/api/v1/reports/0obgyGbp1Ms' \
    --header 'Api-Key: xxxxxxxxxxxxxxxxxxxxxxxx'Копирай

{
    "message": "Репортът е изтрит успешно",
    "server": { "date": "2026-10-06 12:00:00", "httpCode": 200 }
}Копирай

curl --location --request POST 'https://api.nekorekten.com/api/v1/files' \
    --header 'Api-Key: xxxxxxxxxxxxxxxxxxxxxxxx' \
    --form 'files[]=@"/path/to/file/chat.jpg"'Копирай

{
    "message": null,
    "items": [
        {
            "id": "Xy7bN2mQ4Ta",
            "name": "chat.webp",
            "md5": "9e107d9d372bb6826bd81d3542a419d6",
            "size": 48213,
            "mimeType": "image/webp",
            "modifications": null
        }
    ],
    "server": { "date": "2026-10-06 12:00:00", "httpCode": 200 }
}Копирай

curl --location --request GET 'https://api.nekorekten.com/api/v1/cities' \
    --header 'Api-Key: xxxxxxxxxxxxxxxxxxxxxxxx'Копирай

{
    "message": null,
    "items": [
        {
            "id": 1,
            "name": "София",
            "region": "София-град",
            "postCode": 1000,
            "phoneCode": 2
        }
    ],
    "server": { "date": "2026-10-06 12:00:00", "httpCode": 200 }
}Копирай

curl --location --request GET 'https://api.nekorekten.com/api/v1/api-keys' \
    --header 'Api-Key: xxxxxxxxxxxxxxxxxxxxxxxx'Копирай

{
    "message": null,
    "items": [
        {
            "id": "Qw8eR5tY2Uo",
            "name": "My key",
            "key": "0123456789abcdef0123456789abcdef01234567",
            "ips": ["192.168.1.1"],
            "createDate": "2026-10-01 10:00:00"
        }
    ],
    "count": 1,
    "server": { "date": "2026-10-06 12:00:00", "httpCode": 200 }
}Копирай

curl --location --request POST 'https://api.nekorekten.com/api/v1/api-keys' \
    --header 'Api-Key: xxxxxxxxxxxxxxxxxxxxxxxx' \
    --header 'Content-Type: application/json' \
    --data-raw '{ "name": "My key", "ips": "192.168.1.1" }'Копирай

{
    "message": "Ключът е създаден успешно",
    "details": {
        "id": 15,
        "name": "My key",
        "key": "0123456789abcdef0123456789abcdef01234567",
        "createDate": "2026-10-06T12:00:00+03:00",
        "ips": ["192.168.1.1"]
    },
    "server": { "date": "2026-10-06 12:00:00", "httpCode": 200 }
}Копирай

curl --location --request PATCH 'https://api.nekorekten.com/api/v1/api-keys/XXXXXXX' \
    --header 'Api-Key: xxxxxxxxxxxxxxxxxxxxxxxx' \
    --header 'Content-Type: application/json' \
    --data-raw '{ "name": "Updated key" }'Копирай

{
    "message": "The API key has been edited successfully",
    "details": {
        "id": "XXXXXXX"
    },
    "server": { "date": "2026-10-06 12:00:00", "httpCode": 200 }
}Копирай

curl --location --request DELETE 'https://api.nekorekten.com/api/v1/api-keys/XXXXXXX' \
    --header 'Api-Key: xxxxxxxxxxxxxxxxxxxxxxxx'Копирай

{
    "message": "The api key has been deleted successfully",
    "server": { "date": "2026-10-06 12:00:00", "httpCode": 200 }
}Копирай

curl --location --request GET 'https://api.nekorekten.com/api/v1/api-keys/XXXXXXX/requests?fromDate=2026-04-29+00:00:00&toDate=2026-04-29+23:59:59' \
    --header 'Api-Key: xxxxxxxxxxxxxxxxxxxxxxxx'Копирай

{
    "message": null,
    "items": [
        {
            "id": "Lk4jH7gF1Ds",
            "url": "/api/v1/reports",
            "httpResponseCode": 400,
            "ip": "192.168.1.1",
            "createDate": "2026-04-29 10:15:00",
            "getParameters": [],
            "postParameters": [],
            "response": {
                "message": "Моля посочете критерии за търсене.",
                "server": { "date": "2026-04-29 10:15:00", "httpCode": 400 }
            }
        }
    ],
    "count": 1,
    "server": { "date": "2026-10-06 12:00:00", "httpCode": 200 }
}Копирай

curl --location --request GET 'https://api.nekorekten.com/api/v1/api-keys/current/usage' \
    --header 'Api-Key: xxxxxxxxxxxxxxxxxxxxxxxx'Копирай

{
    "message": null,
    "items": {
        "plan": { "name": "Безплатен" },
        "apiRequests": { "used": 2, "limit": 10, "period": "minute" },
        "searchRequests": { "used": 15, "limit": 100, "period": "day" },
        "maxReportImages": 10,
        "searchPeriod": 2
    },
    "server": { "date": "2026-10-06 12:00:00", "httpCode": 200 }
}Копирай