FACTSET Streaming Dirett Ta' Messaġġi ta' Tranżazzjoni API Software
Informazzjoni dwar il-Prodott
Speċifikazzjonijiet
- Isem tal-Prodott: Streaming Dirett ta' Messaġġi ta' Tranżazzjoni API
- Verżjoni: 1.0
- Manwal tal-Iżviluppatur u Data ta' Referenza: Awwissu 2023
Motivazzjoni
Il-motivazzjoni wara l-API Direct Streaming of Transaction Messages hija li tipprovdi mod biex tikkonnettja r-rekords minn kwalunkwe fornitur tal-OMS u tintegra d-dejta tal-kummerċ mal-Pjattaforma ta’ Ġestjoni tal-Portafoll (PMP) f’ħin reali ta’ FactSet għas-sorveljanza tal-portafoll, simulazzjoni tal-kummerċ, attribuzzjoni tal-prestazzjoni u analiżi tad-dħul. .
Programm API
Fuqview
Il-Programm API inizjalment jiffoka fuq il-magna analitika tal-portafoll u kiber biex jinkludi magni analitiċi, prodotti, u APIs oħra minn unitajiet kummerċjali differenti.
Il-programm jipprovdi dan li ġej:
- Streaming Dirett ta' Messaġġi ta' Tranżazzjoni API
L-APIs kollha huma ospitati taħt https://api.factset.com. L-awtentikazzjoni tiġi ttrattata bl-użu tal-API Keys, u l-awtorizzazzjoni tiġi ttrattata bl-użu tal-prodott ta’ abbonamenti interni ta’ FactSet. Għal aktar informazzjoni dwar l-użu tal-API Keys, jekk jogħġbok żur https://developer.factset.com/authentication.
Jekk jogħġbok innota li l-ismijiet tal-header tat-talba u tar-rispons HTTP għandhom jitqiesu bħala insensittivi għall-każi skont l-istandard HTTP. Huwa rrakkomandat li ma tistrieħx fuq it-tlaqqigħ sensittiv għall-każi tal-headers fil-kodiċi tiegħek.
Istruzzjonijiet għall-Użu tal-Prodott
DSoTM API
Sottomissjoni ta' Rekords
- Biex tissottometti rekords tat-tranżazzjonijiet, uża l-endpoint li ġej:
- POST /analytics/dsotm/v1/transactions
Headers tat-Talbiet
- Awtorizzazzjoni
Header HTTP standard. Il-valur jeħtieġ li juża l-format 'Bażiku'. - Kontenut-Tip
Header HTTP standard. Il-valur jeħtieġ li jiġi speċifikat bħala applikazzjoni/JSON biex jindika li l-korp huwa f'format JSON.
Issolvi l-problemi
Għal informazzjoni dwar is-soluzzjoni tal-problemi, jekk jogħġbok irreferi għat-taqsima 4 tal-Manwal u Referenza tal-Iżviluppatur.
Aġġorna l-Verżjoni
Informazzjoni dwar l-aġġornamenti tal-verżjoni tista 'tinstab fit-taqsima 5 tal-Manwal tal-Iżviluppatur u Referenza.
FAQ
- Q: X'inhu l-iskop tal-Direct Streaming of Transaction Messages API?
A: L-iskop tal-API ta' Streaming Dirett ta' Messaġġi ta' Tranżazzjoni huwa li tgħaqqad id-dejta tal-kummerċ minn kwalunkwe fornitur tal-OMS mal-Pjattaforma ta' Ġestjoni tal-Portafoll ta' FactSet għas-sorveljanza tal-portafoll, simulazzjoni tal-kummerċ, attribuzzjoni tal-prestazzjoni u analiżi tal-qligħ. - Q: Fejn nista' nsib aktar informazzjoni dwar l-użu tal-API Keys?
A: Aktar informazzjoni dwar l-użu ta' API Keys tista' tinstab fuq https://developer.factset.com/authentication.
Motivazzjoni
Fl-1997, FactSet nieda l-Analiżi tal-Portfolio 1.0, li stabbilixxa l-pedament għall-Analytics. Ftit wara, Portfolio Analysis 2.0 integrat analitiċi tar-riskju minn bejjiegħa ta 'partijiet terzi, u mbagħad estiż biex jinkludi Dħul Fiss fl-2004. FactSet issa joffri sett robust ta' prodotti analitiċi ta 'portafoll b'ħafna assi li jwasslu s-suq fil-flessibbiltà, l-analiżi u l-wisa'. Illum, il-klijenti jiddependu fuq FactSet għal analitika interattiva permezz ta’ diversi prodotti, bħall-Analiżi tal-Portfolio (PA), SPAR, Alpha Testing, Optimizers, u Portfolio Dashboard, kif ukoll id-distribuzzjoni tal-analiżi permezz tal-Portfolio Batcher, Publisher Flat Files, u dokumenti tal-Pubblikatur.
Programm API
Fuqview
Il-klijenti ilhom jimxu lejn il-bini ta 'soluzzjoni apposta, immexxija mill-ħtieġa li tiżdied il-produttività billi tikkonsolida l-informazzjoni f'esperjenza ta' utent wieħed. Billi tesponi l-analiżi, il-prestazzjoni u r-riskju permezz tal-APIs, tipprovdilek kanal sofistikat biex jinteraġixxi mal-analitika multi-assi ewlenija ta' FactSet. Hekk kif is-suq ikompli jitlob aktar trasparenza u dejta, FactSet se jipprovdi għażliet flessibbli biex jissodisfaw dawk it-talbiet. L-APIs jikkumplimentaw l-offerti attwali tas-suite tal-analiżi u jiffaċilitaw is-sħubijiet billi jippermettulek tibni esperjenzi privati, tintegra ma’ għodod tal-BI ta’ partijiet terzi bħal Tableau, u pakketti tal-istatistiċi ta’ partijiet terzi bħal RStudio, u żżid il-kontroll fuq il-konsum intern tal-analitiċi minn FactSet.
L-ewwel stagL-espożizzjoni tal-Analytics APIs se tiffoka fuq il-magna analitika tal-portafoll. Mill-bidu tiegħu, il-programm kiber biex jinkludi magni analitiċi, prodotti u APIs oħra minn unitajiet tan-negozju oħra.
Il-programm jipprovdi dan li ġej:
- Toolkit tal-iżviluppatur biex tibni prova tal-kunċett
- Tħossok uniformi fl-APIs kollha ta' FactSet fuq skala ta' intrapriża
- Aderenza mal-istandards tal-industrija
- APIs b'verżjoni
- Dokumentazzjoni estensiva u tutorials fuq il-portal tal-iżviluppatur
Streaming Dirett ta' Messaġġi ta' Tranżazzjoni API
- Qabbad ir-rekords minn kwalunkwe fornitur tal-OMS biex tintegra d-dejta kummerċjali tiegħek mal-Pjattaforma ta' Ġestjoni tal-Portafoll (PMP) f'ħin reali ta' FactSet għas-sorveljanza tal-portafoll u s-simulazzjoni tal-kummerċ, jew biex tintuża fil-Magna Analitika tal-Portafoll b'saħħitha għall-analiżi tal-Attribuzzjoni u l-Prestazzjoni tal-Prestazzjoni.
- L-APIs kollha huma ospitati taħt https://api.factset.com. L-awtentikazzjoni tiġi ttrattata bl-użu ta' API Keys u l-awtorizzazzjoni tiġi ttrattata bl-użu tal-prodott ta' abbonamenti interni ta' FactSet. Tista' ssib aktar informazzjoni dwar l-użu ta' API Keys fuq https://developer.factset.com/authentication.
L-ismijiet tal-header tat-talba u tar-rispons HTTP għandhom jitqiesu bħala insensittivi għall-każi skont l-istandard HTTP. Jekk jogħġbok tistrieħx fuq it-tlaqqigħ sensittiv għall-każi tal-headers fil-kodiċi tiegħek.
Sottomissjoni ta' Rekords
Issottometti Transazzjonijiet
POST /analytics/dsotm/v1/transactions
Dan l-endpoint jaċċetta rekords tat-tranżazzjonijiet u simultanjament jiktebhom fl-OMS_OFDB tal-portafoll speċifikat u jagħmilhom disponibbli fl-applikazzjoni PMP.
Headers tat-Talbiet
| Isem tal-header | Deskrizzjoni |
| Awtorizzazzjoni | Header HTTP standard. Il-valur jeħtieġ li juża l-'Bażiku ' format. |
| Kontenut-Tip | Header HTTP standard. Il-valur jeħtieġ li jispeċifika l-applikazzjoni/JSON (jiġifieri, min iċempel jeħtieġ li jispeċifika li l-korp huwa f'format JSON). |
Korp tat-Talba
Il-korp tat-talba jaċċetta ġabra ta' parametri ta' kalkolu. Il-parametri huma deskritti hawn taħt:
| Isem tal-parametru | Tip ta' dejta | Meħtieġa | Deskrizzjoni | Format |
| eżekuzzjonijiet | Array | Nru | Lista ta' rekords ta' eżekuzzjoni | Oqsma dettaljati tar-rekords huma disponibbli hawn |
| pjazzamenti | Array | Nru | Lista ta' rekords ta' pjazzament | Oqsma dettaljati tar-rekords huma disponibbli hawn |
| ordnijiet | Array | Nru | Lista ta' rekords ta' ordnijiet | Oqsma dettaljati tar-rekords huma disponibbli hawn |
Headers tar-Rispons
| Isem tal-header | Deskrizzjoni |
| X-DataDirect-Talba-Ewlenin | Header taċ-ċavetta tat-talba ta' FactSet. |
| X-FactSet-Api-Request-Key | Ċavetta biex tidentifika b'mod uniku talba ta' Analytics API. Disponibbli biss wara awtentikazzjoni b'suċċess. |
| X-FactSet-Api-RateLimit-Limit | Numru ta' talbiet permessi għat-tieqa tal-ħin. |
| X-FactSet-Api-RateLimit-Remaining | Numru ta' talbiet li fadal għat-tieqa tal-ħin. |
| X-FactSet-Api-RateLimit-Reset | Numru ta' sekondi li fadal sakemm il-limitu tar-rata jerġa' jiġi ssettjat. |
Ritorni
| Kodiċi tal-istatus HTTP | Deskrizzjoni |
| 202 | Rispons mistenni. |
| 400 | Korp POST invalidu. |
| 401 | Awtentikazzjoni nieqsa jew invalida. |
| 403 | L-utent huwa pprojbit bil-kredenzjali attwali. |
| 415 | Intestatura tat-Tip ta' Kontenut nieqsa/invalida. Il-header jeħtieġ li jiġi ssettjat għal application/json. |
| 429 | Il-limitu tar-rata intlaħaq. Ipprova mill-ġdid it-talbiet wara li tistenna l-ħin speċifikat fl-intestazzjoni ta' retry-after. |
| 500 | Żball tas-server. Iilloggja l-header X-DataDirect-Request-Key biex tassisti fis-soluzzjoni tal-problemi. |
| 503 | It-talba skaduta. Erġa' pprova t-talba fi żmien. |
Rimarki
Massimu ta' 50 talba POST permessi f'tieqa ta' 5 sekondi għal kull API. L-istess jista 'jiġi vverifikat bl-użu tad-diversi headers Rate-Limit disponibbli fir-rispons API.
- X-FactSet-Api-RateLimit-Limit – Numru ta’ talbiet permessi għat-tieqa tal-ħin.
- X-FactSet-Api-RateLimit-Remaining – Numru ta’ talbiet li baqa’ għat-tieqa tal-ħin.
- X-FactSet-Api-RateLimit-Reset – Għadd ta' sekondi li fadal sakemm jerġa' jiġi ssettjat il-limitu tar-rata.
Examples
Talba:
POST https://api.factset.com/analytics/dsotm/v1/transactions.
Intestaturi:
- tip ta' kontenut: applikazzjoni/json
- Awtorizzazzjoni: Bażiku RkRTX0RFTU9fVVMt********************************
- Aċċetta-Kodifikazzjoni: gzip
- tul tal-kontenut: 201
Korp:
Risposta:
HTTP 202 Aċċettat
Intestaturi:
- x-data-ċavetta-talba diretta: zpdo6aebv58fiaoi
- x-factset-api-request-key: 6p2d41m4sw1yfh0h
Oqsma Rekord
Ħolqien ta' Eżekuzzjoni
| Element | Tip | Deskrizzjoni | Obbligatorju |
| portafoll | Spag | L-isem tal-portafoll. Eż: KLIJENT:/DEMO.OFDB | IVA |
| transazzjoni-id | Spag | ID unika għat-tranżazzjoni | IVA |
| simbolu | Spag | Simbolu li jikkorrispondi għall-istrument innegozjat. Eż: AAPL | IVA |
| deskrizzjoni | Spag | Normalment isem, Eż: SISTEMI TA' RIĊERKA FACTSET, iżda jista' jkun aktar deskrittiv għad-derivattivi. | IVA |
| tip ta' kummerċ | Spag | BL (Ixtri Twil), BC (Ixtri biex tkopri), SL (Biegħ Twil) u SS (Biegħ Qasira) | IVA |
| status | Spag | ACCT jew CNCL, qosra għal ACCOUNTED u CANCEDED | IVA |
| data tal-kummerċ | Spag | Data tal-kummerċ li hija fil-format SSSSMMJJ | IVA |
| jitlaq transazzjoni | Float | Ishma li ġew ordnati u mhux esegwiti | LE |
| ammont | Float | Kwantità tal-istrument innegozjat | IVA |
| nett | Float | Valur fi flus kontanti tat-tranżazzjoni, nett mill-ispejjeż tas-senserija. | IVA |
| gross | Float | Valur fi flus kontanti tat-tranżazzjoni, inklużi l-ispejjeż tas-senserija. | IVA |
| valur tas-saldu | Float | Il-valur fi flus kontanti tat-tranżazzjoni huwa valur li ġie mmultiplikat b'rata FX applikabbli biex tikkonverti t-tranżazzjoni rreġistrata fil-munita lokali fil-munita tar-rappurtar. | IVA |
| data tas-saldu | Spag | Data tas-saldu fil-format SSSSXXJJ | IVA |
| munita | Spag | Il-kodiċi tal-munita tal-fields valutati fi flus kontanti, Ammont Nett u Ammont Gross. | IVA |
| rata tal-kambju barrani | Float | Rata FX li tista 'tinġabar minn PA, immultiplikata mal-fields ta' flus kontanti, Net, Gross, biex tippermetti lill-PA turi transazzjonijiet fil-munita tar-rappurtar. | LE |
| munita tas-saldu iso | Spag | Kodiċi tal-munita għall-Valur tas-Settlement | IVA |
| ordnat | Spag | L-identifikatur uniku tal-Ordni huwa pprovdut minn PM Hub. Eż: O_FDS_010623_1686393260254 | LE |
| parentId | Spag | Identifikatur uniku tal-Ordni Ġenitur li għandu jiġi pprovdut mill-OMS. | LE |
Ordni Ħolqien
| Element | Tip | Deskrizzjoni | Obbligatorju |
| portafoll | Spag | L-isem tal-portafoll. Eż: KLIJENT:/DEMO.OFDB | IVA |
| transazzjoni-id | Spag | ID unika għat-tranżazzjoni | IVA |
| simbolu | Spag | Simbolu li jikkorrispondi għall-istrument innegozjat. Eż: AAPL | IVA |
| deskrizzjoni | Spag | Normalment isem, Eż: SISTEMI TA' RIĊERKA FACTSET, iżda jista' jkun aktar deskrittiv għad-derivattivi. | IVA |
| tip ta' kummerċ | Spag | BL (Ixtri Twil), BC (Ixtri biex tkopri), SL (Biegħ Twil) u SS (Biegħ Qasira) | IVA |
| status | Spag | ACCT jew CNCL, qosra għal ACCOUNTED u CANCEDED | IVA |
| data tal-kummerċ | Spag | Data tal-kummerċ li hija fil-format SSSSMMJJ | IVA |
| transazzjoni-weraq | Float | Ishma li ġew ordnati iżda mhux esegwiti | LE |
| ammont | Float | Kwantità tal-istrument innegozjat | IVA |
| munita iso | Spag | Il-kodiċi tal-munita tal-fields valutati fi flus kontanti, Ammont Nett u Ammont Gross. | IVA |
| rata tal-kambju barrani | Float | Rata FX li tista 'tinġabar minn PA, immultiplikata mal-fields ta' flus kontanti, Net, Gross, biex tippermetti lill-PA turi transazzjonijiet fil-munita tar-rappurtar. | LE |
| ordni Id | Spag | L-identifikatur uniku tal-Ordni huwa pprovdut minn PM Hub. Eż: O_FDS_010623_1686393260254 | LE |
Ħolqien ta' Pjazzament
| Element | Tip | Deskrizzjoni | Obbligatorju |
| portafoll | Spag | L-isem tal-portafoll. Eż: KLIJENT:/DEMO.OFDB | IVA |
| transazzjoni-id | Spag | ID unika għat-tranżazzjoni | IVA |
| simbolu | Spag | Simbolu li jikkorrispondi għall-istrument innegozjat. Eż: AAPL | IVA |
| deskrizzjoni | Spag | Normalment isem, Eż: SISTEMI TA' RIĊERKA FACTSET, iżda jista' jkun aktar deskrittiv għad-derivattivi. | IVA |
| tip ta' kummerċ | Spag | BL (Ixtri Twil), BC (Ixtri biex tkopri), SL (Biegħ Twil) u SS (Biegħ Qasira) | IVA |
| status | Spag | ACCT jew CNCL, qosra għal ACCOUNTED u CANCEDED | IVA |
| data tal-kummerċ | Spag | Data tal-kummerċ li hija fil-format SSSSMMJJ | IVA |
| transazzjoni-weraq | Float | Ishma li ġew ordnati iżda mhux esegwiti | LE |
| ammont | Float | Kwantità tal-istrument innegozjat | IVA |
| munita iso | Spag | Il-kodiċi tal-munita tal-fields valutati fi flus kontanti, Ammont Nett u Ammont Gross. | IVA |
| rata tal-kambju barrani | Float | Rata FX li tista 'tinġabar minn PA, immultiplikata mal-fields ta' flus kontanti, Net, Gross, biex tippermetti lill-PA turi transazzjonijiet fil-munita tar-rappurtar. | LE |
| munita tas-saldu iso | Spag | Kodiċi tal-munita għall-Valur tas-Settlement | IVA |
| ordni Id | Spag | L-identifikatur uniku tal-Ordni huwa pprovdut minn PM Hub. Eż: O_FDS_010623_1686393260254 | LE |
| ġenitur Id | Spag | Identifikatur uniku tal-Ordni Ġenitur li għandu jiġi pprovdut mill-OMS. | LE |
Issolvi l-problemi
Il-passi li ġejjin huma rakkomandati biex issolvi l-problemi minn kwalunkwe APIs differenti:
- Irreġistra l-header tar-rispons X-DataDirect-Request-Key sabiex it-tim tal-inġinerija tal-API ta’ FactSet ikun jista’ janalizza t-talba/rispons speċifiku tiegħek.
- Irreġistra l-korp tar-rispons meta r-rispons ikun tweġiba ta' żball. Il-kodiċijiet tal-istatus HTTP kollha ugwali għal u akbar minn 400 huma kkunsidrati bħala tweġibiet ta 'żball.
- Ikkuntattja lit-tim tal-kont tiegħek bl-informazzjoni ta' hawn fuq għall-għajnuna.
Aġġorna l-Verżjoni
- FactSet se jappoġġja verżjonijiet antiki tal-API għal żmien limitat. Il-ħin ta 'appoġġ attwali jiddependi fuq l-API u r-rilaxx stage (jiġifieri, beta jew produzzjoni). Il-bidliet kollha tal-ksur, iż-żidiet fil-funzjonalità, u l-soluzzjonijiet tal-bugs fil-verżjonijiet preċedenti se jiġu dokumentati fil-log tal-bidliet.
- It-tim tal-inġinerija tal-API ta' FactSet se jaħdem mal-klijenti biex jiżgura tranżizzjoni bla xkiel għal verżjonijiet aktar ġodda.
Copyright © 2023 FactSet Research Systems Inc. Id-drittijiet kollha riżervati.
Sistemi ta' Riċerka FactSet Inc | www.factset.com.
Dokumenti / Riżorsi
 |
FACTSET Streaming Dirett Ta' Messaġġi ta' Tranżazzjoni API Software [pdfGwida għall-Utent Verżjoni 1.0, Streaming Dirett Ta' Messaġġi ta' Tranżazzjoni API Software, Streaming Ta' Messaġġi ta' Tranżazzjoni API Software, Transazzjoni Messaġġi API Software, Messaġġi API Software, API Software, Software |