REST API ΠΈ ΡƒΠ΅Π±Ρ…ΡƒΠΊΠΎΠ²Π΅

ΠŸΡƒΠ±Π»ΠΈΡ‡Π΅Π½ REST API с няколко API ΠΊΠ»ΡŽΡ‡Π° ΠΈ подписани ΡƒΠ΅Π±Ρ…ΡƒΠΊΠΎΠ²Π΅

ДобавяйтС ΠΊΠ»ΠΈΠ΅Π½Ρ‚ΠΈ ΠΎΡ‚ уСбсайта, формуляра ΠΈΠ»ΠΈ Π±Π΅ΠΊΠ΅Π½Π΄Π° си с Π΅Π΄Π½ΠΎ HTTP ΠΈΠ·Π²ΠΈΠΊΠ²Π°Π½Π΅ ΠΈ ΠΏΠΎΠ»ΡƒΡ‡Π°Π²Π°ΠΉΡ‚Π΅ всяка промяна Π½Π° ΡΡŠΡ€Π²ΡŠΡ€Π° си, подписана с HMAC-SHA256.

Π’Π°ΡˆΠΈΡΡ‚ CRM Π²Π΅Ρ‡Π΅ Π½Π΅ Π΅ място, ΠΊΡŠΠ΄Π΅Ρ‚ΠΎ трябва Π΄Π° Π²Π»ΠΈΠ·Π°Ρ‚Π΅, Π·Π° Π΄Π° ΠΏΠΈΡˆΠ΅Ρ‚Π΅: става ΠΊΡ€Π°ΠΉΠ½Π° Ρ‚ΠΎΡ‡ΠΊΠ°, която Π²Π°ΡˆΠΈΡ‚Π΅ систСми ΠΈΠ·Π²ΠΈΠΊΠ²Π°Ρ‚.

AiCrm, CRM ΠΏΡ€ΠΈΠ»ΠΎΠΆΠ΅Π½ΠΈΠ΅Ρ‚ΠΎ Π½Π° AIsToHire, прСдоставя ΠΏΡƒΠ±Π»ΠΈΡ‡Π΅Π½ REST API Π²ΡŠΡ€Ρ…Ρƒ Π²Π°ΡˆΠΈΡ‚Π΅ собствСни ΠΊΠΎΠ½Ρ‚Π°ΠΊΡ‚ΠΈ. Π‘ ΠΊΠ»ΡŽΡ‡ Π² Ρ…Π΅Π΄ΡŠΡ€Π° `X-Api-Key` ΠΌΠΎΠΆΠ΅Ρ‚Π΅ Π΄Π° ΡΡŠΠ·Π΄Π°Π²Π°Ρ‚Π΅, изброяватС, Ρ€Π°Π·Π³Π»Π΅ΠΆΠ΄Π°Ρ‚Π΅, Π°ΠΊΡ‚ΡƒΠ°Π»ΠΈΠ·ΠΈΡ€Π°Ρ‚Π΅ ΠΈ ΠΈΠ·Ρ‚Ρ€ΠΈΠ²Π°Ρ‚Π΅ ΠΊΠΎΠ½Ρ‚Π°ΠΊΡ‚ΠΈ ΠΈ Π΄Π° добавятС активности към всСки ΠΎΡ‚ тях β€” ΠΎΡ‚ формуляра Π½Π° уСбсайта си, ΠΎΡ‚ Ρ‡Π°Ρ‚Π±ΠΎΡ‚Π°, ΠΎΡ‚ Zap, ΠΎΡ‚ скрипт Π½Π° Python ΠΈΠ»ΠΈ ΠΎΡ‚ собствСния си Π±Π΅ΠΊΠ΅Π½Π΄. ΠžΡ‚Π³ΠΎΠ²ΠΎΡ€ΠΈΡ‚Π΅ са JSON във Ρ„ΠΎΡ€ΠΌΠ°Ρ‚Π° `{ success, data }`, Π° Π»ΠΈΠΌΠΈΡ‚ΡŠΡ‚ Π΅ 100 заявки Π² ΠΌΠΈΠ½ΡƒΡ‚Π° Π½Π° ΠΊΠ»ΡŽΡ‡.

