API-first Architecture

ماکان را داخل محصول خودت بسازی

REST API کامل، SDK رسمی، Webhooks و Sandbox — هر چیزی که برای ساخت integration نیاز داری.

Maakan REST API v1

# دریافت لیست مشتریان با فیلتر سگمنت
GET https://api.maakancrm.com/v1/customers
Authorization: Bearer YOUR_API_KEY

# Response
{
  “customers”: [
    {
      “id”: “cust_xK9m2n”,
      “name”: “احمد رضایی”,
      “segment”: “vip”,
      “ltv”: 4500000,
      “points”: 2450
    }
  ]
}

Endpoints اصلی

GET/v1/customers

لیست مشتریان با فیلتر segment، تگ و بازه زمانی

POST/v1/events

ثبت رویداد سفارش، پرداخت یا رفتار مشتری

POST/v1/sms/send

ارسال پیامک فردی یا کمپین با template

GET/v1/pipeline

دریافت فرصت‌های فروش و وضعیت pipeline

POST/v1/loyalty/points

اضافه یا کم کردن امتیاز مشتری

WH/webhooks

رویدادهای push: order، payment، vip_upgrade، churn_risk

SDK رسمی

🐘

PHP

composer require maakan/sdk

🟨

JavaScript

npm install @maakan/sdk

🐍

Python

pip install maakan-sdk

🔗

REST Direct

هر زبانی با HTTP

Sandbox رایگان

محیط تست کامل با داده‌های نمونه — بدون نیاز به اکانت production

دریافت API Key رایگان