STAÐREYNDIN Bein streymi á viðskiptaskilaboðum API hugbúnaðarhandbók

Hvatning
Hvatinn á bak við API fyrir beina streymi á færsluskilaboðum er að bjóða upp á leið til að tengja færslur frá hvaða OMS-veitu sem er og samþætta viðskiptagögn við rauntíma Portfolio Management Platform (PMP) FactSet fyrir eignasafnseftirlit, viðskiptauppgerð, frammistöðugreiningu og ávöxtunargreiningu. .

API forrit

Yfirview
API forritið einbeitir sér upphaflega að eignasafnsgreiningarvélinni og hefur stækkað til að fela í sér aðrar greiningarvélar, vörur og API frá mismunandi rekstrareiningum.

Forritið býður upp á eftirfarandi:

Bein streymi á færsluskilaboðum API

Öll API eru hýst undir https://api.factset.com. Auðkenning er meðhöndluð með API lyklum og heimild er meðhöndluð með því að nota FactSet innanhússáskriftarvöru. Fyrir frekari upplýsingar um notkun API lykla, vinsamlegast farðu á https://developer.factset.com/authentication.

Vinsamlegast athugaðu að nöfn HTTP beiðni og svarhaus ættu að teljast hástafaónæmir samkvæmt HTTP staðli. Mælt er með því að treysta ekki á hástafahátta samsvörun hausa í kóðanum þínum.

Notkunarleiðbeiningar fyrir vöru

DSoTM API

Sendir inn skrár

Til að senda inn færsluskrár skaltu nota eftirfarandi endapunkt:

POST /analytics/dsotm/v1/færslur

Beiðni um haus

Heimild
Venjulegur HTTP haus. Gildið þarf að nota 'Basic' sniðið.
Efnistegund
Venjulegur HTTP haus. Tilgreina þarf gildið sem forrit/JSON til að gefa til kynna að meginmálið sé á JSON sniði.

Úrræðaleit
Fyrir upplýsingar um bilanaleit, vinsamlegast skoðaðu kafla 4 í þróunarhandbók og tilvísun.

Uppfærsla á útgáfu
Upplýsingar um útgáfuuppfærslur er að finna í kafla 5 í þróunarhandbók og tilvísun.

Algengar spurningar

Sp.: Hver er tilgangurinn með API fyrir beina streymi á færsluskilaboðum?
A: Tilgangurinn með beinni streymi á færsluskilaboðum API er að tengja viðskiptagögn frá hvaða OMS-veitu sem er við Portfolio Management Platform FactSet fyrir eignasafnseftirlit, viðskiptahermingu, frammistöðugreiningu og ávöxtunargreiningu.

Sp.: Hvar get ég fundið frekari upplýsingar um notkun API lykla?
A: Frekari upplýsingar um notkun API lykla er að finna á https://developer.factset.com/authentication.

Hvatning

Árið 1997 setti FactSet af stað Portfolio Analysis 1.0, sem lagði grunninn að Analytics. Skömmu síðar samþætti Portfolio Analysis 2.0 áhættugreiningar frá þriðju aðila, og stækkaði síðan til að ná yfir fastar tekjur árið 2004. FactSet býður nú upp á öfluga svítu af greiningarvörum fyrir fjöleignir eignasafns sem leiða markaðinn í sveigjanleika, greiningu og breidd. Í dag treysta viðskiptavinir á FactSet fyrir gagnvirka greiningu í gegnum ýmsar vörur, svo sem Portfolio Analysis (PA), SPAR, Alpha Testing, Optimizers og Portfolio Dashboard, svo og dreifingu greiningar í gegnum Portfolio Batcher, Publisher Flat Files, og útgefandaskjöl.

API forrit

Yfirview

Viðskiptavinir hafa verið að stefna að því að byggja sérsniðna lausn, knúin áfram af þörfinni á að auka framleiðni með því að sameina upplýsingar í eina notendaupplifun. Með því að afhjúpa greiningar, frammistöðu og áhættu í gegnum API, veitir það þér háþróaða rás til að hafa samskipti við leiðandi fjöleignagreiningar FactSet. Þar sem markaðurinn heldur áfram að krefjast meira gagnsæis og gagna mun FactSet bjóða upp á sveigjanlega valkosti til að mæta þessum kröfum. API eru viðbót við núverandi tilboð fyrir greiningarsvítu og auðveldar samstarf með því að leyfa þér að byggja upp einkaupplifun, samþætta BI tólum þriðja aðila eins og Tableau og tölfræðipakka þriðja aðila eins og RStudio og auka stjórn á innri neyslu greiningar frá FactSet.

