Utiririshaji wa Moja kwa Moja wa Programu ya API ya Ujumbe wa Muamala wa FACTSET

Taarifa ya Bidhaa

Vipimo

• Jina la Bidhaa: Utiririshaji wa moja kwa moja wa API ya Ujumbe wa Muamala
• Toleo: 1.0
• Mwongozo wa Msanidi programu na Tarehe ya Marejeleo: Agosti 2023

Kuhamasisha
Msukumo wa API ya Utiririshaji wa Moja kwa Moja wa Ujumbe wa Muamala ni kutoa njia ya kuunganisha rekodi kutoka kwa mtoa huduma yeyote wa OMS na kuunganisha data ya biashara na Mfumo wa Usimamizi wa Kwingineko wa wakati halisi wa FactSet (PMP) kwa usimamizi wa kwingineko, uigaji wa biashara, maelezo ya utendaji na uchanganuzi wa mapato. .

Programu ya API

Zaidiview
Programu ya API mwanzoni inaangazia injini ya uchanganuzi wa kwingineko na imepanuka na kujumuisha injini zingine za uchanganuzi, bidhaa na API kutoka vitengo tofauti vya biashara.

Mpango huo hutoa yafuatayo:

• Utiririshaji wa moja kwa moja wa API ya Ujumbe wa Muamala

API zote zimepangishwa chini ya https://api.factset.com. Uthibitishaji unashughulikiwa kwa kutumia Funguo za API, na uidhinishaji unashughulikiwa kwa kutumia bidhaa ya usajili ya ndani ya FactSet. Kwa maelezo zaidi kuhusu kutumia Funguo za API, tafadhali tembelea https://developer.factset.com/authentication.

Tafadhali kumbuka kuwa ombi la HTTP na majina ya vichwa vya majibu yanapaswa kuzingatiwa kama hali isiyojali kulingana na Kiwango cha HTTP. Inapendekezwa kutotegemea ulinganifu wa vichwa vya kichwa katika msimbo wako ambao ni nyeti sana.

Maagizo ya Matumizi ya Bidhaa

DSoTM API

Kuwasilisha Rekodi

• Ili kuwasilisha rekodi za miamala, tumia ncha ifuatayo:
• POST /analytics/dsotm/v1/transactions

Omba Vichwa

1. Uidhinishaji
   Kijajuu cha kawaida cha HTTP. Thamani inahitaji kutumia umbizo la 'Msingi'.
2. Aina ya Maudhui
   Kijajuu cha kawaida cha HTTP. Thamani inahitaji kubainishwa kama programu/JSON ili kuonyesha kuwa mwili uko katika umbizo la JSON.

Kutatua matatizo
Kwa maelezo ya utatuzi, tafadhali rejelea sehemu ya 4 ya Mwongozo na Marejeleo ya Msanidi Programu.

Uboreshaji wa Toleo
Maelezo kuhusu uboreshaji wa matoleo yanaweza kupatikana katika sehemu ya 5 ya Mwongozo na Marejeleo ya Msanidi Programu.

Maswali Yanayoulizwa Mara kwa Mara

• Swali: Je, madhumuni ya API ya Utiririshaji wa Moja kwa Moja wa Ujumbe wa Muamala ni nini?
  Jibu: Madhumuni ya API ya Utiririshaji wa Moja kwa Moja wa Ujumbe wa Muamala ni kuunganisha data ya biashara kutoka kwa mtoa huduma yeyote wa OMS na Mfumo wa Usimamizi wa Kwingineko wa FactSet kwa uangalizi wa kwingineko, uigaji wa biashara, maelezo ya utendaji na uchanganuzi wa mapato.
• Swali: Ninaweza kupata wapi maelezo zaidi kuhusu kutumia Funguo za API?
  J: Maelezo zaidi kuhusu kutumia Vifunguo vya API yanaweza kupatikana https://developer.factset.com/authentication.

Kuhamasisha

