Comparáid
Fáilte go dtí an lárionad doiciméadúcháin oifigiúil don API Comparáide, réiteach a cruthaíodh go speisialta a athraíonn an tasc is minic is mothaithe de rialú leagain scarbhileog go sreabhadh oibre éifeachtach, dírithe ar fhorbróirí. Cibé is anailíseoir sonraí atá ag comhoiriúint tuarascálacha ráithleacha, baill foirne airgeadais atá ag rianú athruithe buiséid, nó innealtóir bogearraí atá ag cur cumais difear i bhfeidhm i bpíblíne sonraí níos mó, tá an API seo deartha chun teacht ar do shuíomh agus chun an bhrath tomhais a bhaint ó aimsiú athruithe ar fud réimse leathan de fhormáidí scarbhileog. Ag a croí, leanann an API Comparáide samhail simplí ach cumhachtach: sholáthraíonn tú beirt comhad foinse—cibé a thagann ó Apple Numbers, onnmhairiú CSV/TSV, nó an tsraith Excel (.xlsx, .xls) is coitianta—agus tugann an tseirbhís comhad toradh singil a thaispeánann gach breis, scrios, agus athrú le leideanna amhairc soiléire. Ní amháin le bheith tar éis meabhrach an béim ar shoiléireacht; déanann an difríocht a nótaíocht ar bhealach a léiríonn traidisiúin dhúchasacha scarbhileog (cúlraí cealla dathaithe, buicíní nótaí, agus marcóirí ró/colún) ionas gur féidir le húsáideoirí deiridh an toradh a oscailt ina n‑aipliicíocht roghnaithe agus tuiscint láithreach a fháil ar an méid a d'athraigh. Seachas an difríocht bhunúsach, coimeádann an API an fhormáidiú bunaidh, foirmlí, agus cineálacha sonraí, ag cinntiú nach bhfuil an t‑aschur ach tuarascáil simplí ach leabhar oibre go hiomlán feidhmiúil réidh le haghaidh anailíse breise nó dáileadh. Tá slándáil agus feidhmíocht bruite isteach i ngach iarratas: déanann gach aistriúchán comhad thar TLS 1.3, próiseálfar comhaid i gcoimeádáin scartha le teorainneacha cuimhne dian, agus de ghnáth tugtar na torthaí i bhfoil siar de réir soicind le haghaidh comhad suas le 10 MB, ag scála go réasúnta d’fhoinní sonraí níos mó trí shruthú inbhriste. Tá an doiciméadú atá á léamh agat anois eagrú chun do thús a chur i bhfeidhm i nóiméid—ag tosú le fíordheimhniú, dul tríd thógáil iarratas, agus críochnú le patrúin dea‑chleachta do láithriú earráidí, leathanachú, agus intagraisc webhook. Le linn na tréimhse, gheobhaidh tú slabhraí cód i Python, JavaScript, Java, agus C#, ag léirigh conas is féidir le líne amháin de chód tiontú comhoiriúnú iomlán, chomh maith le timpeallacht bosca gainimh ina bhféadfá triail a bhaint as comhaid fíor gan imeacht as do bhrabhsálaí. Trí dheireadh an treorach seo, beidh tuiscint láidir agat ar conas comhoiriúnú scarbhileog iontaofa, ard-dheifriú a leabú i ndéantóir oibre ar bith, am athbhreithnithe láimhe a laghdú, agus páirtithe leasmhara a chumhachtú le logaí athruithe trédhearcach, iniúchtha—ar an nasc leis an API atá chomh slán agus a luath mar a bhfuil sé furasta a úsáid.
Príomhghnéithe
Tá raon leathan gné Eochair ag an API Comparáide a fhreagraíonn ar na pointí pian is coitianta a thagann chun cinn nuair a dhéanann tú comhoiriúint sonraí scarbhileog thar ardáin éagsúla. Ar dtús báire, tacaíonn an API le liosta cuimsitheach de fhormáidí comhad: Apple Numbers (.numbers), comhaid teoranta téacs simplí (CSV, TSV), Excel oidhreachta (.xls), agus Excel nua-aimseartha (.xlsx). Cuireann sé seo deireadh le gá le huirlisí réamh‑aithchóireachta, ag tabhairt deis duit na comhaid bhunaidh a chur go díreach isteach sa tseirbhís. Oibriúann an t‑inneall difríochta ag leibhéal na cealla, ag braith athruithe i luachanna, foirmlí, agus fiú tréithe formáidithe mar stíl chló, scíthú cealla, agus rialacha bailíochtú sonraí; leagann sé béim soilséir ar gach athrú sa leabhar oibre toradh ag baint úsáide as scéimeanna dath inúsáidte, rud a dhéanfadh sé éasca d’innéacsairí neamh‑teicniúla na ntoradh a léirmhíniú. Le haghaidh tacair sonraí scála mhóra, tairgeann an API mód comhoiriúnú incrimintigh, ag ligean duit ach na rótaí a cuireadh leis nó a mhairíodh ó bhunphointe roimhe a chur i gcomparáid, ag laghdú am próiseála agus bandaleithead líonra. Fuinneog, is féidir leat achoimre struchtúrtha JSON de athruithe a iarraidh i bhreise leis an gcomhad difríochta amhairc, ag cumasú uathoibriú sluaghithí mar spreagadh foláirimh, nuashonrú painéil, nó cur athruithe isteach i chórais rialúcháin leagain. Áirítear ar ghnéithe slándála fíordheimhniú le comharthar token OAuth 2.0, eochracha API scóipithe, agus liostú bán IP roghnach, agus cé go bhfuil sonraí ag fostaíocht criptithe le AES‑256. Bíonn an seirbhís ag cloí le caighdeáin comhlíonta GDPR agus CCPA, rud a thugann muinín duit nuair a láimhseáiltear faisnéis phearsanta nó airgeadais íogair. Ó thaobh feidhmíochta de, tá an API deartha le latence íseal; buíochas le scálú cothrománach agus algartaim difríochta i d’cuimhne, críochnúchann formhór na gcomhoiriúnachtaí i níos lú ná soicind amháin do leabhair oibre de mhéid gnáth, le tacaíocht le haghaidh próiseáil as sioncrónach trí webhooks do chomhaid a sháróidh 50 MB. Faoin deiridh, tá taithí an fhorbróra mar phríomhsprioc: sonraíochtaí cuimsitheacha OpenAPI, SDKanna a ghintear go huathoibríoch, cóid earráide mionsonraithe, agus cinn iarmhéadaithe ráta fíor‑ama a chuireann cumhacht ort an API a iondú le mín lámh, agus ag an am céanna léiríonn ár gconsól bosca gainimh agus stóras mór samplaí cur i bhfeidhm dea‑chleachta le haghaidh próiseáil bhaisc, píblíneanna CI/CD, agus feidhmeanna gan freastal. I mbe láthair gearr, soláthraíonn an API Comparáide cumais difríochta scarbhileog tapa, slán, agus cairdiúil don fhorbróir a ligeann duit athruithe a aimsiú le glaoch simplí amháin—géarchéim ar bith ar fhormáid, mhéid, nó castaíocht na sonraí atá á lámhú agat.
Doiciméid
Paraiméadair
- format: Formáid comhaid aschurtha a dtacaítear leis.
- UploadFileRequest.OperationId: Seo í aitheantas oibríochta.
- UploadFileRequest.Files: Seo iad na comhaid a chaithfidh tú a uasluchtú chuig ár seirbhísí ar líne; is féidir leat an sonraí a ullmhú ar do nós féin ach caithfidh sé cloí le caighdeán an chomhaid ionchuir HTML.
Úsáid an Críochphointe
-
Cuir iarratas a chuimsíonn na comhaid agus an comhartha rochtana API Comparáide
curl -X 'POST' \ 'https://api.sheetize.cloud/comparison/to-xlsx' \ -H 'accept: text/plain' \ -H 'Authorization: Bearer TheAccessToken' \ -H 'Content-Type: multipart/form-data' \ -F 'UploadFileRequest.Files=@TheFileOne.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' \ -F 'UploadFileRequest.Files=@TheFileTwo.xlsx;type=application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' -
Freagraíonn an tseirbhís le URL íoslódála don chomhad próiseáilte, sa shampla seo é:
{ "name": "", "type": "1", "size": 900000, "description": "", "linkToDownload": "/download/TheFolderName/TheFileName.xlsx", "message": "", "statusCode": 200 } -
Cuir iarratas a chuimsíonn ainm an chomhaid agus ainm an fhillteáin chuig API Íosluchtaithe
curl -X 'GET' \ 'https://api.sheetize.cloud/download/TheFolderName/TheFileName.xlsx' \ -H 'accept: */*' \ -H 'Authorization: Bearer TheAccessToken' - Gheobhaidh tú an comhad agus is féidir leat é a úsáid nó é a chur ar aghaidh go simplí chuig an gcéim eile de do shruth oibre.
