Fejlesztőknek
API-kulcsok és webhookok
Kulcs létrehozása, hatókörök, az aláírás ellenőrzése.
Frissítve
API-kulcs
- 1Beállítások → API → Új kulcs. Válassz hatókört: read vagy write.
- 2A nyers kulcs egyszer jelenik meg; nálunk csak a SHA-256 lenyomata marad. Ha elveszett, vonj vissza és készíts újat.
- 3Authorization: Bearer mck_… fejlécben küldd. Percenként 120 kérés; felette 429 Retry-After fejléccel.
A kulcs a szervezeté, nem egy személyé, ezért a felhasználónkénti rekordhatókör nem vonatkozik rá. Az MCP-végpont ugyanezt a kulcsot fogadja.
Webhookok
Események: contact.created, contact.updated, deal.created, deal.status_changed, deal.won, deal.lost, quote.accepted, quote.rejected, invoice.paid, form.submitted, task.completed, webshop.order, record.created, record.updated, company.created, company.updated, deal.updated, task.created, quote.created, product.created, product.updated, invoice.issued, lead.received, call.ended, call.missed.
Minden kérés X-MiniCRM-Signature: t=<unix>,v1=<hmac> fejlécet kap; a HMAC-SHA256 a <timestamp>.<body> fölött készül a webhook titkos kulcsával. Ellenőrizd az időbélyeget is: öt percnél régebbi kérés visszajátszás. Sikertelen kézbesítés exponenciális várakozással próbálkozik újra, és a napló mutatja a választ.
A Slack, Discord, Teams, Zapier, Make és n8n bővítmények ugyanezen az úton mennek, szolgáltatói alakú törzzsel.