Mnamo 1997, FactSet ilizindua Uchambuzi wa Portfolio 1.0, ambao uliweka msingi wa Uchanganuzi. Muda mfupi baadaye, Uchanganuzi wa Portfolio 2.0 ulijumuisha uchanganuzi wa hatari kutoka kwa wachuuzi wengine, na kisha kupanuliwa na kujumuisha Mapato Yasiyobadilika mnamo 2004. FactSet sasa inatoa safu dhabiti ya bidhaa za uchanganuzi wa mali nyingi ambazo huongoza soko katika kubadilika, uchanganuzi na upana. Leo, wateja wanategemea FactSet kwa uchanganuzi shirikishi kupitia bidhaa mbalimbali, kama vile Uchanganuzi wa Kwingineko (PA), SPAR, Jaribio la Alpha, Viboreshaji na Dashibodi ya Kwingineko, pamoja na usambazaji wa takwimu kupitia Portfolio Batcher, Publisher Flat. Files, na Mchapishaji hati.

Programu ya API

Zaidiview

Wateja wamekuwa wakielekea kujenga suluhu maalum, wakisukumwa na hitaji la kuongeza tija kwa kujumuisha taarifa katika matumizi ya mtumiaji mmoja. Kwa kufichua uchanganuzi, utendakazi na hatari kupitia API, hukupa chaneli ya kisasa ili kuingiliana na uchanganuzi wa mali nyingi wa FactSet. Soko linapoendelea kudai uwazi zaidi na data, FactSet itatoa chaguo rahisi kukidhi mahitaji hayo. API hukamilisha matoleo ya sasa ya uchanganuzi na kuwezesha ushirikiano kwa kukuruhusu kuunda hali ya utumiaji ya faragha, kuunganishwa na zana za BI za wahusika wengine kama vile Tableau, na vifurushi vya takwimu za watu wengine kama RStudio, na kuongeza udhibiti wa matumizi ya ndani ya uchanganuzi kutoka FactSet.

Ya kwanza stage ya kufichua API za Analytics itazingatia injini ya uchanganuzi wa kwingineko. Tangu kuanzishwa kwake, programu imepanuka na kujumuisha injini za uchanganuzi, bidhaa na API kutoka vitengo vingine vya biashara.

Mpango huo hutoa yafuatayo:

• Zana ya msanidi ili kujenga uthibitisho wa dhana
• Hisia sawa katika API zote za kiwango cha biashara za FactSet
• Kuzingatia viwango vya tasnia
• API zilizotolewa
• Nyaraka na mafunzo ya kina kwenye tovuti ya msanidi programu

Utiririshaji wa moja kwa moja wa API ya Ujumbe wa Muamala

• Unganisha rekodi kutoka kwa mtoa huduma yeyote wa OMS ili kuunganisha data yako ya biashara na Mfumo wa Usimamizi wa Portfolio wa wakati halisi wa FactSet (PMP) kwa ajili ya usimamizi wa kwingineko na uigaji wa biashara, au zitumike katika Injini yenye nguvu ya Uchanganuzi wa Kwingineko kwa Uchanganuzi wa Utendaji na Urejeshaji.
• API zote zimepangishwa chini ya https://api.factset.com. Uthibitishaji unashughulikiwa kwa kutumia Funguo za API na uidhinishaji unashughulikiwa kwa kutumia bidhaa ya usajili ya ndani ya FactSet. Unaweza kupata maelezo zaidi kuhusu kutumia Vifunguo vya API kwa https://developer.factset.com/authentication.

Majina ya vichwa vya ombi la HTTP na majibu yanapaswa kuzingatiwa kama hali isiyojali kulingana na Kiwango cha HTTP. Tafadhali usitegemee ulinganifu ambao ni nyeti kwa kadiri ya vichwa katika msimbo wako.

Kuwasilisha Rekodi

Wasilisha Miamala
POST /analytics/dsotm/v1/transactions

Mwisho huu unakubali rekodi za muamala na kuziandika kwa wakati mmoja kwa OMS_OFDB ya kwingineko maalum na kuzifanya zipatikane katika programu ya PMP.

Omba Vichwa

Jina la kichwa	Maelezo
Uidhinishaji	Kijajuu cha kawaida cha HTTP. Thamani inahitaji kutumia 'Basic 'muundo.
Maudhui-Aina	Kijajuu cha kawaida cha HTTP. Thamani inahitaji kubainisha programu/JSON (yaani, mpiga simu anahitaji kubainisha kuwa mwili uko katika umbizo la JSON).

