URL de baza
/api/v1
Toate cererile API trebuie trimise catre acest URL
Versiune curenta
v1.0
API-ul foloseste versionare bazata pe URL
Limita de cereri
100/minut
Limita standard pentru toate endpoint-urile
Format raspuns
JSON
Toate raspunsurile sunt in format JSON
curl -X GET "https://your-domain.com/api/v1/clients?companyId=xxx" \
-H "Authorization: Bearer fm_live_xxxxx" \
-H "Content-Type: application/json"curl -X GET "https://your-domain.com/api/v1/clients?companyId=xxx" \
-H "X-API-Key: fm_live_xxxxx" \
-H "Content-Type: application/json"fm_live_Chei de productie - acces la date realefm_test_Chei de test - mediu sandboxGenereaza o cheie API din Setari → API. Fiecare cheie poate avea scope-uri diferite: read, write, delete.
invoice.created invoice.paid invoice.overdueexpense.created expense.approvedclient.created client.updatedbudget.exceeded budget.warningconst crypto = require('crypto');
// Obtine semnatura din header
const signature = req.headers['x-webhook-signature'];
// Calculeaza semnatura asteptata
const expected = 'sha256=' + crypto
.createHmac('sha256', webhookSecret)
.update(JSON.stringify(req.body))
.digest('hex');
// Verifica (timing-safe)
const isValid = crypto.timingSafeEqual(
Buffer.from(signature),
Buffer.from(expected)
);{
"event": "invoice.created",
"timestamp": "2024-01-15T10:30:00.000Z",
"companyId": "cm1xyz789ghi012",
"data": {
"invoice": {
"id": "cm1inv123abc456",
"series": "FACT",
"number": 15,
"totalAmount": 1190.00,
"status": "draft"
}
}
}Configureaza webhook-urile din Setari → Webhooks. Reincerarile sunt automate: 1 min, 5 min, 30 min, 2 ore, 24 ore.
Sincronizeaza facturile si cheltuielile cu sistemul ERP existent.
GET /invoicesGET /expensesPOST /webhooksConstruieste un dashboard financiar personalizat pentru echipa.
GET /reports/{type}GET /expenses/summaryAutomatizeaza crearea facturilor din aplicatia ta.
POST /invoicesPOST /clientsPOST /invoices/{id}/sendCreeaza facturi automat la fiecare comanda.
POST /clientsPOST /invoicesPOST /revenuesGenereaza rapoarte financiare programate.
GET /reports/profit-lossGET /reports/exportPrimeste alerte cand bugetele sunt depasire.
POST /webhooks (budget.exceeded)GET /expenses/summary| Cod HTTP | Cod eroare | Descriere | Solutie |
|---|---|---|---|
| 400 | VALIDATION_ERROR | Cerere invalida sau parametri lipsa | Verifica parametrii cererii |
| 401 | MISSING_API_KEY | Cheia API lipseste din cerere | Adauga Authorization sau X-API-Key header |
| 401 | INVALID_API_KEY | Cheia API este invalida sau expirata | Genereaza o noua cheie API |
| 403 | INSUFFICIENT_SCOPE | Cheia nu are permisiunile necesare | Verifica scope-urile cheii API |
| 404 | NOT_FOUND | Resursa nu a fost gasita | Verifica ID-ul resursei |
| 429 | RATE_LIMITED | Ai depasit limita de cereri | Asteapta conform header-ului Retry-After |
| 500 | INTERNAL_ERROR | Eroare interna de server | Contacteaza suportul |
Exploreaza endpoint-urile API si testeaza-le direct din browser. Apasa pe "Authorize" pentru a introduce cheia ta API.
JavaScript
In curand
Python
In curand
PHP
In curand
C#
In curand
Pana la lansarea SDK-urilor oficiale, poti folosi orice client HTTP sau biblioteci OpenAPI precum openapi-generator.