Fyrsta stagAð afhjúpa Analytics API mun einbeita sér að greiningarvél eignasafnsins. Frá upphafi hefur forritið stækkað til að innihalda aðrar greiningarvélar, vörur og API frá öðrum rekstrareiningum.

Forritið býður upp á eftirfarandi:

Verkfærasett fyrir þróunaraðila til að byggja upp sönnun fyrir hugmyndinni
Samræmd tilfinning í öllum forritaskilum FactSet í fyrirtækjaskala

Fylgni við staðla iðnaðarins
Útgáfa API
Umfangsmikil skjöl og kennsluefni á þróunargáttinni

Bein streymi á færsluskilaboðum API

Tengdu færslur frá hvaða OMS-veitu sem er til að samþætta viðskiptagögnin þín við rauntíma Portfolio Management Platform (PMP) FactSet fyrir eignasafnseftirlit og viðskiptauppgerð, eða til að nota í öflugu Portfolio Analytics Engine for Performance Attribution and Returns.
Öll API eru hýst undir https://api.factset.com. Auðkenning er meðhöndluð með API lyklum og heimild er meðhöndluð með því að nota FactSet innanhússáskriftarvöru. Þú getur fundið frekari upplýsingar um notkun API lykla á https://developer.factset.com/authentication.

Heiti HTTP-beiðna og svarahausa ætti að teljast hástafaónæmir samkvæmt HTTP staðli. Vinsamlegast ekki treysta á hástafanæm samsvörun hausa í kóðanum þínum.

Sendir inn skrár

Sendu inn færslur
POST /analytics/dsotm/v1/færslur

Þessi endapunktur tekur við færsluskrám og skrifar þær samtímis í OMS_OFDB eignasafnsins og gerir þær aðgengilegar í PMP forritinu.

Beiðni um haus

Heiti haus	Lýsing
Heimild	Venjulegur HTTP haus. Gildi þarf að nota 'Basic ' sniði.
InnihaldTegund	Venjulegur HTTP haus. Gildi þarf að tilgreina forrit/JSON (þ.e. sá sem hringir þarf að tilgreina að meginmálið sé á JSON sniði).

Beiðni aðili
Beiðnihlutinn samþykkir safn af reiknibreytum. Færibreyturnar eru lýstar hér að neðan:

Heiti færibreytu	Gagnategund	Áskilið	Lýsing	Snið
aftökur	Fylki	Nei	Listi yfir framkvæmdarskrár	Ítarlegar skráareitir eru fáanlegir hér
staðsetningar	Fylki	Nei	Listi yfir staðsetningarskrár	Ítarlegar skráareitir eru fáanlegir hér
pantanir	Fylki	Nei	Listi yfir pöntunarskrár	Ítarlegar skráareitir eru fáanlegir hér

Svarhausar

Heiti haus	Lýsing
X-DataDirect-Request-Lykill	Beiðnilykilhaus FactSet.
X-FactSet-Api-Request-Key	Lykill til að bera kennsl á Analytics API beiðni. Aðeins í boði eftir auðkenningu.
X-FactSet-Api-RateLimit-Limit	Fjöldi leyfilegra beiðna fyrir tímagluggann.
X-FactSet-Api-RateLimit-Remaining	Fjöldi beiðna eftir fyrir tímagluggann.
X-FactSet-Api-RateLimit-Reset	Fjöldi sekúndna sem eftir eru þar til gengistakmörk endurstillast.

Skilar

HTTP stöðukóði	Lýsing
202	Væntanlegt svar.
400	Ógildur POST meginmál.
401	Vantar eða ógild auðkenning.
403	Notandinn er bannaður með núverandi skilríki.
415	Vantar/Ógildur efnisgerð haus. Hausinn þarf að vera stilltur á application/json.
429	Takmarkinu var náð. Reyndu aftur beiðnirnar eftir að hafa beðið þann tíma sem tilgreindur er í hausnum fyrir aftur tilraun eftir.
500	Netþjónsvilla. Skráðu X-DataDirect-Request-Key hausinn til að aðstoða við bilanaleit.
503	Beiðni rann út á tíma. Reyndu beiðnina aftur eftir nokkurn tíma.

Athugasemdir
Hámark 50 POST beiðnir leyfðar í 5 sekúndna glugga fyrir hvert API. Það sama er hægt að sannreyna með því að nota hina ýmsu Rate-Limit hausa sem eru fáanlegir í API svarinu.