Mwili wa Ombi
Mwili wa ombi unakubali mkusanyiko wa vigezo vya hesabu. Vigezo vimeainishwa hapa chini:

Jina la kigezo	Aina ya data	Inahitajika	Maelezo	Umbizo
utekelezaji	Safu	Hapana	Orodha ya rekodi za utekelezaji	Sehemu za kina za rekodi zinapatikana hapa
uwekaji	Safu	Hapana	Orodha ya rekodi za uwekaji	Sehemu za kina za rekodi zinapatikana hapa
maagizo	Safu	Hapana	Orodha ya rekodi za agizo	Sehemu za kina za rekodi zinapatikana hapa

Vichwa vya majibu 

Jina la kichwa	Maelezo
Ombi la X-DataDirect-Ufunguo	Kichwa cha ufunguo wa ombi la FactSet.
X-FactSet-Api-Request-Key	Ufunguo wa kutambua ombi la API ya Uchanganuzi kwa njia ya kipekee. Inapatikana tu baada ya uthibitishaji uliofaulu.
X-FactSet-Api-RateLimit-Limit	Idadi ya maombi yanayoruhusiwa kwa dirisha la saa.
X-FactSet-Api-RateLimit-Remaining	Idadi ya maombi yaliyosalia kwa dirisha la saa.
X-FactSet-Api-RateLimit-Rudisha	Idadi ya sekunde zilizosalia hadi kiwango cha juu kiweke upya.

Inarudi

Msimbo wa hali ya HTTP	Maelezo
202	Jibu linalotarajiwa.
400	Kiini cha POST si sahihi.
401	Uthibitishaji haupo au batili.
403	Mtumiaji amepigwa marufuku na vitambulisho vya sasa.
415	Kijajuu cha Aina ya Maudhui kinakosekana/Batili. Kijajuu kinahitaji kuwekwa kuwa application/json.
429	Kiwango cha juu cha ada kilifikiwa. Jaribu tena maombi baada ya kusubiri muda uliobainishwa kwenye kichwa cha kujaribu tena.
500	Hitilafu ya seva. Ingia kichwa cha X-DataDirect-Request-Key ili kusaidia katika utatuzi wa matatizo.
503	Muda wa ombi umekwisha. Jaribu ombi tena baada ya muda fulani.

Maoni
Upeo wa maombi 50 ya POST unaruhusiwa katika dirisha la sekunde 5 kwa kila API. Vile vile vinaweza kuthibitishwa kwa kutumia vichwa mbalimbali vya Rate-Limit vinavyopatikana kwenye jibu la API.

• X-FactSet-Api-RateLimit-Limit - Idadi ya maombi yanayoruhusiwa kwa dirisha la saa.
• X-FactSet-Api-RateLimit-Remaing - Idadi ya maombi yaliyosalia kwa dirisha la muda.
• X-FactSet-Api-RateLimit-Reset - Idadi ya sekunde zilizosalia kabla ya kuweka upya kikomo cha kiwango.

Exampchini

Ombi:
POST https://api.factset.com/analytics/dsotm/v1/transactions.

Vichwa vya habari:

• aina ya maudhui: maombi/json
• Uidhinishaji: Msingi RkRTX0RFTU9fVVMt**********************************
• Kubali-Usimbaji: gzip
• urefu wa maudhui: 201

Mwili:

Jibu:
HTTP 202 Imekubaliwa

Vichwa vya habari:

• ufunguo wa ombi la moja kwa moja la x-data: zpdo6aebv58fiaoi
• x-factset-api-request-key: 6p2d41m4sw1yfh0h

Viwanja vya Rekodi

Uundaji wa Utekelezaji