ДобавянСто ΠΏΡ€Π΅Π· API Π½Π΅ Π΄ΡƒΠ±Π»ΠΈΡ€Π°: Π°ΠΊΠΎ ΠΈΠΌΠ΅ΠΉΠ»ΡŠΡ‚, ΠΊΠΎΠΉΡ‚ΠΎ ΠΈΠ·ΠΏΡ€Π°Ρ‰Π°Ρ‚Π΅, Π²Π΅Ρ‡Π΅ ΡΡŠΡ‰Π΅ΡΡ‚Π²ΡƒΠ²Π° във Π²Π°ΡˆΠ°Ρ‚Π° Π±Π°Π·Π°, AiCrm Π°ΠΊΡ‚ΡƒΠ°Π»ΠΈΠ·ΠΈΡ€Π° ΠΊΠ°Ρ€Ρ‚Π°Ρ‚Π°, която Π²Π΅Ρ‡Π΅ ΠΈΠΌΠ°Ρ‚Π΅ (допълва липсващия Ρ‚Π΅Π»Π΅Ρ„ΠΎΠ½, ΠΈΠΌΠ΅ ΠΈΠ»ΠΈ Ρ„ΠΈΡ€ΠΌΠ°, обСдинява Π΅Ρ‚ΠΈΠΊΠ΅Ρ‚ΠΈΡ‚Π΅) ΠΈ записва Π½ΠΎΠ²ΠΎ ΠΏΠΎΡΡ‚ΡŠΠΏΠ»Π΅Π½ΠΈΠ΅ Π² Π½Π΅ΠΉΠ½Π°Ρ‚Π° хронология, ΠΊΠ°Ρ‚ΠΎ Π²Ρ€ΡŠΡ‰Π° HTTP 200; Π°ΠΊΠΎ Π΅ Π½ΠΎΠ², Π³ΠΎ създава ΠΈ Π²Ρ€ΡŠΡ‰Π° 201. ВсСки ΠΊΠΎΠ½Ρ‚Π°ΠΊΡ‚, ΠΏΠΎΡΡ‚ΡŠΠΏΠΈΠ» ΠΏΡ€Π΅Π· API, сС Π΅Ρ‚ΠΈΠΊΠ΅Ρ‚ΠΈΡ€Π° Π°Π²Ρ‚ΠΎΠΌΠ°Ρ‚ΠΈΡ‡Π½ΠΎ ΠΊΠ°Ρ‚ΠΎ `api-lead`, Π·Π°ΠΏΠ°Π·Π²Π° Π΅Ρ‚ΠΈΠΊΠ΅Ρ‚ΠΈΡ‚Π΅, ΠΊΠΎΠΈΡ‚ΠΎ ΠΈΠ·ΠΏΡ€Π°Ρ‰Π°Ρ‚Π΅, ΠΈ записва `subId` Π½Π° ΠΏΡ€ΠΎΠΈΠ·Ρ…ΠΎΠ΄Π°, ΠΊΠ°ΠΊΡ‚ΠΎ ΠΈ Π΄ΡŠΡ€ΠΆΠ°Π²Π°Ρ‚Π°, IP адрСса ΠΈ Π±Ρ€Π°ΡƒΠ·ΡŠΡ€Π°, ΠΎΡ‚ ΠΊΠΎΠΈΡ‚ΠΎ Π΅ дошъл.

ΠœΠΎΠΆΠ΅Ρ‚Π΅ Π΄Π° ΠΈΠΌΠ°Ρ‚Π΅ Π΄ΠΎ 20 API ΠΊΠ»ΡŽΡ‡Π° със собствСно ΠΈΠΌΠ΅, освСн Π²ΡŠΡ‚Ρ€Π΅ΡˆΠ½ΠΈΡ ΠΊΠ»ΡŽΡ‡ Π½Π° ΠΏΡ€ΠΈΠ»ΠΎΠΆΠ΅Π½ΠΈΠ΅Ρ‚ΠΎ. Π’Π°ΠΊΠ° Π΄Π°Π²Π°Ρ‚Π΅ Ρ€Π°Π·Π»ΠΈΡ‡Π΅Π½ ΠΊΠ»ΡŽΡ‡ Π½Π° всяка интСграция —уСбсайта, формуляра Π½Π° майската кампания, стаТанта, доставчика— ΠΈ Π³ΠΎ отмСнятС самостоятСлно, ΠΊΠΎΠ³Π°Ρ‚ΠΎ интСграцията ΠΏΡ€ΠΈΠΊΠ»ΡŽΡ‡ΠΈ, Π±Π΅Π· Π΄Π° докосватС останалитС. ΠŸΡŠΠ»Π½Π°Ρ‚Π° стойност Π½Π° ΠΊΠ»ΡŽΡ‡Π° сС ΠΏΠΎΠΊΠ°Π·Π²Π° само вСднъТ, ΠΏΡ€ΠΈ ΡΡŠΠ·Π΄Π°Π²Π°Π½Π΅Ρ‚ΠΎ; слСд Ρ‚ΠΎΠ²Π° сС Π²ΠΈΠΆΠ΄Π° само маскирана Π² списъка.

