Avalik API, webhookid ja integratsiooniressursid
Loo ja halda API võtmeid integratsioonide jaoks
Saa reaalajas teateid ärisündmustest oma süsteemi
Tee oma esimene API päring vähem kui 5 minutiga
Mine API võtmed lehele ja vajuta "Loo uus võti". Anna sellele kirjeldav nimi (nt. "Zapier integratsioon") ja vali vajalikud õigused.
Autentimiseks lisa võti Authorization päisesse kui Bearer token.
curl -X GET "https://synx.ee/api/v1/invoices?limit=10" \
-H "Authorization: Bearer sk_live_YOUR_API_KEY"bash{
"data": [
{
"id": "clxxxxxx",
"number": "INV-2026-001",
"status": "PAID",
"total": 299.00,
"currency": "EUR",
"issueDate": "2026-04-01T00:00:00.000Z",
"dueDate": "2026-04-15T00:00:00.000Z"
}
],
"pagination": {
"total": 127,
"limit": 10,
"offset": 0,
"hasMore": true
}
}jsonKõik avaliku API päringud peavad sisaldama API võtit Authorization päises:
Authorization: Bearer sk_live_abc123_...http/api/v1/invoicesNimekiri arveid (filtreeritav)/api/v1/contactsNimekiri kontakte/api/v1/contactsLoo uus kontaktRohkem endpointe tuleb peatselt juurde. Vaata täielikku dokumentatsiooni API viite lehelt.
Kõik webhook päringud on HMAC-SHA256 signeeritud. Kontrolli signatuuri enne päringu aktsepteerimist.
X-Synx-Event: INVOICE_PAID
X-Synx-Event-Id: uuid-v4-here
X-Synx-Signature: sha256-hmac-hex
X-Synx-Timestamp: 1712745600
X-Synx-Delivery: cuid-delivery-idhttpimport crypto from "crypto";
function verifyWebhook(payload, signature, secret) {
const expected = crypto
.createHmac("sha256", secret)
.update(payload)
.digest("hex");
return crypto.timingSafeEqual(
Buffer.from(signature, "hex"),
Buffer.from(expected, "hex")
);
}javascriptinvoice.createdUus arve loodiinvoice.sentArve saadeti kliendileinvoice.paidArve märgiti tasutuksinvoice.overdueArve on tähtajaks tasumatacontact.createdUus kontakt loodicontact.updatedKontakt uuendatipayment.receivedMakse laekuscontract.signedLeping allkirjastatiquote.acceptedPakkumus aktsepteeritibank.transaction.importedPangatehing imporditiKui sinu endpoint tagastab mitte-2xx vastuse, proovitakse uuesti:
Pärast 5 järjestikust ebaõnnestumist lülitatakse webhook automaatselt välja. Vaata logi webhookide halduslehelt.
| Plaan | Päringuid minutis | Päringuid päevas |
|---|---|---|
| Free | - | - |
| Pro | 60 | 10 000 |
| Business | 300 | 100 000 |
| Enterprise | 1000 | Piiramata |