Kipengele	Aina	Maelezo	Lazima
kwingineko	Kamba	Jina la kwingineko. Mf: MTEJA:/DEMO.OFDB	NDIYO
kitambulisho cha muamala	Kamba	Kitambulisho cha kipekee cha muamala	NDIYO
ishara	Kamba	Alama inayolingana na chombo kinachouzwa. Mfano: AAPL	NDIYO
maelezo	Kamba	Kwa kawaida jina, Mf: FACTSET RESEARCH SYSTEMS, lakini linaweza kufafanua zaidi vizio.	NDIYO
aina ya biashara	Kamba	BL (Nunua Muda Mrefu), BC (Nunua hadi kufunika), SL (Uza Muda Mrefu) na SS (Uza Fupi)	NDIYO
hali	Kamba	ACCT au CNCL, kifupi cha ACCOUNTED na CNCELED	NDIYO
tarehe ya biashara	Kamba	Tarehe ya biashara ambayo iko katika umbizo la YYYYMMDD	NDIYO
majani ya shughuli	Kuelea	Hisa ambazo zimeagizwa na hazijatekelezwa	HAPANA
kiasi	Kuelea	Kiasi cha chombo kilichouzwa	NDIYO
wavu	Kuelea	Thamani ya pesa taslimu ya shughuli, jumla ya gharama za udalali.	NDIYO
jumla	Kuelea	Thamani ya pesa taslimu ya muamala, ikijumuisha gharama za udalali.	NDIYO
Thamani ya makazi	Kuelea	Thamani ya pesa taslimu ya muamala ni thamani ambayo imezidishwa na kiwango kinachotumika cha FX ili kubadilisha muamala uliowekwa katika sarafu ya nchi kuwa sarafu ya kuripoti.	NDIYO
tarehe ya malipo	Kamba	Tarehe ya malipo katika umbizo la YYYYMMDD	NDIYO
sarafu	Kamba	Msimbo wa sarafu wa sehemu zinazothaminiwa pesa taslimu, Kiasi Halisi na Jumla ya Jumla.	NDIYO
kiwango cha fedha za kigeni	Kuelea	Kiwango cha FX ambacho kinaweza kuchukuliwa na PA, kikizidishwa na sehemu zinazothaminiwa pesa taslimu, Net, Gross, ili kuruhusu PA kuonyesha miamala katika sarafu ya kuripoti.	HAPANA
sarafu ya makazi iso	Kamba	Msimbo wa sarafu wa Thamani ya Makazi	NDIYO
kuamuru	Kamba	Kitambulisho cha kipekee cha Agizo hutolewa na PM Hub. Mfano: O_FDS_010623_1686393260254	HAPANA
mzaziId	Kamba	Kitambulisho cha kipekee cha Agizo la Mzazi litakalotolewa na OMS.	HAPANA

Uundaji wa Agizo

Kipengele	Aina	Maelezo	Lazima
kwingineko	Kamba	Jina la kwingineko. Mf: MTEJA:/DEMO.OFDB	NDIYO

kitambulisho cha muamala	Kamba	Kitambulisho cha kipekee cha muamala	NDIYO
ishara	Kamba	Alama inayolingana na chombo kinachouzwa. Mfano: AAPL	NDIYO
maelezo	Kamba	Kwa kawaida jina, Mf: FACTSET RESEARCH SYSTEMS, lakini linaweza kufafanua zaidi vizio.	NDIYO
aina ya biashara	Kamba	BL (Nunua Muda Mrefu), BC (Nunua hadi kufunika), SL (Uza Muda Mrefu) na SS (Uza Fupi)	NDIYO
hali	Kamba	ACCT au CNCL, kifupi cha ACCOUNTED na CNCELED	NDIYO
tarehe ya biashara	Kamba	Tarehe ya biashara ambayo iko katika umbizo la YYYYMMDD	NDIYO
shughuli-majani	Kuelea	Hisa ambazo zimeagizwa lakini hazijatekelezwa	HAPANA
kiasi	Kuelea	Kiasi cha chombo kilichouzwa	NDIYO
sarafu iso	Kamba	Msimbo wa sarafu wa sehemu zinazothaminiwa pesa taslimu, Kiasi Halisi na Jumla ya Jumla.	NDIYO
kiwango cha fedha za kigeni	Kuelea	Kiwango cha FX ambacho kinaweza kuchukuliwa na PA, kikizidishwa na sehemu zinazothaminiwa pesa taslimu, Net, Gross, ili kuruhusu PA kuonyesha miamala katika sarafu ya kuripoti.	HAPANA
kitambulisho cha agizo	Kamba	Kitambulisho cha kipekee cha Agizo hutolewa na PM Hub. Mfano: O_FDS_010623_1686393260254	HAPANA