Π’ ΠΎΠ±Ρ€Π°Ρ‚Π½Π°Ρ‚Π° посока ΡƒΠ΅Π±Ρ…ΡƒΠΊΠΎΠ²Π΅Ρ‚Π΅ извСстяват Π²Π°ΡˆΠΈΡ‚Π΅ систСми. НастройватС Π΄ΠΎ 10 дСстинации, ΠΈΠ·Π±ΠΈΡ€Π°Ρ‚Π΅ Π·Π° ΠΊΠΎΠΈ ΡΡŠΠ±ΠΈΡ‚ΠΈΡ сС Π°Π±ΠΎΠ½ΠΈΡ€Π° всяка (`customer.created`, `customer.updated`, `customer.deleted`, `activity.created`) ΠΈ AiCrm ΠΏΡ€Π°Π²ΠΈ POST към вашия URL с Ρ…Π΅Π΄ΡŠΡ€ΠΈΡ‚Π΅ `X-AiCrm-Event` ΠΈ `X-AiCrm-Signature: sha256=…`, ΠΏΠΎΠ΄ΠΏΠΈΡΡŠΡ‚ HMAC-SHA256 Π½Π° тялото с тайния ΠΊΠ»ΡŽΡ‡ Π½Π° Ρ‚ΠΎΠ·ΠΈ ΡƒΠ΅Π±Ρ…ΡƒΠΊ, Π·Π° Π΄Π° ΠΏΡ€ΠΎΠ²Π΅Ρ€ΠΈΡ‚Π΅, Ρ‡Π΅ доставката Π΅ Π»Π΅Π³ΠΈΡ‚ΠΈΠΌΠ½Π°. ΠŸΡ€ΠΈ Π·Π°ΠΏΠ°Π·Π²Π°Π½Π΅ Π½Π° URL адрСса Π·Π°Ρ‰ΠΈΡ‚Π° срСщу SSRF ΠΎΡ‚Ρ…Π²ΡŠΡ€Π»Ρ localhost, 127.0.0.0/8, 10.x, 192.168.x, 172.16-31.x, ::1, 0.0.0.0 ΠΈ Π΄ΠΎΠΌΠ΅ΠΉΠ½ΠΈΡ‚Π΅ `.local` ΠΈ `.internal`.

ΠŸΡ€Π΅Π΄ΠΈΠΌΡΡ‚Π²Π° Π½Π° REST API ΠΈ ΡƒΠ΅Π±Ρ…ΡƒΠΊΠΎΠ²Π΅

ДобавянС Π½Π° ΠΊΠΎΠ½Ρ‚Π°ΠΊΡ‚ΠΈ с Π΅Π΄Π½ΠΎ ΠΈΠ·Π²ΠΈΠΊΠ²Π°Π½Π΅

POST към `/api/apps/public/crm/customers` с ΠΈΠΌΠ΅ΠΉΠ»Π° ΠΈ Π΅Ρ‚ΠΈΠΊΠ΅Ρ‚ΠΈΡ‚Π΅, ΠΊΠΎΠΈΡ‚ΠΎ ΠΆΠ΅Π»Π°Π΅Ρ‚Π΅, ΠΈ Π»ΠΈΠΉΠ΄ΡŠΡ‚ Π²Π΅Ρ‡Π΅ Π΅ във вашия CRM, класифициран.

Π‘Π΅Π· Π΄ΡƒΠ±Π»ΠΈΠΊΠ°Ρ‚ΠΈ ΠΏΠΎ Π΄ΠΈΠ·Π°ΠΉΠ½

