FACTSET سڌو اسٽريمنگ آف ٽرانزيڪشن ميسيجز API سافٽ ويئر
پيداوار جي ڄاڻ
وضاحتون
- پيداوار جو نالو: ٽرانزيڪشن ميسيجز API جو سڌو وهڪرو
- نسخو: 1.0
- ڊولپر جي دستياب ۽ حوالن جي تاريخ: آگسٽ 2023
Motivation
ٽرانزيڪشن ميسيجز API جي سڌي اسٽريمنگ جي پويان مقصد ڪنهن به OMS فراهم ڪندڙ کان رڪارڊ ڳنڍڻ جو رستو مهيا ڪرڻ آهي ۽ پورٽ فوليو جي نگراني لاءِ FactSet جي حقيقي وقت پورٽ فوليو مئنيجمينٽ پليٽ فارم (PMP) سان واپاري ڊيٽا کي ضم ڪرڻ، واپار جي تخليق، ڪارڪردگي انتساب، ۽ واپسي جو تجزيو. .
API پروگرام
مٿانview
API پروگرام شروعاتي طور تي پورٽ فوليو اينالائيٽڪس انجڻ تي ڌيان ڏئي ٿو ۽ وڌايو ويو آهي ٻين اينالائيٽڪس انجڻ، پروڊڪٽس، ۽ APIs کي شامل ڪرڻ لاءِ مختلف ڪاروباري يونٽن مان.
پروگرام هيٺ ڏنل مهيا ڪري ٿو:
- ٽرانزيڪشن ميسيجز API جو سڌو وهڪرو
سڀ APIs هيٺ ميزباني ڪيل آهن https://api.factset.com. تصديق API ڪيز استعمال ڪندي سنڀاليو ويندو آهي، ۽ FactSet جي اندرين رڪنيت جي پراڊڪٽ استعمال ڪندي اختيار سنڀاليو ويندو آهي. API ڪيز استعمال ڪرڻ تي وڌيڪ معلومات لاءِ، مھرباني ڪري دورو ڪريو https://developer.factset.com/authentication.
مهرباني ڪري نوٽ ڪريو ته HTTP درخواست ۽ جواب هيڊر نالن کي HTTP معيار جي مطابق غير حساس سمجهيو وڃي. اها صلاح ڏني وئي آهي ته توهان جي ڪوڊ ۾ هيڊرز جي ڪيس-حساس ميلنگ تي ڀروسو نه ڪيو وڃي.
پيداوار جي استعمال جون هدايتون
DSoTM API
رڪارڊ جمع ڪرائڻ
- ٽرانزيڪشن رڪارڊ جمع ڪرڻ لاء، ھيٺ ڏنل پوائنٽ استعمال ڪريو:
- POST/analytics/dsotm/v1/transactions
درخواست سربراه
- اختيار ڪرڻ
معياري HTTP هيڊر. قدر کي 'بنيادي' فارميٽ استعمال ڪرڻ جي ضرورت آھي. - مواد جو قسم
معياري HTTP هيڊر. قيمت کي ايپليڪيشن/JSON طور بيان ڪرڻ جي ضرورت آهي انهي کي ظاهر ڪرڻ لاءِ ته جسم JSON فارميٽ ۾ آهي.
مشڪلاتون
مسئلو حل ڪرڻ جي معلومات لاءِ، مھرباني ڪري ڏسو سيڪشن 4 جو ڊولپر جي دستور ۽ حوالو.
ورجن اپڊيٽ
نسخي جي واڌاري بابت معلومات ڊولپر جي دستياب ۽ حوالن جي سيڪشن 5 ۾ ڳولهي سگھجي ٿي.
FAQ
- سوال: ٽرانزيڪشن پيغامن جي API جي سڌي اسٽريمنگ جو مقصد ڇا آهي؟
ج: ٽرانزيڪشن ميسيجز API جي سڌي اسٽريمنگ جو مقصد ڪنهن به OMS فراهم ڪندڙ کان واپاري ڊيٽا کي FactSet جي پورٽ فوليو مئنيجمينٽ پليٽ فارم سان ڳنڍڻ آهي پورٽ فوليو جي نگراني، واپاري تخليق، ڪارڪردگي انتساب، ۽ واپسي جي تجزيي لاءِ. - سوال: مان API ڪيز استعمال ڪرڻ بابت وڌيڪ معلومات ڪٿي ڳولي سگهان ٿو؟
ج: API ڪيز استعمال ڪرڻ بابت وڌيڪ معلومات هتي ملي سگهي ٿي https://developer.factset.com/authentication.
Motivation
1997 ۾، FactSet شروع ڪيو پورٽ فوليو تجزيه 1.0، جنهن اينالائيٽڪس جو بنياد وڌو. جلد ئي پوءِ، پورٽ فوليو Analysis 2.0 ٽئين پارٽي وينڊرز کان خطرن جا تجزيا ضم ڪيا، ۽ پوءِ 2004 ۾ فڪسڊ انڪم شامل ڪرڻ لاءِ وڌايو ويو. فيڪٽ سيٽ هاڻي ملٽي اثاثن واري پورٽ فوليو اينالائيٽڪس پراڊڪٽس جو هڪ مضبوط سوٽ پيش ڪري ٿو جيڪي مارڪيٽ کي لچڪ، تجزياتي ۽ وسعت ۾ اڳواڻي ڪن ٿا. اڄ، ڪلائنٽ مختلف پراڊڪٽس، جهڙوڪ پورٽ فوليو تجزياتي (PA)، SPAR، الفا ٽيسٽنگ، آپٽمائزرز، ۽ پورٽ فوليو ڊيش بورڊ، ۽ گڏوگڏ پورٽ فوليو بيچر، پبلشر فليٽ ذريعي اينالائيٽڪس جي ورهاست، انٽرايڪٽو اينالائيٽڪس لاءِ FactSet تي ڀاڙين ٿا. Files، ۽ پبلشر دستاويز.
API پروگرام
مٿانview
ڪلائنٽ هڪ ڪسٽم حل جي تعمير جي طرف وڌي رهيا آهن، هڪ واحد صارف جي تجربي ۾ معلومات کي گڏ ڪندي پيداوار کي وڌائڻ جي ضرورت جي ذريعي. APIs ذريعي اينالائيٽڪس، ڪارڪردگي، ۽ خطري کي بي نقاب ڪرڻ سان، اهو توهان کي FactSet جي معروف ملٽي اثاثن جي تجزين سان لهه وچڙ ڪرڻ لاءِ هڪ نفيس چينل فراهم ڪري ٿو. جيئن مارڪيٽ وڌيڪ شفافيت ۽ ڊيٽا جي طلب جاري رکي ٿي، فيڪٽ سيٽ انهن مطالبن کي پورو ڪرڻ لاءِ لچڪدار آپشن فراهم ڪندو. APIs موجوده تجزياتي سوٽ جي پيشڪش کي مڪمل ڪن ٿا ۽ شراڪت کي آسان بڻائين ٿا توهان کي نجي تجربو ٺاهڻ جي اجازت ڏئي، ٽئين پارٽي BI ٽولز سان ضم ڪرڻ جهڙوڪ ٽيبلائو، ۽ ٽئين پارٽي اسٽيٽ پيڪيجز جهڙوڪ RStudio، ۽ FactSet کان اينالائيٽڪس جي اندروني استعمال تي ڪنٽرول وڌائڻ.
پهريون نالو ايسtagتجزياتي APIs کي بي نقاب ڪرڻ جو اي پورٽ فوليو اينالائيٽڪس انجڻ تي ڌيان ڏيندو. ان جي شروعات کان وٺي، پروگرام وڌايو ويو آهي ٻين تجزياتي انجڻ، پروڊڪٽس، ۽ APIs شامل ڪرڻ لاء ٻين ڪاروباري يونٽن مان.
پروگرام هيٺ ڏنل مهيا ڪري ٿو:
- تصور جي ثبوت ٺاهڻ لاء ڊولپر ٽول ڪٽ
- FactSet جي سڀني انٽرنيشنل-اسڪيل APIs ۾ يونيفارم محسوس ڪريو
- صنعت جي معيار جي تعميل
- ورزن ٿيل APIs
- ڊولپر پورٽل تي وسيع دستاويز ۽ سبق
ٽرانزيڪشن ميسيجز API جو سڌو وهڪرو
- ڪنهن به OMS فراهم ڪندڙ کان رڪارڊ ڳنڍيو توهان جي واپاري ڊيٽا کي FactSet جي حقيقي وقت پورٽ فوليو مئنيجمينٽ پليٽ فارم (PMP) سان پورٽ فوليو جي نگراني ۽ واپار جي تخليق لاءِ، يا استعمال ڪيو وڃي طاقتور پورٽ فوليو تجزياتي انجڻ فار پرفارمنس انتساب ۽ واپسي جي تجزيي لاءِ.
- سڀ APIs هيٺ ميزباني ڪيل آهن https://api.factset.com. تصديق API ڪيز استعمال ڪندي سنڀاليو وڃي ٿو ۽ اختيار سنڀاليو وڃي ٿو FactSet جي اندرين رڪنيت جي پراڊڪٽ استعمال ڪندي. توهان API ڪيز استعمال ڪرڻ بابت وڌيڪ معلومات حاصل ڪري سگهو ٿا https://developer.factset.com/authentication.
HTTP جي درخواست ۽ جواب هيڊر نالن کي HTTP معيار جي مطابق ڪيس غير حساس سمجهيو وڃي. مھرباني ڪري پنھنجي ڪوڊ ۾ ھيڊرن جي ڪيس-حساس ميلنگ تي ڀروسو نه ڪريو.
رڪارڊ جمع ڪرائڻ
ٽرانزيڪشن جمع ڪريو
POST/analytics/dsotm/v1/transactions
هي آخري پوائنٽ ٽرانزيڪشن رڪارڊ قبول ڪري ٿو ۽ ان سان گڏ انهن کي مخصوص پورٽ فوليو جي OMS_OFDB ڏانهن لکي ٿو ۽ انهن کي PMP ايپليڪيشن ۾ دستياب ڪري ٿو.
درخواست سربراه
| مٿو نالو | وصف |
| اختيار ڪرڻ | معياري HTTP هيڊر. قدر استعمال ڪرڻ جي ضرورت آهي 'بنيادي فارميٽ. |
| مواد-قسم | معياري HTTP هيڊر. قدر کي ايپليڪيشن/JSON جي وضاحت ڪرڻ جي ضرورت آهي (يعني، ڪال ڪندڙ کي بيان ڪرڻ جي ضرورت آهي ته جسم JSON فارميٽ ۾ آهي). |
درخواست جسم
درخواست جو ادارو حساب ڪتاب جي ماپن جو مجموعو قبول ڪري ٿو. پيرا ميٽر هيٺ بيان ڪيا ويا آهن:
| پيٽرولر جو نالو | ڊيٽا جو قسم | گھربل | وصف | فارميٽ |
| ڦاسي | صفا | نه | عملدرآمد رڪارڊ جي فهرست | تفصيلي رڪارڊ فيلڊ موجود آهن هتي |
| مقرريون | صفا | نه | جڳھ جي رڪارڊ جي فهرست | تفصيلي رڪارڊ فيلڊ موجود آهن هتي |
| حڪم | صفا | نه | آرڊر جي رڪارڊ جي فهرست | تفصيلي رڪارڊ فيلڊ موجود آهن هتي |
جوابي هيڊرز
| مٿو نالو | وصف |
| X-DataDirect-درخواست-چاٻي | FactSet جي درخواست اهم هيڊر. |
| X-FactSet-Api-Request-Key | هڪ تجزياتي API درخواست کي منفرد طور سڃاڻڻ لاءِ ڪنجي. صرف ڪامياب تصديق کان پوء دستياب آهي. |
| X-FactSet-Api-RateLimit-Limit | ٽائيم ونڊو لاءِ اجازت ڏنل درخواستن جو تعداد. |
| X-FactSet-Api-RateLimit-باقي | ٽائيم ونڊو لاءِ ڇڏيل درخواستن جو تعداد. |
| X-FactSet-Api-RateLimit-Reset | ريٽ جي حد ري سيٽ ٿيڻ تائين باقي سيڪنڊن جو تعداد. |
واپسي
| HTTP اسٽيٽس ڪوڊ | وصف |
| 202 | متوقع جواب. |
| 400 | غلط پوسٽ باڊي. |
| 401 | غائب يا غلط تصديق. |
| 403 | استعمال ڪندڙ کي موجوده سند سان منع ٿيل آهي. |
| 415 | غائب/غلط مواد جو قسم هيڊر. هيڊر کي ايپليڪيشن/json تي سيٽ ڪرڻ جي ضرورت آهي. |
| 429 | شرح جي حد تائين پهچي ويو. درخواستن جي ٻيهر ڪوشش ڪريو انتظار ڪرڻ کان پوءِ ٻيهر ڪوشش-پوءِ هيڊر ۾ بيان ڪيل وقت. |
| 500 | سرور جي غلطي. لاگ ان ڪريو X-DataDirect-Request-Key هيڊر مسئلو حل ڪرڻ ۾ مدد لاءِ. |
| 503 | درخواست جو وقت ختم ٿي ويو. ڪجهه وقت ۾ درخواست جي ٻيهر ڪوشش ڪريو. |
ريمارڪس
وڌ ۾ وڌ 50 پوسٽ درخواستن جي اجازت 5-سيڪنڊ ونڊو ۾ هر API لاءِ. ساڳيو ئي تصديق ڪري سگهجي ٿو مختلف شرح-حد هيڊر استعمال ڪندي API جواب ۾ دستياب.
- X-FactSet-Api-RateLimit-Limit - ٽائيم ونڊو لاءِ اجازت ڏنل درخواستن جو تعداد.
- X-FactSet-Api-RateLimit-Remaining - وقت ونڊو لاءِ ڇڏيل درخواستن جو تعداد.
- X-FactSet-Api-RateLimit-Reset - ريٽ جي حد ري سيٽ ٿيڻ تائين باقي سيڪنڊن جو تعداد.
Examples
درخواست:
پوسٽ https://api.factset.com/analytics/dsotm/v1/transactions.
هيڊر:
- مواد جو قسم: اپليڪيشن/json
- اختيار ڏيڻ: بنيادي RkRTX0RFTU9fVVMt ****************************
- قبول-انڪوڊنگ: جي زپ
- مواد جي ڊيگهه: 201
جسم:
جواب:
HTTP 202 قبول ٿيل
هيڊر:
- x-data direct-request-key: zpdo6aebv58fiaoi
- x-factset-api-request-key: 6p2d41m4sw1yfh0h
رڪارڊ جا ميدان
عمل جي تخليق
| عنصر | قسم | وصف | لازمي |
| پورٽ فوليو | تار | پورٽ فوليو جو نالو. مثال طور: ڪلائنٽ:/DEMO.OFDB | ها |
| ٽرانزيڪشن-id | تار | ٽرانزيڪشن لاءِ منفرد ID | ها |
| علامت | تار | واپار ٿيل اوزار سان لاڳاپيل علامت. مثال طور: AAPL | ها |
| وضاحت | تار | عام طور تي هڪ نالو، مثال طور: FACTSET RESEARCH SYSTEMS، پر ٿي سگهي ٿو وڌيڪ تشريح ڪندڙ نڪتن لاءِ. | ها |
| واپار جو قسم | تار | BL (خريد لانگ)، BC (خريد ڪرڻ لاءِ ڍڪ)، SL (وڪڙو لانگ) ۽ ايس ايس (مختصر وڪرو) | ها |
| حيثيت | تار | ACCT يا CNCL، ACCOUNTED ۽ CANCELED لاءِ مختصر | ها |
| واپار جي تاريخ | تار | واپار جي تاريخ جيڪا فارميٽ ۾ آهي YYYYMMDD | ها |
| ٽرانزيڪشن پنن | فلوٽ | حصص جيڪي حڪم ڪيا ويا آهن ۽ عمل نه ڪيا ويا آهن | نه |
| رقم | فلوٽ | واپار جي اوزار جو مقدار | ها |
| net | فلوٽ | ٽرانزيڪشن جي نقد قيمت، بروکرج جي قيمتن جو خالص. | ها |
| مجموعي | فلوٽ | ٽرانزيڪشن جي نقد قيمت، بروکرج جي قيمتن سميت. | ها |
| آبادي جو قدر | فلوٽ | ٽرانزيڪشن جي نقد قيمت هڪ قدر آهي جيڪا مقامي ڪرنسي ۾ بک ڪيل ٽرانزيڪشن کي رپورٽنگ ڪرنسي ۾ تبديل ڪرڻ لاءِ لاڳو ڪيل FX جي شرح سان ضرب ڪئي وئي آهي. | ها |
| آبادڪاري جي تاريخ | تار | آبادي جي تاريخ YYYYMMDD فارميٽ ۾ | ها |
| ڪرنسي | تار | ڪرنسي ڪوڊ آف ڪيش ويلڊ فيلڊز، خالص رقم ۽ مجموعي رقم. | ها |
| پرڏيهي مٽا سٽا جي شرح | فلوٽ | FX جي شرح جيڪا PA پاران کڻي سگھجي ٿي، نقد قيمتي شعبن سان ضرب، نيٽ، مجموعي، PA کي رپورٽنگ ڪرنسي ۾ ٽرانزيڪشن ڏيکارڻ جي اجازت ڏيڻ لاءِ. | نه |
| آبادي جي ڪرنسي iso | تار | ڪرنسي ڪوڊ سيٽلمينٽ ويليو لاءِ | ها |
| حڪم ڏنو | تار | آرڊر جو منفرد سڃاڻپ ڪندڙ PM Hub پاران مهيا ڪيل آهي. مثال طور: O_FDS_010623_1686393260254 | نه |
| والدين جي سڃاڻپ | تار | OMS پاران مهيا ڪيل والدين آرڊر جو منفرد سڃاڻپ ڪندڙ. | نه |
آرڊر ٺاهڻ
| عنصر | قسم | وصف | لازمي |
| پورٽ فوليو | تار | پورٽ فوليو جو نالو. مثال طور: ڪلائنٽ:/DEMO.OFDB | ها |
| ٽرانزيڪشن-id | تار | ٽرانزيڪشن لاءِ منفرد ID | ها |
| علامت | تار | واپار ٿيل اوزار سان لاڳاپيل علامت. مثال طور: AAPL | ها |
| وضاحت | تار | عام طور تي هڪ نالو، مثال طور: FACTSET RESEARCH SYSTEMS، پر ٿي سگهي ٿو وڌيڪ تشريح ڪندڙ نڪتن لاءِ. | ها |
| واپار جو قسم | تار | BL (خريد لانگ)، BC (خريد ڪرڻ لاءِ ڍڪ)، SL (وڪڙو لانگ) ۽ ايس ايس (مختصر وڪرو) | ها |
| حيثيت | تار | ACCT يا CNCL، ACCOUNTED ۽ CANCELED لاءِ مختصر | ها |
| واپار جي تاريخ | تار | واپار جي تاريخ جيڪا فارميٽ ۾ آهي YYYYMMDD | ها |
| ٽرانزيڪشن-پتي | فلوٽ | حصص جيڪي حڪم ڪيا ويا آهن پر عمل نه ڪيو ويو آهي | نه |
| رقم | فلوٽ | واپار جي اوزار جو مقدار | ها |
| ڪرنسي iso | تار | ڪرنسي ڪوڊ آف ڪيش ويلڊ فيلڊز، خالص رقم ۽ مجموعي رقم. | ها |
| پرڏيهي مٽا سٽا جي شرح | فلوٽ | FX جي شرح جيڪا PA پاران کڻي سگھجي ٿي، نقد قيمتي شعبن سان ضرب، نيٽ، مجموعي، PA کي رپورٽنگ ڪرنسي ۾ ٽرانزيڪشن ڏيکارڻ جي اجازت ڏيڻ لاءِ. | نه |
| آرڊر جي سڃاڻپ | تار | آرڊر جو منفرد سڃاڻپ ڪندڙ PM Hub پاران مهيا ڪيل آهي. مثال طور: O_FDS_010623_1686393260254 | نه |
جڳھ جي ٺاھ جوڙ
| عنصر | قسم | وصف | لازمي |
| پورٽ فوليو | تار | پورٽ فوليو جو نالو. مثال طور: ڪلائنٽ:/DEMO.OFDB | ها |
| ٽرانزيڪشن-id | تار | ٽرانزيڪشن لاءِ منفرد ID | ها |
| علامت | تار | واپار ٿيل اوزار سان لاڳاپيل علامت. مثال طور: AAPL | ها |
| وضاحت | تار | عام طور تي هڪ نالو، مثال طور: FACTSET RESEARCH SYSTEMS، پر ٿي سگهي ٿو وڌيڪ تشريح ڪندڙ نڪتن لاءِ. | ها |
| واپار جو قسم | تار | BL (خريد لانگ)، BC (خريد ڪرڻ لاءِ ڍڪ)، SL (وڪڙو لانگ) ۽ ايس ايس (مختصر وڪرو) | ها |
| حيثيت | تار | ACCT يا CNCL، ACCOUNTED ۽ CANCELED لاءِ مختصر | ها |
| واپار جي تاريخ | تار | واپار جي تاريخ جيڪا فارميٽ ۾ آهي YYYYMMDD | ها |
| ٽرانزيڪشن-پتي | فلوٽ | حصص جيڪي حڪم ڪيا ويا آهن پر عمل نه ڪيو ويو آهي | نه |
| رقم | فلوٽ | واپار جي اوزار جو مقدار | ها |
| ڪرنسي iso | تار | ڪرنسي ڪوڊ آف ڪيش ويلڊ فيلڊز، خالص رقم ۽ مجموعي رقم. | ها |
| پرڏيهي مٽا سٽا جي شرح | فلوٽ | FX جي شرح جيڪا PA پاران کڻي سگھجي ٿي، نقد قيمتي شعبن سان ضرب، نيٽ، مجموعي، PA کي رپورٽنگ ڪرنسي ۾ ٽرانزيڪشن ڏيکارڻ جي اجازت ڏيڻ لاءِ. | نه |
| آبادي جي ڪرنسي iso | تار | ڪرنسي ڪوڊ سيٽلمينٽ ويليو لاءِ | ها |
| آرڊر جي سڃاڻپ | تار | آرڊر جو منفرد سڃاڻپ ڪندڙ PM Hub پاران مهيا ڪيل آهي. مثال طور: O_FDS_010623_1686393260254 | نه |
| والدين جي سڃاڻپ | تار | OMS پاران مهيا ڪيل والدين آرڊر جو منفرد سڃاڻپ ڪندڙ. | نه |
مشڪلاتون
ھيٺ ڏنل قدمن جي سفارش ڪئي وئي آھي نقصن کي حل ڪرڻ لاءِ مختلف APIs مان:
- رڪارڊ ڪريو X-DataDirect-Request-Key جوابي هيڊر ته جيئن FactSet جي API انجنيئرنگ ٽيم توهان جي مخصوص درخواست/جواب جو تجزيو ڪري سگهي.
- جوابي جسم کي رڪارڊ ڪريو جڏهن جواب هڪ غلطي جو جواب آهي. سڀ HTTP اسٽيٽس ڪوڊس 400 جي برابر ۽ ان کان وڌيڪ سمجھيا ويندا آھن نقص جواب.
- مدد لاءِ مٿي ڏنل معلومات سان گڏ پنهنجي اڪائونٽ ٽيم سان رابطو ڪريو.
ورجن اپڊيٽ
- FactSet هڪ محدود وقت لاءِ پراڻي API ورزن کي سپورٽ ڪندو. اصل سپورٽ وقت API ۽ ڇڏڻ تي منحصر هوندوtagاي (يعني، بيٽا يا پيداوار). سڀ ٽوڙڻ واريون تبديليون، ڪارڪردگي ۾ اضافو، ۽ اڳئين ورزن ۾ بگ فيڪسز کي چينج لاگ ۾ دستاويز ڪيو ويندو.
- FactSet جي API انجنيئرنگ ٽيم ڪلائنٽ سان گڏ ڪم ڪندي ته جيئن نئين ورزن تائين آسان منتقلي کي يقيني بڻائي سگهجي.
ڪاپي رائيٽ © 2023 FactSet Research Systems Inc. سڀ حق محفوظ آهن.
FactSet Research Systems Inc. | www.factset.com.
دستاويز / وسيلا
 |
FACTSET سڌو اسٽريمنگ آف ٽرانزيڪشن ميسيجز API سافٽ ويئر [pdf] استعمال ڪندڙ ھدايت نسخو 1.0، ٽرانزيڪشن پيغامن جو سڌو وهڪرو API سافٽ ويئر، ٽرانزيڪشن پيغامن جي اسٽريمنگ API سافٽ ويئر، ٽرانزيڪشن پيغام API سافٽ ويئر، پيغام API سافٽ ويئر، API سافٽ ويئر، سافٽ ويئر |