REST API

हमारी पूर्ण API का उपयोग करके FluenzR को अपने टूल के साथ एकीकृत करें।

REST API

FluenzR API आपको प्लेटफ़ॉर्म को अपने टूल के साथ एकीकृत करने और अपने वर्कफ़्लो को स्वचालित करने देता है।

जानकारी REST API केवल Pro योजना पर उपलब्ध है।

अवलोकन

FluenzR API एक REST API है जो आपको अनुमति देता है:

  • अपने संपर्कों को प्रोग्रामेटिक रूप से प्रबंधित करें
  • अभियान बनाएं और नियंत्रित करें
  • आंकड़े प्राप्त करें
  • घटनाओं पर webhooks प्राप्त करें

आधार URL

https://api.fluenzr.co/v1

प्रतिक्रिया प्रारूप

सभी प्रतिक्रियाएं JSON प्रारूप में हैं:

{
  "success": true,
  "data": { ... },
  "meta": {
    "page": 1,
    "perPage": 20,
    "total": 150
  }
}

त्रुटि पर

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Email is required",
    "details": { ... }
  }
}

HTTP कोड

कोडअर्थ
200सफलता
201संसाधन बनाया गया
400अमान्य अनुरोध
401प्रमाणित नहीं
403अधिकृत नहीं
404संसाधन नहीं मिला
429दर सीमा पार
500सर्वर त्रुटि

दर सीमा

योजनासीमा
Pro1000 अनुरोध/मिनट

प्रतिक्रिया हेडर आपके उपयोग को इंगित करते हैं:

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 950
X-RateLimit-Reset: 1640000000

पृष्ठांकन

संसाधन सूचीबद्ध करने वाले एंडपॉइंट पृष्ठांकन का समर्थन करते हैं:

GET /contacts?page=2&perPage=50
पैरामीटरविवरणडिफ़ॉल्टअधिकतम
pageपृष्ठ संख्या1-
perPageप्रति पृष्ठ आइटम20100

फ़िल्टरिंग

क्वेरी पैरामीटर के साथ परिणाम फ़िल्टर करें:

GET /contacts?email=example.com&group=123

सॉर्टिंग

परिणाम क्रमबद्ध करें:

GET /contacts?sort=createdAt&order=desc

उपलब्ध एंडपॉइंट

संपर्क

विधिएंडपॉइंटविवरण
GET/contactsसंपर्क सूचीबद्ध करें
GET/contacts/:idसंपर्क प्राप्त करें
POST/contactsसंपर्क बनाएं
PUT/contacts/:idसंपर्क अपडेट करें
DELETE/contacts/:idसंपर्क हटाएं

समूह

विधिएंडपॉइंटविवरण
GET/groupsसमूह सूचीबद्ध करें
GET/groups/:idसमूह प्राप्त करें
POST/groupsसमूह बनाएं
PUT/groups/:idसमूह अपडेट करें
DELETE/groups/:idसमूह हटाएं
POST/groups/:id/contactsसंपर्क जोड़ें

अभियान

विधिएंडपॉइंटविवरण
GET/campaignsअभियान सूचीबद्ध करें
GET/campaigns/:idअभियान प्राप्त करें
POST/campaignsअभियान बनाएं
PUT/campaigns/:idअभियान अपडेट करें
POST/campaigns/:id/startप्रारंभ करें
POST/campaigns/:id/pauseरोकें
POST/campaigns/:id/contactsसंपर्क जोड़ें
GET/campaigns/:id/statsआंकड़े

Webhooks

विधिएंडपॉइंटविवरण
GET/webhookswebhooks सूचीबद्ध करें
POST/webhookswebhook बनाएं
DELETE/webhooks/:idहटाएं

SDK और लाइब्रेरी

JavaScript/TypeScript

npm install @fluenzr/sdk
import { FluenzrClient } from '@fluenzr/sdk';

const client = new FluenzrClient({
  apiKey: 'your-api-key'
});

const contacts = await client.contacts.list();

Python

pip install fluenzr
from fluenzr import FluenzrClient

client = FluenzrClient(api_key='your-api-key')
contacts = client.contacts.list()

उपयोग उदाहरण

CRM सिंक करें

// अपने CRM से नए संपर्क प्राप्त करें
const crmContacts = await myCRM.getNewContacts();

// उन्हें FluenzR में बनाएं
for (const contact of crmContacts) {
  await fluenzr.contacts.create({
    email: contact.email,
    firstName: contact.first_name,
    lastName: contact.last_name,
    company: contact.company
  });
}

अभियान स्वचालित करें

// API के माध्यम से अभियान बनाएं
const campaign = await fluenzr.campaigns.create({
  name: 'Automated Q1 2025',
  emailAccountId: 'acc_123',
  // ...
});

// संपर्क जोड़ें
await fluenzr.campaigns.addContacts(campaign.id, {
  groupId: 'grp_456'
});

// प्रारंभ करें
await fluenzr.campaigns.start(campaign.id);

आंकड़े निर्यात करें

// सभी अभियानों के लिए आंकड़े प्राप्त करें
const campaigns = await fluenzr.campaigns.list();

for (const campaign of campaigns) {
  const stats = await fluenzr.campaigns.getStats(campaign.id);
  console.log(`${campaign.name}: ${stats.openRate}% opens, ${stats.replyRate}% replies`);
}

समर्थन

किसी भी API प्रश्न के लिए: