FACTSET Transaction Messages API бағдарламалық құралының тікелей ағыны
Өнім туралы ақпарат
Техникалық сипаттамалар
- Өнім атауы: Transaction Messages API тікелей ағыны
- Нұсқа: 1.0
- Әзірлеуші нұсқаулығы және анықтама күні: 2023 жылдың тамызы
Мотивация
Transaction Messages API тікелей ағынының мотивациясы кез келген OMS провайдерінен жазбаларды қосу жолын қамтамасыз ету және портфельді бақылау, сауданы модельдеу, өнімділік атрибуциясы және қайтарымды талдау үшін FactSet нақты уақыттағы Портфолионы басқару платформасымен (PMP) сауда деректерін біріктіру болып табылады. .
API бағдарламасы
Біттіview
API бағдарламасы бастапқыда портфолионың аналитикалық механизміне назар аударады және әртүрлі бизнес бөлімшелерінің басқа аналитикалық қозғалтқыштарын, өнімдерін және API интерфейстерін қамту үшін кеңейтілді.
Бағдарлама мыналарды қамтамасыз етеді:
- Transaction Messages API тікелей ағыны
Барлық API интерфейстері астында орналастырылған https://api.factset.com. Аутентификация API кілттері арқылы өңделеді, ал авторизация FactSet компаниясының ішкі жазылымдар өнімі арқылы өңделеді. API кілттерін пайдалану туралы қосымша ақпарат алу үшін мына сайтқа кіріңіз https://developer.factset.com/authentication.
HTTP стандартына сәйкес HTTP сұрауы мен жауап тақырыбының атаулары регистрді ескермейтінін ескеріңіз. Кодыңыздағы тақырыптардың регистрге сезімтал сәйкестігіне сенбеу ұсынылады.
Өнімді пайдалану нұсқаулары
DSoTM API
Жазбаларды жіберу
- Транзакция жазбаларын жіберу үшін келесі соңғы нүктені пайдаланыңыз:
- POST /analytics/dsotm/v1/транзакциялар
Тақырыптарды сұрау
- Авторизация
Стандартты HTTP тақырыбы. Мән «Негізгі» пішімін пайдалануы керек. - Мазмұн түрі
Стандартты HTTP тақырыбы. Дененің JSON пішімінде екенін көрсету үшін мән қолданба/JSON ретінде көрсетілуі керек.
Ақаулықтарды жою
Ақаулықтарды жою туралы ақпаратты Әзірлеуші нұсқаулығы мен анықтамасының 4 бөлімінен қараңыз.
Нұсқаны жаңарту
Нұсқа жаңартулары туралы ақпаратты Әзірлеуші нұсқаулығы мен анықтамасының 5-бөлімінен табуға болады.
Жиі қойылатын сұрақтар
- С: Transaction Messages API тікелей ағынының мақсаты қандай?
A: Transaction Messages API тікелей ағынының мақсаты портфельді қадағалау, сауданы модельдеу, өнімділік атрибуциясы және қайтарымды талдау үшін кез келген OMS провайдерінен FactSet портфолиосын басқару платформасымен сауда деректерін қосу болып табылады. - С: API кілттерін пайдалану туралы қосымша ақпаратты қайдан табуға болады?
A: API кілттерін пайдалану туралы қосымша ақпаратты мына жерден табуға болады https://developer.factset.com/authentication.
Мотивация
1997 жылы FactSet Analytics негізін қалаған Portfolio Analysis 1.0 нұсқасын іске қосты. Көп ұзамай Portfolio Analysis 2.0 үшінші тарап жеткізушілерінің тәуекелдік талдауын біріктірді, содан кейін 2004 жылы Тұрақты кірісті қамту үшін кеңейтілді. Қазір FactSet икемділік, аналитика және кеңдікте нарықты басқаратын көп активті портфельдік талдау өнімдерінің сенімді жиынтығын ұсынады. Бүгінгі күні клиенттер портфолио талдауы (PA), SPAR, альфа тестілеу, оңтайландырушылар және портфолио бақылау тақтасы, сондай-ақ Portfolio Batcher, Publisher Flat арқылы аналитиканы тарату сияқты әртүрлі өнімдер арқылы интерактивті аналитика үшін FactSet-ке сенеді. Files және Publisher құжаттары.
API бағдарламасы
Біттіview
Клиенттер ақпаратты бір пайдаланушы тәжірибесіне біріктіру арқылы өнімділікті арттыру қажеттілігінен туындаған реттелетін шешімді құруға көшті. API арқылы аналитиканы, өнімділікті және тәуекелді көрсету арқылы ол сізге FactSet жетекші көп активті аналитикасымен әрекеттесу үшін күрделі арнаны ұсынады. Нарық ашықтық пен деректерді талап етуді жалғастыруда, FactSet осы талаптарды қанағаттандыру үшін икемді опцияларды ұсынады. API интерфейстері жеке тәжірибелерді құруға, Tableau сияқты үшінші тараптың BI құралдарымен және RStudio сияқты үшінші тарап статистикалық пакеттерімен біріктіруге және FactSet аналитикасының ішкі тұтынуын бақылауды арттыруға мүмкіндік беру арқылы ағымдағы аналитикалық жинақ ұсыныстарын толықтырады және серіктестіктерді жеңілдетеді.
Бірінші сtagAnalytics API интерфейстерін көрсету портфолио аналитикалық механизміне назар аударады. Өзінің құрылған күнінен бастап бағдарлама басқа бизнес бөлімшелерінің басқа аналитикалық қозғалтқыштарын, өнімдерін және API интерфейстерін қамту үшін кеңейді.
Бағдарлама мыналарды қамтамасыз етеді:
- Тұжырымдаманы дәлелдеуге арналған әзірлеуші құралдар жинағы
- FactSet-тің барлық корпоративтік API интерфейстерінде біркелкі сезім
- Салалық стандарттарды сақтау
- Нұсқаланған API интерфейстері
- Әзірлеуші порталындағы ауқымды құжаттама және оқулықтар
Transaction Messages API тікелей ағыны
- Сауда деректерін портфельді қадағалау және сауданы модельдеу үшін FactSet нақты уақыттағы портфолио басқару платформасымен (PMP) біріктіру үшін немесе өнімділік атрибуциясы мен қайтарымды талдауға арналған қуатты Портфолио аналитикалық жүйесінде пайдалану үшін кез келген OMS провайдерінен жазбаларды қосыңыз.
- Барлық API интерфейстері астында орналастырылған https://api.factset.com. Аутентификация API кілттері арқылы өңделеді және авторизация FactSet компаниясының ішкі жазылымдар өнімі арқылы өңделеді. API кілттерін пайдалану туралы қосымша ақпаратты мына жерден таба аласыз https://developer.factset.com/authentication.
HTTP сұрауы мен жауап тақырыбының атаулары HTTP стандартына сәйкес регистрді ескермейді. Кодыңыздағы тақырыптардың регистрге сезімтал сәйкестігіне сенбеңіз.
Жазбаларды жіберу
Транзакцияларды жіберу
POST /analytics/dsotm/v1/транзакциялар
Бұл соңғы нүкте транзакция жазбаларын қабылдайды және оларды бір уақытта көрсетілген портфолионың OMS_OFDB ішіне жазады және оларды PMP қолданбасында қолжетімді етеді.
Тақырыптарды сұрау
| Тақырып атауы | Сипаттама |
| Авторизация | Стандартты HTTP тақырыбы. Мән 'Негізгі пішімі. |
| Мазмұны-Түр | Стандартты HTTP тақырыбы. Мән қолданбаны/JSON-ды көрсетуі керек (яғни, қоңырау шалушы негізгі мәтіннің JSON пішімінде екенін көрсетуі керек). |
Сұраныс органы
Сұрау органы есептеу параметрлерінің жинағын қабылдайды. Параметрлер төменде сипатталған:
| Параметр аты | Деректер түрі | Міндетті | Сипаттама | Формат |
| өлім жазасы | Массив | Жоқ | Орындау жазбаларының тізімі | Егжей-тегжейлі жазба өрістері осында қол жетімді |
| орналастырулар | Массив | Жоқ | Орналастыру жазбаларының тізімі | Егжей-тегжейлі жазба өрістері осында қол жетімді |
| тапсырыстар | Массив | Жоқ | Тапсырыс жазбаларының тізімі | Егжей-тегжейлі жазба өрістері осында қол жетімді |
Жауап тақырыптары
| Тақырып атауы | Сипаттама |
| X-DataDirect-Сұраныс-Кілт | FactSet сұрау кілтінің тақырыбы. |
| X-FactSet-Api-сұраныс-кілт | Analytics API сұрауын бірегей анықтау кілті. Сәтті аутентификациядан кейін ғана қолжетімді. |
| X-FactSet-Api-RateLimit-Limit | Уақыт терезесі үшін рұқсат етілген сұраулар саны. |
| X-FactSet-Api-RateLimit-қалған | Уақыт терезесіне қалдырылған сұраулар саны. |
| X-FactSet-Api-RateLimit-қалпына келтіру | Жылдамдық шегі қалпына келтірілгенге дейін қалған секундтар саны. |
Қайтарады
| HTTP күй коды | Сипаттама |
| 202 | Күтілетін жауап. |
| 400 | Жарамсыз POST мәтіні. |
| 401 | Аутентификация жоқ немесе жарамсыз. |
| 403 | Пайдаланушыға ағымдағы тіркелгі деректерімен тыйым салынған. |
| 415 | Мазмұн түрі тақырыбы жоқ/жарамсыз. Тақырып қолданба/json параметріне орнатылуы керек. |
| 429 | Тарифтің шегіне жетті. Қайталаудан кейін тақырыпта көрсетілген уақытты күткеннен кейін сұрауларды қайталап көріңіз. |
| 500 | Сервер қатесі. Ақаулықтарды жоюға көмектесу үшін X-DataDirect-Request-Key тақырыбына кіріңіз. |
| 503 | Сұрау уақыты аяқталды. Біраз уақыттан кейін сұрауды қайталап көріңіз. |
Ескертулер
Әрбір API үшін 50 секундтық терезеде рұқсат етілген ең көбі 5 POST сұрауы. Дәл осыны API жауапында қолжетімді Rate-Limit әртүрлі тақырыптары арқылы тексеруге болады.
- X-FactSet-Api-RateLimit-Limit – уақыт терезесі үшін рұқсат етілген сұраулар саны.
- X-FactSet-Api-RateLimit-Remaining – Уақыт терезесі үшін қалған сұраулар саны.
- X-FactSet-Api-RateLimit-Reset – жылдамдық шегі қалпына келтірілгенге дейін қалған секундтар саны.
Examples
Сұраныс:
POST https://api.factset.com/analytics/dsotm/v1/transactions.
Тақырыптар:
- мазмұн түрі: application/json
- Авторизация: Негізгі RkRTX0RFTU9fVVMt********************************
- Қабылдау-кодтау: gzip
- мазмұн ұзындығы: 201
Дене:
Жауап:
HTTP 202 қабылданған
Тақырыптар:
- x-деректерді тікелей сұрау кілті: zpdo6aebv58fiaoi
- x-factset-api-request-key: 6p2d41m4sw1yfh0h
Жазба өрістері
Орындауды құру
| Элемент | Түр | Сипаттама | Міндетті |
| портфолио | Жол | Портфолио атауы. Мысалы: КЛИЕНТ:/DEMO.OFDB | ИӘ |
| транзакция идентификаторы | Жол | Транзакция үшін бірегей идентификатор | ИӘ |
| символы | Жол | Сауда-саттық құралына сәйкес таңба. Мысалы: AAPL | ИӘ |
| сипаттамасы | Жол | Әдетте атау, мысалы: FACTSET RESEARCH SYSTEMS, бірақ туынды құралдар үшін көбірек сипаттама болуы мүмкін. | ИӘ |
| сауда түрі | Жол | BL (ұзақ сатып алу), BC (жабу үшін сатып алу), SL (ұзақ сату) және SS (қысқа сату) | ИӘ |
| күй | Жол | ACCT немесе CNCL, ACCOUNTED және CANCELED дегеннің қысқасы | ИӘ |
| сауда күні | Жол | YYYYMMDD пішіміндегі сауда күні | ИӘ |
| транзакция қалдырады | Float | Тапсырыс берілген және орындалмаған акциялар | ЖОҚ |
| сомасы | Float | Саудаланған құралдың саны | ИӘ |
| тор | Float | Мәміленің ақшалай құны, делдалдық шығындарды шегергенде. | ИӘ |
| өрескел | Float | Мәміленің ақшалай құны, соның ішінде делдалдық шығындар. | ИӘ |
| есеп айырысу құны | Float | Транзакцияның ақшалай құны жергілікті валютада брондалған транзакцияны есеп беру валютасына айырбастау үшін қолданыстағы валюта бағамына көбейтілген мән болып табылады. | ИӘ |
| есеп айырысу күні | Жол | ЖЖЖЖММЖ форматында есеп айырысу күні | ИӘ |
| валюта | Жол | Қолма-қол ақшамен бағаланған өрістердің валюта коды, таза сома және жалпы сома. | ИӘ |
| шетел валютасының бағамы | Float | PA алуға болатын валюта бағамы, PA есеп валютасында транзакцияларды көрсетуге мүмкіндік беру үшін қолма-қол бағаланған өрістерге, таза, жалпыға көбейтіледі. | ЖОҚ |
| есеп айырысу валютасы iso | Жол | Есеп айырысу құнына арналған валюта коды | ИӘ |
| тапсырыс берді | Жол | Тапсырыстың бірегей идентификаторын PM Hub қамтамасыз етеді. Мысалы: O_FDS_010623_1686393260254 | ЖОҚ |
| ата-ана идентификаторы | Жол | OMS қамтамасыз ететін негізгі тапсырыстың бірегей идентификаторы. | ЖОҚ |
Тапсырысты құру
| Элемент | Түр | Сипаттама | Міндетті |
| портфолио | Жол | Портфолио атауы. Мысалы: КЛИЕНТ:/DEMO.OFDB | ИӘ |
| транзакция идентификаторы | Жол | Транзакция үшін бірегей идентификатор | ИӘ |
| символы | Жол | Сауда-саттық құралына сәйкес таңба. Мысалы: AAPL | ИӘ |
| сипаттамасы | Жол | Әдетте атау, мысалы: FACTSET RESEARCH SYSTEMS, бірақ туынды құралдар үшін көбірек сипаттама болуы мүмкін. | ИӘ |
| сауда түрі | Жол | BL (ұзақ сатып алу), BC (жабу үшін сатып алу), SL (ұзақ сату) және SS (қысқа сату) | ИӘ |
| күй | Жол | ACCT немесе CNCL, ACCOUNTED және CANCELED дегеннің қысқасы | ИӘ |
| сауда күні | Жол | YYYYMMDD пішіміндегі сауда күні | ИӘ |
| транзакциялық парақтар | Float | Тапсырыс берілген, бірақ орындалмаған акциялар | ЖОҚ |
| сомасы | Float | Саудаланған құралдың саны | ИӘ |
| валюталық изо | Жол | Қолма-қол ақшамен бағаланған өрістердің валюта коды, таза сома және жалпы сома. | ИӘ |
| шетел валютасының бағамы | Float | PA алуға болатын валюта бағамы, PA есеп валютасында транзакцияларды көрсетуге мүмкіндік беру үшін қолма-қол бағаланған өрістерге, таза, жалпыға көбейтіледі. | ЖОҚ |
| тапсырыс идентификаторы | Жол | Тапсырыстың бірегей идентификаторын PM Hub қамтамасыз етеді. Мысалы: O_FDS_010623_1686393260254 | ЖОҚ |
Орналастыруды құру
| Элемент | Түр | Сипаттама | Міндетті |
| портфолио | Жол | Портфолио атауы. Мысалы: КЛИЕНТ:/DEMO.OFDB | ИӘ |
| транзакция идентификаторы | Жол | Транзакция үшін бірегей идентификатор | ИӘ |
| символы | Жол | Сауда-саттық құралына сәйкес таңба. Мысалы: AAPL | ИӘ |
| сипаттамасы | Жол | Әдетте атау, мысалы: FACTSET RESEARCH SYSTEMS, бірақ туынды құралдар үшін көбірек сипаттама болуы мүмкін. | ИӘ |
| сауда түрі | Жол | BL (ұзақ сатып алу), BC (жабу үшін сатып алу), SL (ұзақ сату) және SS (қысқа сату) | ИӘ |
| күй | Жол | ACCT немесе CNCL, ACCOUNTED және CANCELED дегеннің қысқасы | ИӘ |
| сауда күні | Жол | YYYYMMDD пішіміндегі сауда күні | ИӘ |
| транзакциялық парақтар | Float | Тапсырыс берілген, бірақ орындалмаған акциялар | ЖОҚ |
| сомасы | Float | Саудаланған құралдың саны | ИӘ |
| валюталық изо | Жол | Қолма-қол ақшамен бағаланған өрістердің валюта коды, таза сома және жалпы сома. | ИӘ |
| шетел валютасының бағамы | Float | PA алуға болатын валюта бағамы, PA есеп валютасында транзакцияларды көрсетуге мүмкіндік беру үшін қолма-қол бағаланған өрістерге, таза, жалпыға көбейтіледі. | ЖОҚ |
| есеп айырысу валютасы iso | Жол | Есеп айырысу құнына арналған валюта коды | ИӘ |
| тапсырыс идентификаторы | Жол | Тапсырыстың бірегей идентификаторын PM Hub қамтамасыз етеді. Мысалы: O_FDS_010623_1686393260254 | ЖОҚ |
| ата-ана идентификаторы | Жол | OMS қамтамасыз ететін негізгі тапсырыстың бірегей идентификаторы. | ЖОҚ |
Ақаулықтарды жою
Әр түрлі API интерфейстерінің кез келгеніндегі қателерді жою үшін келесі қадамдар ұсынылады:
- X-DataDirect-Request-Key жауап тақырыбын FactSet API инженерлік тобы нақты сұрауыңызды/жауабыңызды талдай алатындай етіп жазыңыз.
- Жауап қате жауап болған кезде жауап денесін жазыңыз. 400-ге тең және одан жоғары барлық HTTP күй кодтары қате жауаптары болып саналады.
- Көмек алу үшін жоғарыдағы ақпаратпен тіркелгі тобына хабарласыңыз.
Нұсқаны жаңарту
- FactSet шектеулі уақыт ішінде ескі API нұсқаларына қолдау көрсетеді. Нақты қолдау уақыты API және шығарылымға байланысты боладыtage (яғни, бета немесе өндіріс). Бұрынғы нұсқалардағы барлық бұзылған өзгерістер, функционалдық толықтырулар және қателерді түзету өзгерістер журналында құжатталады.
- FactSet API инженерлік тобы жаңа нұсқаларға бірқалыпты өтуді қамтамасыз ету үшін клиенттермен жұмыс істейді.
Copyright © 2023 FactSet Research Systems Inc. Барлық құқықтар қорғалған.
FactSet Research Systems Inc. | www.factset.com.
Құжаттар / Ресурстар
 |
FACTSET Transaction Messages API бағдарламалық құралының тікелей ағыны [pdf] Пайдаланушы нұсқаулығы 1.0 нұсқасы, Transaction Messages API бағдарламалық құралының тікелей ағыны, Transaction Messages API бағдарламалық құралының ағыны, Transaction Messages API бағдарламалық құралы, Messages API бағдарламалық құралы, API бағдарламалық құралы, бағдарламалық құрал |