Π°ΠΊΠΎ ΠΈΠΌΠ΅ΠΉΠ»ΡŠΡ‚ Π²Π΅Ρ‡Π΅ ΡΡŠΡ‰Π΅ΡΡ‚Π²ΡƒΠ²Π°, ΠΊΠ°Ρ€Ρ‚Π°Ρ‚Π° сС Π°ΠΊΡ‚ΡƒΠ°Π»ΠΈΠ·ΠΈΡ€Π° ΠΈ Π½ΠΎΠ²ΠΎΡ‚ΠΎ ΠΏΠΎΡΡ‚ΡŠΠΏΠ»Π΅Π½ΠΈΠ΅ сС записва Π² Π½Π΅ΠΉΠ½Π°Ρ‚Π° хронология, вмСсто Π΄Π° сС създава Π²Ρ‚ΠΎΡ€Π° ΠΊΠ°Ρ€Ρ‚Π°.

Π”ΠΎ 20 ΠΈΠΌΠ΅Π½ΡƒΠ²Π°Π½ΠΈ ΠΊΠ»ΡŽΡ‡Π°

ΠΏΠΎ Π΅Π΄ΠΈΠ½ Π·Π° всяка интСграция, отмСняСм ΠΏΠΎΠΎΡ‚Π΄Π΅Π»Π½ΠΎ. Ако Π΄Π°Π΄Π΅Π½ ΠΊΠ»ΡŽΡ‡ ΠΈΠ·Ρ‚Π΅Ρ‡Π΅, ΠΈΠ·Ρ‚Ρ€ΠΈΠ²Π°Ρ‚Π΅ Π½Π΅Π³ΠΎ ΠΈ Π½ΠΈΡ‰ΠΎ Π΄Ρ€ΡƒΠ³ΠΎ Π½Π΅ спира Π΄Π° Ρ€Π°Π±ΠΎΡ‚ΠΈ.

Π£Π΅Π±Ρ…ΡƒΠΊΠΎΠ²Π΅, подписани с HMAC-SHA256

провСряватС Ρ…Π΅Π΄ΡŠΡ€Π° `X-AiCrm-Signature` със своя Ρ‚Π°Π΅Π½ ΠΊΠ»ΡŽΡ‡ ΠΈ Π·Π½Π°Π΅Ρ‚Π΅, Ρ‡Π΅ извСстиСто ΠΈΠ΄Π²Π° ΠΎΡ‚ вашия CRM, Π° Π½Π΅ ΠΎΡ‚ Ρ‚Ρ€Π΅Ρ‚Π° страна.

Π’ΠΊΠ»ΡŽΡ‡Π΅Π½Π° Π·Π°Ρ‰ΠΈΡ‚Π° срСщу SSRF

ΠΏΡ€ΠΈΠ»ΠΎΠΆΠ΅Π½ΠΈΠ΅Ρ‚ΠΎ ΠΎΡ‚ΠΊΠ°Π·Π²Π° Π΄Π° доставя ΡƒΠ΅Π±Ρ…ΡƒΠΊΠΎΠ²Π΅ към localhost ΠΈΠ»ΠΈ към частни ΠΌΡ€Π΅ΠΆΠΎΠ²ΠΈ Π΄ΠΈΠ°ΠΏΠ°Π·ΠΎΠ½ΠΈ, Ρ‚Π°ΠΊΠ° Ρ‡Π΅ Π²Π°ΡˆΠΈΡΡ‚ CRM Π½Π΅ ΠΌΠΎΠΆΠ΅ Π΄Π° сС ΠΈΠ·ΠΏΠΎΠ»Π·Π²Π° Π·Π° сондиранС Π½Π° Π²ΡŠΡ‚Ρ€Π΅ΡˆΠ½Π° ΠΌΡ€Π΅ΠΆΠ°.

ПълСн CRUD, нС само добавянС

списък с пагинация ΠΈ Ρ„ΠΈΠ»Ρ‚Ρ€ΠΈ (Ρ‚ΡŠΡ€ΡΠ΅Π½Π΅, статус, Π΅Ρ‚ΠΈΠΊΠ΅Ρ‚ΠΈ, Π΄ΡŠΡ€ΠΆΠ°Π²Π°), ΠΏΡ€Π΅Π³Π»Π΅Π΄ Π½Π° ΠΊΠΎΠ½Ρ‚Π°ΠΊΡ‚ с Π½Π΅Π³ΠΎΠ²Π°Ρ‚Π° активност, Π°ΠΊΡ‚ΡƒΠ°Π»ΠΈΠ·ΠΈΡ€Π°Π½Π΅, ΠΈΠ·Ρ‚Ρ€ΠΈΠ²Π°Π½Π΅ ΠΈ записванС Π½Π° активности към Π½Π΅Π³ΠΎ.