Uundaji wa Uwekaji

Kipengele	Aina	Maelezo	Lazima
kwingineko	Kamba	Jina la kwingineko. Mf: MTEJA:/DEMO.OFDB	NDIYO
kitambulisho cha muamala	Kamba	Kitambulisho cha kipekee cha muamala	NDIYO
ishara	Kamba	Alama inayolingana na chombo kinachouzwa. Mfano: AAPL	NDIYO
maelezo	Kamba	Kwa kawaida jina, Mf: FACTSET RESEARCH SYSTEMS, lakini linaweza kufafanua zaidi vizio.	NDIYO
aina ya biashara	Kamba	BL (Nunua Muda Mrefu), BC (Nunua hadi kufunika), SL (Uza Muda Mrefu) na SS (Uza Fupi)	NDIYO
hali	Kamba	ACCT au CNCL, kifupi cha ACCOUNTED na CNCELED	NDIYO
tarehe ya biashara	Kamba	Tarehe ya biashara ambayo iko katika umbizo la YYYYMMDD	NDIYO
shughuli-majani	Kuelea	Hisa ambazo zimeagizwa lakini hazijatekelezwa	HAPANA
kiasi	Kuelea	Kiasi cha chombo kilichouzwa	NDIYO
sarafu iso	Kamba	Msimbo wa sarafu wa sehemu zinazothaminiwa pesa taslimu, Kiasi Halisi na Jumla ya Jumla.	NDIYO

kiwango cha fedha za kigeni	Kuelea	Kiwango cha FX ambacho kinaweza kuchukuliwa na PA, kikizidishwa na sehemu zinazothaminiwa pesa taslimu, Net, Gross, ili kuruhusu PA kuonyesha miamala katika sarafu ya kuripoti.	HAPANA
sarafu ya makazi iso	Kamba	Msimbo wa sarafu wa Thamani ya Makazi	NDIYO
kitambulisho cha agizo	Kamba	Kitambulisho cha kipekee cha Agizo hutolewa na PM Hub. Mfano: O_FDS_010623_1686393260254	HAPANA
kitambulisho cha mzazi	Kamba	Kitambulisho cha kipekee cha Agizo la Mzazi litakalotolewa na OMS.	HAPANA

Kutatua matatizo

Hatua zifuatazo zinapendekezwa ili kutatua makosa kutoka kwa API yoyote tofauti:

• Rekodi kichwa cha majibu cha X-DataDirect-Request-Key ili timu ya uhandisi ya API ya FactSet iweze kuchanganua ombi/jibu lako mahususi.
• Rekodi mwili wa majibu wakati jibu ni jibu la hitilafu. Misimbo yote ya hali ya HTTP sawa na zaidi ya 400 inachukuliwa kuwa majibu ya hitilafu.
• Wasiliana na timu ya akaunti yako na maelezo hapo juu kwa usaidizi.

Uboreshaji wa Toleo

• FactSet itasaidia matoleo ya zamani ya API kwa muda mfupi. Wakati halisi wa usaidizi utategemea API na toleo la stage (yaani, beta au uzalishaji). Mabadiliko yote yanayokiuka, nyongeza za utendaji, na urekebishaji wa hitilafu katika matoleo yote ya awali yatarekodiwa kwenye logi ya mabadiliko.
• Timu ya uhandisi ya API ya FactSet itafanya kazi na wateja ili kuhakikisha mabadiliko ya haraka kwa matoleo mapya zaidi.

Hakimiliki © 2023 FactSet Research Systems Inc. Haki zote zimehifadhiwa.

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

Nyaraka / Rasilimali

Utiririshaji wa Moja kwa Moja wa Programu ya API ya Ujumbe wa Muamala wa FACTSET [pdf] Mwongozo wa Mtumiaji Toleo la 1.0, Programu ya API ya Utiririshaji wa Ujumbe wa Muamala, Programu ya API ya Utiririshaji wa Ujumbe wa Muamala, Programu ya API ya Ujumbe wa Muamala, Programu ya API ya Messages, Programu ya API, Programu

Marejeleo

• Mwongozo wa Mtumiaji