X-FactSet-Api-RateLimit-Limit – Fjöldi leyfilegra beiðna fyrir tímagluggann.
X-FactSet-Api-RateLimit-Remaining – Fjöldi beiðna eftir fyrir tímagluggann.
X-FactSet-Api-RateLimit-Reset – Fjöldi sekúndna sem eftir eru þar til hraðatakmörk endurstillast.

Examples

Beiðni:
POST https://api.factset.com/analytics/dsotm/v1/transactions.

Fyrirsagnir:

efnisgerð: forrit/json

Heimild: Basic RkRTX0RFTU9fVVMt******************************
Samþykkja-kóðun: gzip
innihaldslengd: 201

Líkami:

Svar:
HTTP 202 samþykkt

Fyrirsagnir:

x-gögn bein-beiðni-lykill: zpdo6aebv58fiaoi
x-factset-api-request-key: 6p2d41m4sw1yfh0h

Upptökureitir

Framkvæmdarsköpun

Frumefni	Tegund	Lýsing	Skylt
eigu	Strengur	Heiti eignasafnsins. Dæmi: CLIENT:/DEMO.OFDB	JÁ
viðskipta-auðkenni	Strengur	Einstakt auðkenni fyrir viðskiptin	JÁ
tákn	Strengur	Tákn sem samsvarar gerningnum sem verslað er með. Dæmi: AAPL	JÁ
lýsingu	Strengur	Venjulega nafn, Dæmi: FACTSET RANNSÓKNAKERFI, en gæti verið meira lýsandi fyrir afleiður.	JÁ
tegund viðskipta	Strengur	BL (Buy Long), BC (Buy to Cover), SL (Sell Long) og SS (Sell Short)	JÁ
stöðu	Strengur	ACCT eða CNCL, stytting á ACCOUNTED og CANCELED	JÁ
viðskiptadagsetning	Strengur	Viðskiptadagur sem er á sniðinu ÁÁÁÁMMDD	JÁ
færsla fer	Fljóta	Hlutabréf sem hafa verið skipuð og ekki framkvæmd	NEI
upphæð	Fljóta	Magn gerningsins sem verslað er með	JÁ
nettó	Fljóta	Handbært fé viðskiptanna að frádregnum miðlunarkostnaði.	JÁ
brúttó	Fljóta	Handbært fé viðskiptanna, að meðtöldum miðlunarkostnaði.	JÁ
uppgjörsverðmæti	Fljóta	Reiðufé viðskiptanna er gildi sem hefur verið margfaldað með viðeigandi gjaldeyrisgengi til að umbreyta færslunni sem bókuð er í staðbundinni mynt yfir í skýrslugjaldmiðilinn.	JÁ
uppgjörsdag	Strengur	Uppgjörsdagsetning á ÁÁÁÁMMDD sniði	JÁ
gjaldmiðil	Strengur	Gjaldmiðilskóði reiðufjárvirðisreitanna, Nettóupphæð og Brúttóupphæð.	JÁ
erlendu gengi	Fljóta	Gjaldeyrisgengi sem hægt er að taka upp með PA, margfaldað með reitunum með reiðufé, Nettó, Brúttó, til að leyfa PA að sýna viðskipti í skýrslugjaldmiðli.	NEI
uppgjörsgjaldmiðill iso	Strengur	Gjaldmiðilskóði fyrir uppgjörsvirði	JÁ
pantaði	Strengur	Einstakt auðkenni pöntunarinnar er veitt af PM Hub. Dæmi: O_FDS_010623_1686393260254	NEI
foreldraauðkenni	Strengur	Einstakt auðkenni foreldrapöntunarinnar sem OMS gefur upp.	NEI

Pöntunarsköpun

Frumefni	Tegund	Lýsing	Skylt
eigu	Strengur	Heiti eignasafnsins. Dæmi: CLIENT:/DEMO.OFDB	JÁ

viðskipta-auðkenni	Strengur	Einstakt auðkenni fyrir viðskiptin	JÁ
tákn	Strengur	Tákn sem samsvarar gerningnum sem verslað er með. Dæmi: AAPL	JÁ
lýsingu	Strengur	Venjulega nafn, Dæmi: FACTSET RANNSÓKNAKERFI, en gæti verið meira lýsandi fyrir afleiður.	JÁ
tegund viðskipta	Strengur	BL (Buy Long), BC (Buy to Cover), SL (Sell Long) og SS (Sell Short)	JÁ
stöðu	Strengur	ACCT eða CNCL, stytting á ACCOUNTED og CANCELED	JÁ
viðskiptadagsetning	Strengur	Viðskiptadagur sem er á sniðinu ÁÁÁÁMMDD	JÁ
viðskipta-blöð	Fljóta	Hlutabréf sem hafa verið skipuð en ekki framkvæmd	NEI
upphæð	Fljóta	Magn gerningsins sem verslað er með	JÁ
gjaldmiðill iso	Strengur	Gjaldmiðilskóði reiðufjárvirðisreitanna, Nettóupphæð og Brúttóupphæð.	JÁ
erlendu gengi	Fljóta	Gjaldeyrisgengi sem hægt er að taka upp með PA, margfaldað með reitunum með reiðufé, Nettó, Brúttó, til að leyfa PA að sýna viðskipti í skýrslugjaldmiðli.	NEI
pöntun kt	Strengur	Einstakt auðkenni pöntunarinnar er veitt af PM Hub. Dæmi: O_FDS_010623_1686393260254	NEI

