عدة تطوير البرمجيات SDK لـ Node.js من Benzinga

npm install @benzinga/session

# مثال: تثبيت وحدات معينة
npm install @benzinga/calendar-data
npm install @benzinga/quotes
npm install @benzinga/news-data

import { Session } from '@benzinga/session';

// تهيئة الجلسة باستخدام مفتاح API الخاص بك
const session = new Session({
  apiKey: 'YOUR_API_KEY'
});

const session = new Session({
  apiKey: 'YOUR_API_KEY',
  environment: 'production', // أو 'sandbox'
  timeout: 30000,            // مهلة الطلب بالميلي ثانية
  // خيارات إعداد إضافية
});

// مثال: الاشتراك في تحديثات البيانات
dataManager.subscribe((data) => {
  console.log('New data received:', data);
});

// Example: Handle events
dataManager.on('update', (event) => {
  console.log('Data updated:', event);
});

import { Session } from '@benzinga/session';
import { CalendarData, DividendEvent } from '@benzinga/calendar-data';

// سيوفر TypeScript الإكمال التلقائي والتحقق من النوع
const session = new Session({ apiKey: 'YOUR_API_KEY' });
const calendar = new CalendarData(session);

// استدعاءات API آمنة من حيث النوع
const dividends: DividendEvent[] = await calendar.getDividends({
  dateFrom: '2024-01-01',
  dateTo: '2024-12-31',
  ticker: 'AAPL'
});

import { Session } from '@benzinga/session';
import { NewsData } from '@benzinga/news-data';

const session = new Session({ apiKey: 'YOUR_API_KEY' });
const news = new NewsData(session);

// جلب أحدث الأخبار
const articles = await news.getNews({
  pageSize: 10,
  displayOutput: 'full'
});

console.log(articles);

import { Session } from '@benzinga/session';
import { QuoteStream } from '@benzinga/quotes';

const session = new Session({ apiKey: 'YOUR_API_KEY' });
const quoteStream = new QuoteStream(session);

// الاشتراك في عروض الأسعار الفورية
quoteStream.subscribe(['AAPL', 'MSFT', 'GOOGL'], (quote) => {
  console.log('Quote update:', quote);
});

// إلغاء الاشتراك عند الانتهاء
quoteStream.unsubscribe(['AAPL']);

import { Session } from '@benzinga/session';
import { CalendarData } from '@benzinga/calendar-data';

const session = new Session({ apiKey: 'YOUR_API_KEY' });
const calendar = new CalendarData(session);

// الحصول على الأرباح القادمة
const earnings = await calendar.getEarnings({
  dateFrom: '2024-01-01',
  dateTo: '2024-01-31',
  importance: 3  // ذات الأهمية العالية فقط
});

// الحصول على توزيعات الأرباح
const dividends = await calendar.getDividends({
  ticker: 'AAPL'
});

import { Session } from '@benzinga/session';
import { Fundamentals } from '@benzinga/fundamentals';

const session = new Session({ apiKey: 'YOUR_API_KEY' });
const fundamentals = new Fundamentals(session);

// جلب الملف التعريفي للشركة
const profile = await fundamentals.getCompanyProfile('AAPL');

// جلب نسب التقييم
const valuationRatios = await fundamentals.getValuationRatios('AAPL');

// جلب القوائم المالية
const financials = await fundamentals.getFinancials('AAPL');

// في تطبيق React أو Vue أو Angular الخاص بك
import { Session } from '@benzinga/session';
import { NewsData } from '@benzinga/news-data';

export function NewsComponent() {
  const session = new Session({ apiKey: process.env.BENZINGA_API_KEY });
  const news = new NewsData(session);

  // استخدم في منطق المكون الخاص بك
  useEffect(() => {
    news.getNews({ pageSize: 5 }).then(articles => {
      setNewsData(articles);
    });
  }, []);
}

import { Session } from '@benzinga/session';
import { NewsData } from '@benzinga/news-data';

const session = new Session({ apiKey: 'YOUR_API_KEY' });
const news = new NewsData(session);

try {
  const articles = await news.getNews({ pageSize: 10 });
  console.log(articles);
} catch (error) {
  if (error.code === 'UNAUTHORIZED') {
    console.error('مفتاح API غير صالح');
  } else if (error.code === 'RATE_LIMIT') {
    console.error('تم تجاوز حد المعدل');
  } else {
    console.error('حدث خطأ:', error.message);
  }
}

import { Session } from '@benzinga/session';
import { NewsData } from '@benzinga/news-data';

const session = new Session({ apiKey: 'YOUR_API_KEY' });
const news = new NewsData(session);

// جلب صفحات متعددة
let page = 0;
let allArticles = [];

while (page < 5) {
  const articles = await news.getNews({
    page: page,
    pageSize: 100
  });

  if (articles.length === 0) break;

  allArticles = allArticles.concat(articles);
  page++;
}

console.log(`Fetched ${allArticles.length} articles`);

import { Session } from '@benzinga/session';
import { CalendarData } from '@benzinga/calendar-data';

const session = new Session({
  apiKey: 'YOUR_API_KEY',
  cache: {
    enabled: true,
    ttl: 300000  // التخزين المؤقت لمدة 5 دقائق
  }
});

const calendar = new CalendarData(session);

// الاستدعاء الأول يتصل بواجهة برمجة التطبيقات API
const earnings1 = await calendar.getEarnings({ ticker: 'AAPL' });

// الاستدعاء الثاني يستخدم البيانات المخزنة مؤقتاً (إذا كانت ضمن TTL)
const earnings2 = await calendar.getEarnings({ ticker: 'AAPL' });

// session.ts
export const globalSession = new Session({ apiKey: process.env.BENZINGA_API_KEY });

// في ملفات أخرى
import { globalSession } from './session';
const news = new NewsData(globalSession);

// ملف .env
BENZINGA_API_KEY=your_api_key_here

// في الكود
const session = new Session({
  apiKey: process.env.BENZINGA_API_KEY
});

import type { NewsArticle, NewsParams } from '@benzinga/news-data';

const params: NewsParams = {
  pageSize: 10,
  displayOutput: 'full',
  ticker: 'AAPL'
};

const articles: NewsArticle[] = await news.getNews(params);

const safeApiCall = async (fn: () => Promise<any>) => {
  try {
    return await fn();
  } catch (error) {
    console.error('API Error:', error);
    // تسجيل الخطأ في خدمة تتبع الأخطاء
    return null;
  }
};

const articles = await safeApiCall(() => news.getNews({ pageSize: 10 }));