Версия API: v1.2.0 (Stable)

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

Интегрируйте возможности ReSmeta с вашими внутренними системами (1С, Bitrix24, самописные CRM). Наш REST API позволяет программно управлять проектами, сметами, задачами и документооборотом.

Base URL https://api.resmeta.ru/v1
Content-Type application/json

Аутентификация

API использует Bearer-токены для аутентификации запросов. Вы можете найти или сгенерировать свой ключ в личном кабинете в разделе «Настройки» → «API и интеграции».

Передавайте ключ в заголовке Authorization каждого запроса.

cURL
curl -X GET "https://api.resmeta.ru/v1/projects" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "X-Client-Version: 1.2.0"

Получить список проектов

GET /v1/projects

Возвращает список всех проектов, доступных для вашего аккаунта, с поддержкой пагинации, сортировки и фильтрации по статусу.

Параметры запроса

Query Parameters

page Номер страницы (по умолчанию: 1)
limit Количество записей (макс: 100)
status Фильтр по статусу: active, archived
200 OK
{
  "data": [
    {
      "id": "prj_8x9a2b",
      "name": "ЖК Солнечный",
      "status": "active",
      "budget": 150000000,
      "created_at": "2023-10-25T14:30:00Z"
    }
  ],
  "meta": {
    "current_page": 1,
    "total": 42,
    "per_page": 20
  }
}

Коды ошибок

Код Описание Решение
400 Bad Request Проверьте формат JSON и наличие всех обязательных полей в запросе.
401 Unauthorized API-ключ отсутствует, истек или недействителен.
403 Forbidden У вашего токена недостаточно прав для доступа к этому ресурсу.
429 Too Many Requests Превышен лимит запросов (Rate Limit). Подождите и повторите попытку.

Готовы начать интеграцию?

Получите тестовый доступ к API (Sandbox) или свяжитесь с нашей командой для помощи в настройке сложных сценариев и вебхуков.