ΠŸΡ€ΠΎΠΈΠ·Ρ…ΠΎΠ΄ΡŠΡ‚ сС прослСдява Π°Π²Ρ‚ΠΎΠΌΠ°Ρ‚ΠΈΡ‡Π½ΠΎ

всяко добавянС ΠΏΡ€Π΅Π· API Π·Π°ΠΏΠ°Π·Π²Π° `subId`, ΠΊΠΎΠΉΡ‚ΠΎ ΠΈΠ·ΠΏΡ€Π°Ρ‰Π°Ρ‚Π΅, плюс Π΄ΡŠΡ€ΠΆΠ°Π²Π°Ρ‚Π°, IP адрСса ΠΈ Π±Ρ€Π°ΡƒΠ·ΡŠΡ€Π°, ΠΈ сС ΠΌΠ°Ρ€ΠΊΠΈΡ€Π° с `api-lead`, Π·Π° Π΄Π° Π³ΠΎ Ρ„ΠΈΠ»Ρ‚Ρ€ΠΈΡ€Π°Ρ‚Π΅ ΠΏΠΎ-късно Π² ΠΏΡ€ΠΈΠ»ΠΎΠΆΠ΅Π½ΠΈΠ΅Ρ‚ΠΎ.

ВСстовС Π±Π΅Π· Π½Π°Π»ΡƒΡ‡ΠΊΠ²Π°Π½Π΅

ΠΏΡ€ΠΈΠ»ΠΎΠΆΠ΅Π½ΠΈΠ΅Ρ‚ΠΎ Π²ΠΊΠ»ΡŽΡ‡Π²Π° докумСнтация Π½Π° ΠΊΡ€Π°ΠΉΠ½ΠΈΡ‚Π΅ Ρ‚ΠΎΡ‡ΠΊΠΈ с ΠΊΠΎΠΏΠΈΡ€ΡƒΠ΅ΠΌ ΠΏΡ€ΠΈΠΌΠ΅Ρ€ Π·Π° `curl` ΠΈ Π±ΡƒΡ‚ΠΎΠ½ Π·Π° ΠΈΠ·ΠΏΡ€Π°Ρ‰Π°Π½Π΅ Π½Π° тСстова доставка към всСки ΡƒΠ΅Π±Ρ…ΡƒΠΊ, със статуса ΠΈ часа Π½Π° послСдния ΠΎΠΏΠΈΡ‚.

Claire Donovan

Π‘Π²ΡŠΡ€ΠΆΠ΅Ρ‚Π΅ уСбсайта си с CRM ΠΎΡ‰Π΅ Ρ‚Π°Π·ΠΈ Π²Π΅Ρ‡Π΅Ρ€

AiCrm Π΅ CRM ΠΈΠ½ΡΡ‚Ρ€ΡƒΠΌΠ΅Π½Ρ‚ΡŠΡ‚ Π½Π° AIsToHire, ΠΊΠΎΠΉΡ‚ΠΎ ΠΏΠΎΠ»ΡƒΡ‡Π°Π²Π° Π²Π°ΡˆΠΈΡ‚Π΅ ΠΊΠΎΠ½Ρ‚Π°ΠΊΡ‚ΠΈ ΠΏΡ€Π΅Π· REST API ΠΈ извСстява Π²Π°ΡˆΠΈΡ‚Π΅ систСми с подписани ΡƒΠ΅Π±Ρ…ΡƒΠΊΠΎΠ²Π΅. Π‘ΡŠΠ·Π΄Π°ΠΉΡ‚Π΅ Π°ΠΊΠ°ΡƒΠ½Ρ‚, Π³Π΅Π½Π΅Ρ€ΠΈΡ€Π°ΠΉΡ‚Π΅ ΠΊΠ»ΡŽΡ‡ ΠΈ Π½Π°ΠΏΡ€Π°Π²Π΅Ρ‚Π΅ ΠΏΡŠΡ€Π²ΠΎΡ‚ΠΎ си ΠΈΠ·Π²ΠΈΠΊΠ²Π°Π½Π΅.

REST API Π·Π° CRM с подписани ΡƒΠ΅Π±Ρ…ΡƒΠΊΠΎΠ²Π΅ | AiCrm