FACTSET Sruthadh dìreach de bhathar-bog API Teachdaireachdan Gnìomh
Fiosrachadh toraidh
Sònrachaidhean
- Ainm toraidh: Sruthadh dìreach de theachdaireachdan malairt API
- Tionndadh: 1.0
- Leabhar-làimhe an leasaiche agus ceann-latha fiosrachaidh: Lùnastal 2023
Brosnachadh
Is e an togradh air cùl API Sruth Teachdaireachdan Gluasaid dìreach dòigh a thoirt seachad gus clàran bho sholaraiche OMS sam bith a cheangal agus dàta malairt fhilleadh a-steach le Àrd-ùrlar Riaghladh Pasgan fìor-ùine FactSet (PMP) airson sùil a chumail air pasgan, atharrais malairt, buadhachadh coileanaidh, agus mion-sgrùdadh toraidh. .
Prògram API
Thairisview
Tha am Prògram API an-toiseach ag amas air einnsean anailis pasgan agus tha e air leudachadh gu bhith a’ toirt a-steach einnseanan anailis eile, toraidhean, agus APIan bho dhiofar aonadan gnìomhachais.
Tha am prògram a’ toirt seachad na leanas:
- Sruthadh dìreach de theachdaireachdan malairt API
Tha a h-uile API air an cumail fo https://api.factset.com. Bithear a’ làimhseachadh dearbhadh le bhith a’ cleachdadh API Keys, agus thathas a’ làimhseachadh ùghdarras le bhith a’ cleachdadh toradh ballrachd a-staigh FactSet. Airson tuilleadh fiosrachaidh mu bhith a’ cleachdadh API Keys, tadhal air https://developer.factset.com/authentication.
Thoir an aire gum bu chòir beachdachadh air ainmean-cinn iarrtas agus freagairt HTTP neo-mhothachail a rèir Standard HTTP. Thathas a’ moladh gun a bhith an urra ri maids cinn-cinn sa chòd agad a tha mothachail air cùis.
Stiùireadh airson cleachdadh bathar
DSoTM API
Cur a-steach Clàran
- Gus clàran malairt a chuir a-steach, cleachd am puing crìochnachaidh a leanas:
- POST/analytics/dsotm/v1/transactions
Iarr cinn-cinn
- Ùghdarrachadh
Ceann-cinn àbhaisteach HTTP. Feumaidh an luach an cruth 'Bunaiteach' a chleachdadh. - Seòrsa susbaint
Ceann-cinn àbhaisteach HTTP. Feumaidh an luach a bhith air a shònrachadh mar iarrtas / JSON gus innse gu bheil am buidheann ann an cruth JSON.
Fuasgladh thrioblaidean
Airson fiosrachadh fuasgladh cheistean, thoir sùil air earrann 4 de Leabhar-làimhe agus Fiosrachadh an Luchd-leasachaidh.
Ùrachadh Tionndadh
Gheibhear fiosrachadh mu ùrachadh dreach ann an earrann 5 de Leabhar-làimhe agus Iomradh an Luchd-leasachaidh.
Ceistean Cumanta
- C: Dè an adhbhar a tha aig an API Streaming Direct of Transaction Messages?
F: Is e adhbhar an API Sruth Teachdaireachdan Gluasaid dìreach dàta malairt bho sholaraiche OMS sam bith a cheangal ri Àrd-ùrlar Riaghlaidh Pasgan FactSet airson sùil a chumail air pasgan, atharrais malairt, buadhachadh coileanaidh, agus mion-sgrùdadh toraidh. - C: Càite am faigh mi barrachd fiosrachaidh mu bhith a’ cleachdadh API Keys?
A: Gheibhear tuilleadh fiosrachaidh mu bhith a’ cleachdadh API Keys aig https://developer.factset.com/authentication.
Brosnachadh
Ann an 1997, chuir FactSet Mion-sgrùdadh Pasgan 1.0 air bhog, a shuidhich bunait airson Analytics. Goirid às deidh sin, amalaichte Mion-sgrùdadh Pasgan 2.0 mion-sgrùdadh cunnairt bho luchd-reic treas-phàrtaidh, agus an uairsin air a leudachadh gu bhith a’ toirt a-steach Teachd-a-steach Stèidhichte ann an 2004. Tha FactSet a-nis a’ tabhann sreath làidir de thoraidhean anailis pasgan ioma-mhaoin a tha a’ stiùireadh a’ mhargaidh ann an sùbailteachd, mion-sgrùdadh, agus farsaingeachd. An-diugh, tha teachdaichean an urra ri FactSet airson anailisean eadar-ghnìomhach tro dhiofar thoraidhean, leithid Sgrùdadh Pasgan (PA), SPAR, Deuchainn Alpha, Optimizers, agus Deas-bhòrd Pasgan, a bharrachd air cuairteachadh anailis tro Portfolio Batcher, Publisher Flat. Files, agus sgrìobhainnean Foillsichear.
Prògram API
Thairisview
Tha luchd-dèiligidh air a bhith a’ gluasad a dh’ionnsaigh fuasgladh àbhaisteach a thogail, air a stiùireadh leis an fheum air cinneasachd àrdachadh le bhith a’ tional fiosrachadh gu eòlas aon neach-cleachdaidh. Le bhith a’ nochdadh anailisean, coileanadh, agus cunnart tro APIn, tha e a’ toirt dhut seanal sòlaimte gus eadar-obrachadh leis na prìomh anailisean ioma-mhaoin aig FactSet. Mar a bhios a’ mhargaidh a’ leantainn air adhart ag iarraidh barrachd soilleireachd agus dàta, bheir FactSet seachad roghainnean sùbailte gus coinneachadh ris na h-iarrtasan sin. Bidh APIan a’ cur ris na tairgsean sreath anailis gnàthach agus a’ comasachadh com-pàirteachasan le bhith a’ toirt cothrom dhut eòlasan prìobhaideach a thogail, amalachadh le innealan BI treas-phàrtaidh leithid Tableau, agus pasganan stat treas-phàrtaidh mar RStudio, agus smachd àrdachadh air caitheamh anailisean a-staigh bho FactSet.
A 'chiad stage a bhith a’ nochdadh Analytics APIs a’ cuimseachadh air einnsean anailis pasgan. Bho chaidh a stèidheachadh, tha am prògram air leudachadh gu bhith a’ toirt a-steach einnseanan anailis eile, toraidhean, agus APIan bho aonadan gnìomhachais eile.
Tha am prògram a’ toirt seachad na leanas:
- Inneal luchd-leasachaidh gus dearbhadh bun-bheachd a thogail
- Faireachdainn èideadh thairis air a h-uile API aig ìre iomairt FactSet
- Cumail ri inbhean gnìomhachais
- APIan dreach
- Sgrìobhainnean farsaing agus clasaichean oideachaidh air portal an leasaiche
Sruthadh dìreach de theachdaireachdan malairt API
- Ceangail clàran bho sholaraiche OMS sam bith gus an dàta malairt agad fhilleadh a-steach le Àrd-ùrlar Riaghladh Pasgan fìor-ùine FactSet (PMP) airson a bhith a’ cumail sùil air pasgan agus atharrais malairt, no airson a chleachdadh anns an Einnsean Mion-sgrùdadh Pasgan cumhachdach airson mion-sgrùdadh Buaidh Coileanaidh agus Toradh.
- Tha a h-uile API air an cumail fo https://api.factset.com. Bithear a’ làimhseachadh dearbhadh le bhith a’ cleachdadh API Keys agus tha cead air a làimhseachadh le bhith a’ cleachdadh toradh ballrachd a-staigh FactSet. Gheibh thu barrachd fiosrachaidh mu bhith a’ cleachdadh API Keys aig https://developer.factset.com/authentication.
Bu chòir beachdachadh air ainmean-cinn iarrtas agus freagairt HTTP neo-mhothachail a rèir Inbhe HTTP. Feuch nach bi thu an urra ri maids cinn-cinn sa chòd agad a tha mothachail air cùis.
Cur a-steach Clàran
Cuir a-steach Gnìomhan
POST/analytics/dsotm/v1/transactions
Bidh am puing crìochnachaidh seo a’ gabhail ri clàran malairt agus gan sgrìobhadh aig an aon àm gu OMS_OFDB a’ phasgan ainmichte agus gan toirt seachad san tagradh PMP.
Iarr cinn-cinn
| Ainm ceann-cinnidh | Tuairisgeul |
| Ùghdarrachadh | Ceann-cinn àbhaisteach HTTP. Feumaidh luach an 'Bunaiteach ' cruth. |
| Susbaint-Seòrsa | Ceann-cinn àbhaisteach HTTP. Feumaidh luach tagradh / JSON a shònrachadh (ie, feumaidh an neach-fios sònrachadh gu bheil am buidheann ann an cruth JSON). |
Buidheann Iarraidh
Gabhaidh a’ bhuidheann iarrtais ri cruinneachadh de pharamadairean àireamhachaidh. Tha na paramadairean air am mìneachadh gu h-ìosal:
| Ainm paramadair | Seòrsa dàta | A dhìth | Tuairisgeul | Cruth |
| cur gu bàs | Eagrachadh | Chan eil | Liosta de chlàran cur gu bàs | Tha raointean clàraidh mionaideach rim faighinn an seo |
| greisean gnìomhachais | Eagrachadh | Chan eil | Liosta de chlàran suidheachaidh | Tha raointean clàraidh mionaideach rim faighinn an seo |
| òrduighean | Eagrachadh | Chan eil | Liosta de chlàran òrduigh | Tha raointean clàraidh mionaideach rim faighinn an seo |
Cinn freagairt
| Ainm ceann-cinnidh | Tuairisgeul |
| Iarrtas-X-DataDirect-iuchair | Ceann-cinn iuchrach iarrtas FactSet. |
| X-FactSet-Api-Iarrtas-Iuchrach | An iuchair gus iarrtas Analytics API a chomharrachadh gu sònraichte. Ri fhaighinn dìreach às deidh dearbhadh soirbheachail. |
| X-FactSet-Api-RateLimit-Limit | An àireamh de dh'iarrtasan ceadaichte airson na h-uinneige ùine. |
| X-FactSet-Api-RateLimit-Air fhàgail | Àireamh de dh'iarrtasan air fhàgail airson na h-uinneige ùine. |
| X-FactSet-Api-RateLimit-Ath-shuidheachadh | An àireamh de dhiogan air fhàgail gus an tèid crìoch na h-ìre ath-shuidheachadh. |
Tilleadh
| Còd inbhe HTTP | Tuairisgeul |
| 202 | Freagairt ris a bheil dùil. |
| 400 | Buidheann POST neo-dhligheach. |
| 401 | Dearbhadh a dhìth no neo-dhligheach. |
| 403 | Tha an neach-cleachdaidh toirmisgte le teisteanasan làithreach. |
| 415 | Ceann-cinn seòrsa susbaint a dhìth/neo-dhligheach. Feumaidh an bann-cinn a bhith air a shuidheachadh gu application/json. |
| 429 | Chaidh crìoch na h-ìre a ruighinn. Feuch ris na h-iarrtasan a-rithist às deidh feitheamh na h-ùine a chaidh a shònrachadh anns a’ bhann-cinn retry-after. |
| 500 | Mearachd an fhrithealaiche. Log a-steach bann-cinn X-DataDirect-Request-Key gus cuideachadh le fuasgladh cheistean. |
| 503 | Iarrtas ùine seachad. Feuch ris an iarrtas a-rithist an ceann ùine. |
Beachdan
50 iarrtas POST aig a’ char as àirde ceadaichte ann an uinneag 5-diog airson gach API. Faodar an aon rud a dhearbhadh le bhith a’ cleachdadh na diofar chinn-cinn Rate-Limit a tha rim faighinn ann am freagairt API.
- X-FactSet-Api-RateLimit-Limit - An àireamh de dh’ iarrtasan ceadaichte airson an uinneag ùine.
- X-FactSet-Api-RateLimit-Remaining - An àireamh de dh'iarrtasan air fhàgail airson an uinneag ùine.
- X-FactSet-Api-RateLimit-Reset - An àireamh de dhiogan air fhàgail gus an tèid crìoch na h-ìre ath-shuidheachadh.
Examples
Iarrtas:
POST https://api.factset.com/analytics/dsotm/v1/transactions.
Cinn-cinn:
- seòrsa susbaint: iarrtas/json
- Ùghdarrachadh: RkRTX0RFTU9fVVMt bunaiteach ******************************
- Gabh ri còdachadh: gzip
- fad susbaint: 201
Corp:
Freagairt:
HTTP 202 ris an deach gabhail
Cinn-cinn:
- x-data dìreach-iarr-iuchrach: zpdo6aebv58fiaoi
- x-factset-api-request-key: 6p2d41m4sw1yfh0h
Raointean Clàraidh
Cruthachadh Cur gu bàs
| Eileamaid | Seòrsa | Tuairisgeul | Riatanach |
| màileid | sreang | Ainm na portfolio. Mar eisimpleir: CLIENT:/DEMO.OFDB | THA |
| malairt-id | sreang | ID gun samhail airson a’ ghnothaich | THA |
| samhladh | sreang | Suaicheantas a fhreagras air an ionnstramaid malairt. Mar eisimpleir: AAPL | THA |
| tuairisgeul | sreang | Mar as trice ainm, Ex: FACTSET RESEARCH SYSTEMS, ach dh’ fhaodadh e a bhith nas tuairisgeulach airson derivatives. | THA |
| seòrsa malairt | sreang | BL (Ceannaich Fada), BC (Ceannaich gu còmhdach), SL (Sell Long) agus SS (Sell Short) | THA |
| inbhe | sreang | ACCT no CNCL, goirid airson ACCOUNTED and CANCELED | THA |
| ceann-latha malairt | sreang | Ceann-latha malairt a tha ann an cruth YYYYMMDD | THA |
| fàgail malairt | Flùr | Earrannan a chaidh òrdachadh agus nach deach a chur gu bàs | CHAN EIL |
| suim | Flùr | Meud an ionnstramaid a chaidh a mhalairt | THA |
| lìon | Flùr | Luach airgid a’ ghnothaich, lom bho chosgaisean brisidh. | THA |
| gruamach | Flùr | Luach airgid a’ ghnothaich, a’ gabhail a-steach cosgaisean brisidh. | THA |
| luach tuineachaidh | Flùr | Is e luach airgid a’ ghnothaich luach a chaidh iomadachadh le ìre FX iomchaidh gus an gnothach a chaidh a ghlèidheadh ann an airgead ionadail a thionndadh gu airgead aithris. | THA |
| ceann-latha rèiteachaidh | sreang | Ceann-latha tuineachaidh ann an cruth YYYYMMDD | THA |
| airgead-crìche | sreang | Còd airgead raointean le luach airgid, Suim lom agus Suim Làn. | THA |
| ìre iomlaid cèin | Flùr | Ìre FX a ghabhas togail le PA, air iomadachadh leis na raointean le luach airgid, Net, Gross, gus leigeil le PA gnothaichean a nochdadh ann an airgead aithris. | CHAN EIL |
| airgead tuineachaidh iso | sreang | Còd airgead airson Luach Tuineachaidh | THA |
| òrduchadh | sreang | Tha aithnichear sònraichte an Òrdugh air a thoirt seachad le PM Hub. Mar eisimpleir: O_FDS_010623_1686393260254 | CHAN EIL |
| ID pàrant | sreang | Comharra sònraichte den Òrdugh Pàrant ri thoirt seachad le OMS. | CHAN EIL |
Cruthachadh Òrdugh
| Eileamaid | Seòrsa | Tuairisgeul | Riatanach |
| màileid | sreang | Ainm na portfolio. Mar eisimpleir: CLIENT:/DEMO.OFDB | THA |
| malairt-id | sreang | ID gun samhail airson a’ ghnothaich | THA |
| samhladh | sreang | Suaicheantas a fhreagras air an ionnstramaid malairt. Mar eisimpleir: AAPL | THA |
| tuairisgeul | sreang | Mar as trice ainm, Ex: FACTSET RESEARCH SYSTEMS, ach dh’ fhaodadh e a bhith nas tuairisgeulach airson derivatives. | THA |
| seòrsa malairt | sreang | BL (Ceannaich Fada), BC (Ceannaich gu còmhdach), SL (Sell Long) agus SS (Sell Short) | THA |
| inbhe | sreang | ACCT no CNCL, goirid airson ACCOUNTED and CANCELED | THA |
| ceann-latha malairt | sreang | Ceann-latha malairt a tha ann an cruth YYYYMMDD | THA |
| duilleagan malairt | Flùr | Earrannan a chaidh òrdachadh ach nach deach an cur gu bàs | CHAN EIL |
| suim | Flùr | Meud an ionnstramaid a chaidh a mhalairt | THA |
| iso airgead | sreang | Còd airgead raointean le luach airgid, Suim lom agus Suim Làn. | THA |
| ìre iomlaid cèin | Flùr | Ìre FX a ghabhas togail le PA, air iomadachadh leis na raointean le luach airgid, Net, Gross, gus leigeil le PA gnothaichean a nochdadh ann an airgead aithris. | CHAN EIL |
| òrdugh Id | sreang | Tha aithnichear sònraichte an Òrdugh air a thoirt seachad le PM Hub. Mar eisimpleir: O_FDS_010623_1686393260254 | CHAN EIL |
Cruthachadh Suidheachadh
| Eileamaid | Seòrsa | Tuairisgeul | Riatanach |
| màileid | sreang | Ainm na portfolio. Mar eisimpleir: CLIENT:/DEMO.OFDB | THA |
| malairt-id | sreang | ID gun samhail airson a’ ghnothaich | THA |
| samhladh | sreang | Suaicheantas a fhreagras air an ionnstramaid malairt. Mar eisimpleir: AAPL | THA |
| tuairisgeul | sreang | Mar as trice ainm, Ex: FACTSET RESEARCH SYSTEMS, ach dh’ fhaodadh e a bhith nas tuairisgeulach airson derivatives. | THA |
| seòrsa malairt | sreang | BL (Ceannaich Fada), BC (Ceannaich gu còmhdach), SL (Sell Long) agus SS (Sell Short) | THA |
| inbhe | sreang | ACCT no CNCL, goirid airson ACCOUNTED and CANCELED | THA |
| ceann-latha malairt | sreang | Ceann-latha malairt a tha ann an cruth YYYYMMDD | THA |
| duilleagan malairt | Flùr | Earrannan a chaidh òrdachadh ach nach deach an cur gu bàs | CHAN EIL |
| suim | Flùr | Meud an ionnstramaid a chaidh a mhalairt | THA |
| iso airgead | sreang | Còd airgead raointean le luach airgid, Suim lom agus Suim Làn. | THA |
| ìre iomlaid cèin | Flùr | Ìre FX a ghabhas togail le PA, air iomadachadh leis na raointean le luach airgid, Net, Gross, gus leigeil le PA gnothaichean a nochdadh ann an airgead aithris. | CHAN EIL |
| airgead tuineachaidh iso | sreang | Còd airgead airson Luach Tuineachaidh | THA |
| òrdugh Id | sreang | Tha aithnichear sònraichte an Òrdugh air a thoirt seachad le PM Hub. Mar eisimpleir: O_FDS_010623_1686393260254 | CHAN EIL |
| ID pàrant | sreang | Comharra sònraichte den Òrdugh Pàrant ri thoirt seachad le OMS. | CHAN EIL |
Fuasgladh thrioblaidean
Thathas a’ moladh na ceumannan a leanas gus mearachdan bho gin de na diofar APIan a rèiteach:
- Clàraich bann-cinn freagairt X-DataDirect-Request-Key gus an urrainn do sgioba innleadaireachd API FactSet an t-iarrtas / freagairt sònraichte agad a sgrùdadh.
- Clàraich am buidheann freagairt nuair a tha am freagairt mar fhreagairt mearachd. Thathas den bheachd gu bheil a h-uile còd inbhe HTTP co-ionann ri agus nas àirde na 400 mar fhreagairtean mearachd.
- Cuir fios chun sgioba cunntais agad leis an fhiosrachadh gu h-àrd airson cuideachadh.
Ùrachadh Tionndadh
- Bheir FactSet taic do sheann dreachan API airson ùine chuingealaichte. Bidh an fhìor ùine taic an urra ris an API agus an sgaoileadh stage (ie, beta no cinneasachadh). Thèid a h-uile atharrachadh brisidh, cur-ris gnìomh, agus rèiteachadh bug thairis air dreachan nas tràithe a chlàradh anns an changelog.
- Bidh sgioba innleadaireachd API FactSet ag obair leis an luchd-dèiligidh gus dèanamh cinnteach gum bi gluasad rèidh gu dreachan nas ùire.
Còraichean glèidhte © 2023 FactSet Research Systems Inc.
FactSet Research Systems Inc. | www.factset.com.
Sgrìobhainnean/Goireasan
 |
FACTSET Sruthadh dìreach de bhathar-bog API Teachdaireachdan Gnìomh [pdfStiùireadh Cleachdaiche Tionndadh 1.0, sruthadh dìreach de bhathar-bog API Teachdaireachdan Gnìomh, Sruthadh Bathar-bog API Teachdaireachdan Gnìomh, Bathar-bog API Teachdaireachdan Gnìomh, Bathar-bog Teachdaireachdan API, Bathar-bog API, Bathar-bog |