Staðsetningarsköpun

Frumefni	Tegund	Lýsing	Skylt
eigu	Strengur	Heiti eignasafnsins. Dæmi: CLIENT:/DEMO.OFDB	JÁ
viðskipta-auðkenni	Strengur	Einstakt auðkenni fyrir viðskiptin	JÁ
tákn	Strengur	Tákn sem samsvarar gerningnum sem verslað er með. Dæmi: AAPL	JÁ
lýsingu	Strengur	Venjulega nafn, Dæmi: FACTSET RANNSÓKNAKERFI, en gæti verið meira lýsandi fyrir afleiður.	JÁ
tegund viðskipta	Strengur	BL (Buy Long), BC (Buy to Cover), SL (Sell Long) og SS (Sell Short)	JÁ
stöðu	Strengur	ACCT eða CNCL, stytting á ACCOUNTED og CANCELED	JÁ
viðskiptadagsetning	Strengur	Viðskiptadagur sem er á sniðinu ÁÁÁÁMMDD	JÁ
viðskipta-blöð	Fljóta	Hlutabréf sem hafa verið skipuð en ekki framkvæmd	NEI
upphæð	Fljóta	Magn gerningsins sem verslað er með	JÁ
gjaldmiðill iso	Strengur	Gjaldmiðilskóði reiðufjárvirðisreitanna, Nettóupphæð og Brúttóupphæð.	JÁ

erlendu gengi	Fljóta	Gjaldeyrisgengi sem hægt er að taka upp með PA, margfaldað með reitunum með reiðufé, Nettó, Brúttó, til að leyfa PA að sýna viðskipti í skýrslugjaldmiðli.	NEI
uppgjörsgjaldmiðill iso	Strengur	Gjaldmiðilskóði fyrir uppgjörsvirði	JÁ
pöntun kt	Strengur	Einstakt auðkenni pöntunarinnar er veitt af PM Hub. Dæmi: O_FDS_010623_1686393260254	NEI
foreldri auðkenni	Strengur	Einstakt auðkenni foreldrapöntunarinnar sem OMS gefur upp.	NEI

Úrræðaleit

Mælt er með eftirfarandi skrefum til að leysa villur frá einhverju af mismunandi API:

Skráðu X-DataDirect-Request-Key svarhausinn svo að API verkfræðiteymi FactSet geti greint sérstaka beiðni/svar þitt.
Skráðu meginmál svarsins þegar svarið er villusvar. Allir HTTP stöðukóðar sem eru jafnir og stærri en 400 teljast villuviðbrögð.

Hafðu samband við reikningsteymi þitt með ofangreindar upplýsingar til að fá aðstoð.

Uppfærsla á útgáfu

FactSet mun styðja gamlar API útgáfur í takmarkaðan tíma. Raunverulegur stuðningstími fer eftir API og útgáfu stage (þ.e. beta eða framleiðsla). Allar brotabreytingar, virkniviðbætur og villuleiðréttingar í fyrri útgáfum verða skráðar í breytingaskránni.
API verkfræðiteymi FactSet mun vinna með viðskiptavinum til að tryggja slétt umskipti yfir í nýrri útgáfur.

FactSet Research Systems Inc. | www.factset.com.

Skjöl / auðlindir

FACTSETT Bein streymi á viðskiptaskilaboðum API hugbúnaður [pdfNotendahandbók
Útgáfa 1.0, Bein straumspilun á færsluskilaboða API hugbúnaði, straumspilun á færsluskilaboðum API hugbúnaði, færsluskilaboða API hugbúnaður, skilaboðaskilaskila hugbúnaður, API hugbúnaður, hugbúnaður

Heimildir

Notendahandbók

FACTSETT Bein streymi á viðskiptaskilaboðum API hugbúnaður

Upplýsingar um vöru