REST API Cornvilla.

Start w 5 minut

1. 1

   Dodaj aplikację

   W panelu Cornvilla: Ustawienia → API → Dodaj aplikację. Nadaj nazwę i zaznacz uprawnienia. Dostaniesz Client ID i Client Secret — secret widać tylko raz, zapisz go po stronie serwera.

2. 2

   Pobierz token

   Wyślij POST https://api.cornvilla.com/v1/oauth/token z grant_type=client_credentials i danymi aplikacji (nagłówek Basic albo treść). Token jest ważny godzinę.

3. 3

   Wywołuj API

   Dodawaj nagłówek Authorization: Bearer <token>, np. GET https://api.cornvilla.com/v1/me albo GET https://api.cornvilla.com/v1/orders?status=pending. Po wygaśnięciu tokenu pobierz nowy.

# 1. Token (Client ID i Client Secret z Ustawienia → API)
curl -X POST "https://api.cornvilla.com/v1/oauth/token" \
  -u "cv_0123456789abcdef:CLIENT_SECRET" \
  -d "grant_type=client_credentials"

{ "access_token": "cvat_…", "token_type": "Bearer", "expires_in": 3600, "scope": "orders:read stock:read" }

# 2. Wywołanie
curl "https://api.cornvilla.com/v1/me" -H "Authorization: Bearer cvat_…"

{
  "company": { "id": "…", "slug": "twoja-firma", "name": "Twoja Firma Sp. z o.o." },
  "app": { "name": "ERP", "clientId": "cv_0123456789abcdef", "scopes": ["orders:read", "stock:read"] },
  "limits": { "requestsPerMinute": 120 },
  "warehouse": { "id": "…", "code": "GL", "name": "Magazyn główny", "isMain": true, "active": true }
}

Zasady wspólne

• Adres bazowy: https://api.cornvilla.com/v1. Treści i odpowiedzi w JSON (UTF-8), daty w ISO 8601 ze strefą, kwoty w groszach.
• Stronicowanie: page (od 1) i pageSize (do 200); odpowiedź: items, page, pageSize, total.
• Synchronizacja przyrostowa: GET /orders?updatedSince=2026-11-07T10:00:00Z zwraca tylko zamówienia zmienione po tej chwili.
• Wiele magazynów: domyślnie magazyn główny; id innego magazynu (z GET /warehouses) przekaż w nagłówku X-Warehouse.
• Wszystkie adresy: Dokumentacja API — parametry, treść, odpowiedzi i przykłady dla każdego adresu.
• Identyfikatory: obiekty mają stałe id (UUID). Produkty znajdziesz też po dokładnym sku albo ean, zamówienia po numerze przez q.

Błędy

Każdy błąd to JSON { "code": "…", "message": "…" } — code jest stały (do obsługi w kodzie), message po polsku (do pokazania).