Muunganisho wa Wasanidi Programu na AI

Unganisha FTIR.fun kwa Zana yoyote ya AI au Programu

Washa msaidizi wako wa AI au msimbo wako mwenyewe uweze kufikia zaidi ya spektra 130,000 za marejeleo, ufahamu wa kilele cha grafu ya maarifa, na tafsiri inayoungwa mkono na fasihi. Chagua njia moja kati ya tatu za kuunganisha — MCP kwa wasaidizi wa AI, API ya REST kwa msimbo, au Ujuzi uliotengenezwa tayari kwa majukwaa yasiyo ya msimbo. Kila njia hapa chini ina maagizo ya hatua kwa hatua yaliyoandikwa kwa watumiaji wa mara ya kwanza.

1. Chagua njia yako 2. Usanidi wa MCP 3. API ya REST 4. Ujuzi na programu-jalizi 5. Kile AI yako inaweza kufanya 6. Utatuzi wa matatizo

Imekaguliwa na kuorodheshwa kwenye

A Anthropic MCP Registry ✓ S Smithery ✓ M MCP.so ✓ Py PyPI ✓ n8n npm ✓

Kabla ya kuanza — pata ufunguo wako wa API

MCP na REST API zote zinatumia ufunguo mmoja wa API wa FTIR.fun. Coze/Doubao hutumia ufunguo wa huduma uliosanidiwa na mchapishaji wa programu-jalizi, kwa hivyo watumiaji wa mwisho hawaweki ufunguo wa kibinafsi. Kupata ufunguo wa kibinafsi huchukua kama dakika moja:

Ingia kwenye FTIR.fun Unda akaunti ya bure ikiwa huna. Akaunti mpya zinajumuisha mikopo ya majaribio ya bure.
Fungua dashibodi ya Funguo za API Nenda kwa Akaunti → Funguo za API na bofya Generate.
Nakili na uhifadhi ufunguo mara moja Ufunguo kamili (unaoanza na ftir_) unaonyeshwa mara moja tu. Hifadhi mahali salama. Ukikosa, tengeneza mpya tu.

🔑 Uko tayari? Fungua Dashibodi ya Funguo za API katika kichupo kipya, kisha rudi na ufuate njia uliyochagua hapo juu.

⚠️ Seva ya MCP iliyowekewa inakubali tu ufunguo wa API wa akaunti uliozalishwa kwenye FTIR.fun API Keys Dashboard (huanza na ftir_). Funguo kuu za upande wa seva ni za waendeshaji wa REST na haziwezi kuingia katika MCP iliyowekewa.

Hatua ya 1 — Ni muunganisho gani unaofaa kwako?

Zote tatu zinaunganisha kwa injini moja: spectra 130,000+, fikra za grafu ya maarifa, na nukuu za fasihi. Unahitaji moja tu. Chagua kwa jinsi unavyofanya kazi — huna uhakika? MCP ndio chaguo maarufu zaidi kwa mtu yeyote anayetumia wasaidizi wa AI.

MCPNjia A — Seva ya MCP

MCP (Itifaki ya Muktadha wa Modeli) ndiyo njia ya kawaida kwa wasaidizi wa AI kuita zana za nje. FTIR.fun huendesha seva ya MCP iliyopangishwa — huna kusakinisha au kuendesha chochote kwenye eneo lako. Unaongeza usanidi mmoja mdogo kwa mteja wako wa AI, ingiza ufunguo wako wa API, na msaidizi wako anapata zana saba za FTIR.

✓ Jinsi kuingia kunavyofanya kazi (soma hii kwanza): FTIR.fun inathibitisha kwa ufunguo wa API kutoka kwa akaunti yako, unaotumwa kama kichwa cha Authorization: Bearer. Hakuna kuingia kwa kivinjari cha OAuth na hakuna ukurasa tofauti wa uidhinishaji. Ikiwa mteja atajaribu kufungua ukurasa wa wavuti wa uidhinishaji, anatumia usanidi wa kizamani — tazama Utatuzi wa matatizo hapa chini.

Chagua mteja wako kwa hatua sahihi:

Sanidi FTIR.fun MCP katika VS Code

Inahitaji VS Code ya sasa iliyo na GitHub Copilot Chat katika hali ya Agent.

Fungua mradi wako, kisha unda faili .vscode/mcp.json Ndani ya folda ya mradi wako, tengeneza folda inayoitwa .vscode (ikiwa haipo) na faili inayoitwa mcp.json ndani yake. Unataka FTIR.fun ipatikane katika kila mradi? Weka JSON hiyo hiyo katika mipangilio ya kiwango cha mtumiaji: fungua Command Palette, tafuta ＇Preferences: Open User Settings (JSON)＇, na ongeza ingizo la mcp.servers hapo badala yake.

Bandika usanidi huu halisi Nakili kama ilivyo. Usibadilishe sehemu ya ${input:...} na ufunguo wako halisi — VS Code itauliza ufunguo kwa usalama seva inapoanza.

.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "ftirfun-api-key",
      "description": "FTIR.fun API key",
      "password": true
    }
  ],
  "servers": {
    "ftirfun": {
      "type": "http",
      "url": "https://ftir.fun/mcp",
      "headers": {
        "Authorization": "Bearer ${input:ftirfun-api-key}"
      }
    }
  }
}

Anzisha seva ya ftirfun Fungua Palette ya Amri, endesha “MCP: List Servers”, chagua ftirfun, na uchague Anza. Matoleo mengine ya VS Code yanaonyesha kitendo cha Anza juu ya seva kwenye mcp.json — hiyo inafanya kazi pia.
Bandika ufunguo wako wa API pekee unapoombwa Wakati VS Code inaomba ftirfun-api-key, bandika tu ufunguo halisi (unaanza na ftir_).
Thibitisha imeunganishwa Fungua Copilot Chat katika hali ya Agent na uangalie orodha ya zana. FTIR.fun inapaswa kuonyesha zana saba. Kisha jaribu prompt ya jaribio hapa chini.
```
Use FTIR.fun to explain the FTIR peak at 1715 cm-1.
```

💬 Uliweza kuona ukurasa wa idhini au kosa ＂ukurasa wa idhini haupo＂? Hiyo ilikuwa usanidi wa zamani wa mtindo wa OAuth. Futa ingizo la zamani la ftirfun, bandika JSON hapo juu, pakia upya VS Code, na ianzishe tena. Suluhisho kamili kwenye Troubleshooting.

Sanidi FTIR.fun MCP katika Claude

Imeorodheshwa rasmi kwenye Sajili ya MCP ya Anthropic. Inafanya kazi katika Claude Desktop na Claude Code.

Fungua mipangilio ya seva ya MCP Katika Claude Desktop, nenda kwa Mipangilio → Viunganishi → Ongeza kiunganishi maalum. Katika Claude Code, hariri faili yako ya usanidi wa MCP.
Ongeza seva ya mbali na kichwa cha Bearer Tumia URL inayopangishwa na ongeza ufunguo wako wa API kama sehemu ya Authorization header. Badilisha nafasi na ufunguo wako halisi (unaanza na ftir_).
Seva ya MCP ya mbali
```
URL: https://ftir.fun/mcp
Header: Authorization: Bearer ftir_your_key_here
```
Anzisha upya Claude na uthibitishe Anzisha upya Claude Desktop, fungua paneli ya viunganishi/zana, na uhakikishe zana za FTIR.fun zinaonekana. Kisha uliza swali kwa lugha ya kawaida.
```
Identify this polymer from its FTIR peaks: 2915, 1715, 1450 cm-1.
```

📎 Unapendelea Claude Code CLI? Endesha claude mcp add --transport http ftirfun https://ftir.fun/mcp --header ＂Authorization: Bearer ftir_your_key_here＂.

Sanidi FTIR.fun MCP katika Cursor

Hariri usanidi wa MCP wa Cursor ili kihariri chako cha msimbo cha AI kiweze kuita FTIR.fun bila kuondoka kwenye IDE.

Fungua faili ya usanidi wa MCP Unda au hariri ~/.cursor/mcp.json (kimataifa) au .cursor/mcp.json ndani ya mradi wako.

Bandika kizuizi cha seva Badilisha nafasi ya kishika nafasi na ufunguo wako halisi (huanza na ftir_).

~/.cursor/mcp.json

{
  "mcpServers": {
    "ftirfun": {
      "url": "https://ftir.fun/mcp",
      "headers": {
        "Authorization": "Bearer ftir_your_key_here"
      }
    }
  }
}

Pakia upya Cursor na uthibitishe Fungua tena Cursor, angalia Mipangilio → MCP kwa seva ya ftirfun na hali yake ya kijani, kisha uliza kwenye gumzo.

Sanidi MCP ya FTIR.fun katika Codex au mfumo wowote wa MCP

Inafanya kazi na OpenAI Codex na mteja yeyote anayeweza kuendana na MCP anayesaidia seva za HTTP za mbali.

Ongeza seva kwenye usanidi wako wa Codex Elekeza mteja kwenye URL iliyopangishwa na uhakikishe inatuma ufunguo wako wa API kama kichwa cha Bearer. Badilisha sehemu ya nafasi na ufunguo wako halisi.
~/.codex/config.toml
```
[mcp_servers.ftirfun]
url = "https://ftir.fun/mcp"
http_headers = { Authorization = "Bearer ftir_your_key_here" }
```
Anzisha upya na uhakikishe zana zinapakia Anzisha upya kiteja na uthibitishe kuwa zana saba za FTIR.fun zimeorodheshwa kabla ya kuomba.

Sanidi FTIR.fun MCP katika Gemini CLI

Ongeza FTIR.fun kwa mteja wa Gemini anayeweza MCP kwa kutumia URL iliyopangishwa sawa na kichwa cha Bearer.

Hariri ~/.gemini/settings.json Ongeza ingizo la seva la httpUrl lenye kichwa chako cha ufunguo wa API. Badilisha mahali pa kuweka na ufunguo wako halisi.
~/.gemini/settings.json
```
{
  "mcpServers": {
    "ftirfun": {
      "httpUrl": "https://ftir.fun/mcp",
      "headers": {
        "Authorization": "Bearer ftir_your_key_here"
      }
    }
  }
}
```
Anzisha upya Gemini CLI na uthibitishe Endesha /mcp kuorodhesha seva na kuthibitisha ftirfun imeunganishwa kabla ya kuuliza.

🧩 Unatumia mteja mwingine wa MCP? Mteja yeyote anayetumia seva ya mbali ya streamable-HTTP inafanya kazi: weka URL kwa https://ftir.fun/mcp na tuma Authorization: Bearer <your key>. Tazama kadi ya seva ya umma kwa schema kamili ya zana: server-card.json

✓ Baada ya muunganisho kufanikiwa, mteja wako wa AI anapaswa kuorodhesha zana hizi 7: parse_ftir_spectrum, analyze_ftir_spectrum, submit_ftir_report, get_ftir_report_status, explain_peaks, find_spectra, fetch_result. Ukiona zana chache au hakuna kabisa, angalia Utatuzi wa shida hapa chini.

APINjia B — API ya REST

Piga FTIR.fun kutoka kwa msimbo wako mwenyewe kwa lugha yoyote — Python, JavaScript, R, MATLAB, Java, Go. Sehemu za mwisho za HTTP za kawaida za kutambua spektra zisizojulikana, kuelezea kilele, kupata spektra za marejeleo, na kupata matokeo ya zamani kwa nambari ya ripoti. Bora kwa ujumuishaji wa LIMS, mifereji ya kundi, au kuongeza utafutaji wa FTIR kwa programu yako mwenyewe.

Angalia kuwa huduma ya REST iko mtandaoni Sehemu ya mwisho ya afya ni ya umma na haitumii pointi. Inapaswa kurudisha JSON iliyo chini. Ukiona ukurasa wa HTML au muda uliomalizika, huduma inaweza kuwa imeshuka kwa muda.
curl
```
curl https://ftir.fun/health
```
Jibu linalotarajiwa
```
{"status":"ok","service":"ftirfun-api"}
```
Thibitisha utambulisho kwa kichwa cha X-API-Key Kila endpoint iliyolindwa inachukua ufunguo wako katika kichwa cha X-API-Key. Sheria sawa za akaunti zinatumika kama katika programu ya wavuti: pointi, usajili, na mipaka ya kasi. Ikiwa ufunguo si sahihi au haupo, utapata kosa la 401 la JSON.
Kichwa cha uthibitishaji
```
X-API-Key: ftir_your_key_here
```

Fanya simu yako ya kwanza — tambua spectra isiyojulikana Tuma orodha ya kilele (au faili iliyopakiwa) na upate nyenzo za wagombeaji zilizoorodheshwa zenye alama za kufanana na ushahidi wa kilele. Kizuizi cha chaguo ni hiari — chaguo-msingi ni top_k=15 (masafa 1–50) na tolerance_cm1=8 (masafa 1–30).

curl

curl -X POST https://ftir.fun/ftir/analyze_spectrum \
  -H "X-API-Key: ftir_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"spectrum":{"type":"ftir","x_unit":"cm-1","y_unit":"absorbance","peaks":[3026,1600,1493,1452,756,697]},"options":{"top_k":5,"tolerance_cm1":8}}'

Python

import requests

resp = requests.post(
    "https://ftir.fun/ftir/analyze_spectrum",
    headers={"X-API-Key": "ftir_your_key_here"},
    json={
        "spectrum": {"type": "ftir", "x_unit": "cm-1", "y_unit": "absorbance",
                     "peaks": [3026, 1600, 1493, 1452, 756, 697]},
        "options": {"top_k": 5, "tolerance_cm1": 8},
    },
)
print(resp.json())

Mfano wa jibu la mafanikio (lililofupishwa)

{
  "success": true,
  "search_mode": "peak_only",
  "n_matches": 5,
  "confidence": 0.42,
  "confidence_source": "peak_match_score",
  "summary": "Peak-based FTIR matching ranks Styrene/acrylonitrile copolymer first...",
  "matches": [
    {"rank": 1, "name": "Styrene/acrylonitrile copolymer", "cas": "9003-54-7",
     "num": 119319, "score": 0.4214, "matched": 6}
  ],
  "evidence": ["3026 cm-1 -> alkyl C-H vibration (DOI 10.5650/jos.ess14201)"],
  "peak_explanations": [
    {"peak_cm1": 3026, "assignment": "alkyl C-H vibration",
     "evidence_type": "kg_peak_group"}
  ],
  "uncertainty": "The leading match is close to the runner-up..."
}

Gundua vituo vingine vya mwisho Rejeleo kamili linajumuisha kila kituo, miundo ya ombi na majibu, misimbo ya makosa, na sampuli zaidi za msimbo. Tazama Nyaraka za API.

Unachotaka	Sehemu ya mwisho	Ingizo
Tambua wigo usiojulikana	`POST /ftir/analyze_spectrum`	Mwili wa JSON ukiwa na spectrum.peaks au file_base64
Eleza kilele kimoja au zaidi	`POST /ftir/explain_peak_assignments`	Mwili wa JSON wenye orodha ya kilele au maandishi ya swala
Tafuta wigo wa marejeleo unaojulikana	`POST /ftir/find_spectra`	Mwili wa JSON wenye mfuatano wa swala
Pata matokeo ya zamani kwa nambari ya ripoti	`GET /ftir/result/{result_num}`	Kigezo cha njia, hiari ?language_code=en
Wasilisha ripoti kamili ya async, kisha ichunguze	`POST /ftir/reports` · `GET /ftir/reports/{task_id}`	Mwili wa JSON wenye file_base64 (inahitajika)
Changanua faili la chombo kuwa peaks	`POST /parse-spectrum`	Upakiaji wa faili wa sehemu nyingi AU JSON yenye file_base64

Rejeleo la vigezo muhimu

Kigezo	Aina	Chaguo-msingi	Masafa	Inatumiwa na
`top_k`	int	15	1–50	`analyze_spectrum`
`tolerance_cm1`	int	8	1–30	`analyze_spectrum`
`limit`	int	10	1–20	`find_spectra`
`sampling_mode`	string	(tupu)	Tazama orodha hapa chini	`reports`, `explain_peaks`
`language_code`	string	"en"	ISO 639-1	`reports`, `fetch_result`
`include_report`	bool	true	—	`get_ftir_report_status`

📘 Unaunda GPT maalum au unaingiza kwenye zana nyingine? Ingiza schema yetu ya OpenAPI moja kwa moja: openapi.platform.yaml.

Changanua faili ya chombo (njia mbili)

Kituo cha /parse-spectrum kinakubali upakiaji wa faili wa sehemu nyingi au mwili wa JSON wenye maudhui yaliyosimbwa kwa base64. Zote mbili hurudisha jibu sawa: kilele zilizogunduliwa na curve kamili.

Chaguo A: upakiaji wa faili wa sehemu nyingi

curl -X POST https://ftir.fun/parse-spectrum \
  -H "X-API-Key: ftir_your_key_here" \
  -F "file=@/path/to/sample.spc"

Chaguo B: JSON yenye base64

curl -X POST https://ftir.fun/parse-spectrum \
  -H "X-API-Key: ftir_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"file_base64": "V2F2ZW51bWJlci...", "filename": "sample.spc"}'

Jibu

{
  "peaks": [697, 756, 1028, 1452, 1493, 1600, 3026],
  "spectrum": [{"x": 400.0, "y": 0.023}, {"x": 401.0, "y": 0.024}, ...],
  "status": "ok",
  "error": null
}

SkillNjia C — Ustadi na Programu-jalizi

Kwa mifumo maarufu ya AI na otomatiki tunashehena vifurushi vilivyotengenezwa tayari, ili usilazimike kuandika simu za API kwa mkono. Sakinisha kifurushi au leta programu-jalizi, na FTIR.fun inakuwa jengo katika utiririsho wako wa kazi. Kila kadi hapa chini inakuambia nini hasa cha kuendesha au kuleta.

LangChain

Kifurushi cha Python · PyPI

Imechapishwa

Zana za kuingiza kwa ajili ya kujenga mawakala wanaotambua FTIR. Inashughulikia usimbaji wa Base64, majaribio upya, na simu za async kwa ajili yako.

Sakinisha

pip install langchain-ftirfun

Wito mdogo

from langchain_ftirfun import explain_peaks

result = explain_peaks(
    api_base_url="https://ftir.fun",
    api_key="ftir_your_key_here",
    peaks=[1715],
)
print(result)

Ingiza FTIRFUN_TOOLS ili kupata kazi zote saba katika orodha. Kila kazi inachukua api_base_url na api_key kama hoja mbili za kwanza.

Ukurasa wa PyPI

n8n

Nodi ya jamii · npm

Imechapishwa

Buruta-na-uweke utafutaji wa FTIR kwenye mifumo ya kazi ya kiotomatiki inayoonekana. Hakuna kupanga — unganisha nodi na endesha.

Sakinisha

npm install n8n-nodes-ftirfun

Au ongeza katika n8n: Mipangilio → Nodes za Jamii → Sakinisha.

ukurasa wa npm

Coze / Doubao

Programu-jalizi ya OpenAPI · Ufunguo wa huduma ya mchapishaji

Moja kwa moja

Programu-jalizi ya wingu la Coze imechapishwa na zana tatu: uchambuzi wa wigo, utafutaji wa maktaba ya marejeleo, na maelezo ya kilele. Watumiaji wa mwisho wanaweza kuitumia moja kwa moja katika Doubao bila kusanidi ufunguo wowote wa API.

Mwisho

/coze/analyze_spectrum_flat
/coze/find_spectra
/coze/explain_peaks

Kiwango kinafuatiliwa kwa kila mtumiaji kupitia Coze sys_uuid. Programu-jalizi hutumia ufunguo wa huduma uliosanidiwa na mchapishaji.

GPT

ChatGPT

GPT Maalum · Vitendo vya GPT

Schema tayari

Jenga GPT maalum inayochambua spektra, kuelezea kilele, na kupata spektra za marejeleo. Ingiza schema yetu ya OpenAPI kama Kitendo. Inahitaji ChatGPT Plus.

Ingiza URL

https://ftir.fun/openapi.platform.yaml

Katika kihariri cha GPT: Sanidi → Vitendo → Ingiza kutoka URL. Weka uthibitishaji kwa API Key (header X-API-Key).

Schema ya OpenAPI

Dify

Chombo maalum · OpenAPI

Schema tayari

Ongeza FTIR.fun kama chombo maalum katika programu na mawakala wako wa Dify kwa kuleta schema sawa ya OpenAPI.

Ingiza URL

https://ftir.fun/openapi.platform.yaml

Katika Dify: Zana → Unda Zana Maalum → ingiza schema, weka kichwa cha X-API-Key.

API ya Google Gemini

Matamshi ya kazi (muunganisho wa SDK)

Tayari

Tumia maelezo ya kazi yaliyotengenezwa tayari kuita FTIR.fun kutoka kwa mtiririko wa kukita kazi wa API ya Gemini katika msimbo wako.

Matamko yanajumuisha shughuli zote saba, ikijumuisha uchambuzi na ripoti kamili zisizolingana.

Tamko la JSON GitHub

Nini AI yako inaweza kufanya kwa kweli

Usambazaji wa sasa wa MCP, REST, n8n, na LangChain hufichua shughuli saba. Programu-jalizi iliyochapishwa ya Coze hufichua zana tatu (analyze, find, explain), na templeti zingine zinaweza kufichua seti ndogo iliyotangazwa; angalia kila kadi ya jukwaa kabla ya matumizi. Shughuli zilizo hapa chini zinashiriki huduma sawa za FTIR.fun.

Kazi	Chombo cha MCP	Sehemu ya mwisho ya REST	Sema hivi kwa AI yako
Soma faili la chombo	`parse_ftir_spectrum`	`POST /parse-spectrum`	Changanua sample.spc na orodhesha vilele vilivyogunduliwa.
Tambua wigo usiojulikana	`analyze_ftir_spectrum`	`POST /ftir/analyze_spectrum`	Tambua ni polima gani wigo huu.
Wasilisha ripoti kamili ya mihimili mitatu	`submit_ftir_report`	`POST /ftir/reports`	Wasilisha sample.spa kwa ripoti kamili katika hali ya ATR.
Chagua na upate ripoti hiyo.	`get_ftir_report_status`	`GET /ftir/reports/{task_id}`	Angalia kazi ya ripoti na nipe kiungo kitakapokamilika.
Elezea kilele	`explain_peaks`	`POST /ftir/explain_peak_assignments`	Vilele katika 1715 na 1450 cm-1 vinaonyesha nini?
Tafuta wigo wa marejeleo unaojulikana	`find_spectra`	`POST /ftir/find_spectra`	Tafuta spectra za kumbukumbu za polystyrene.
Fungua tena matokeo ya awali	`fetch_result`	`GET /ftir/result/{result_num}`	Pata matokeo 20260528100755416137536.

Faili zinazotumika: SPA, SPC, OPUS, JCAMP-DX, CSV, TSV, Excel, JSON. Thamani za sampuli za sampling_mode ni: KBr Pellet, Vapor, Solvent, Thin Film, Paraffin Mull, ATR, Diffuse Reflectance, Micro IR, na Others. Transmission si thamani halali. Weka kiendelezi cha faili asili ili FTIR.fun ichague kichanganuzi sahihi.

mfano wa majibu ya find_spectra

majibu ya find_spectra

{
  "success": true,
  "query": "polystyrene",
  "match_mode": "synonym",
  "match_count": 3,
  "summary": "Found 3 reference spectrum candidates for 'polystyrene'.",
  "results": [
    {"num": 555, "spectrum_number": 555, "name": "PS/PPO",
     "cas": "-", "source_type": "direct_read:spa",
     "peaks": [697, 756, 1028, ...], "x": [...], "y": [...]}
  ]
}

mfano wa majibu ya explain_peaks

Jibu la explain_peaks

{
  "success": true,
  "search_mode": "peak_explanation",
  "peak_explanations": [
    {"peaks_cm1": [1715, 1450],
     "assignment": "1715 cm-1 suggests C=O stretching (ester or carboxylic acid)...",
     "evidence_type": "llm_general_knowledge"}
  ],
  "summary": "Peak explanation based on general FTIR knowledge..."
}

Kupata ripoti kamili (async)

Uchunguzi wa haraka (analyze_spectrum) hurudisha mara moja. Ripoti kamili ya mhimili-tatu inaendesha chinichini na kwa kawaida huchukua sekunde 30–90. Usiwasilishe tena wakati ripoti inaendesha — weka task_id na uipige kura.

Wasilisha Piga submit_ftir_report (MCP) au POST /ftir/reports (REST). Utapata task_id na result_num iliyohifadhiwa. Sehemu ya file_base64 inahitajika; sehemu nyingine (sampling_mode, prior_context, language_code, sample_name, sample_order_no) ni za hiari.

Wasilisha mfano (REST)

curl -X POST https://ftir.fun/ftir/reports \
  -H "X-API-Key: ftir_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"file_base64": "V2F2ZW51bWJlci...", "filename": "sample.spa", "sampling_mode": "ATR", "language_code": "en"}'

Wasilisha majibu

{"success": true, "task_id": "rpt_abc123...", "result_num": "20260713...", "status": "queued"}

Kura Piga get_ftir_report_status (MCP) au GET /ftir/reports/{task_id} kila sekunde 5–10 hadi completed iwe true. Jibu la kukamilika linajumuisha report_url, report_view (maudhui ya ripoti yaliyoundwa), na result_num.

Mfano wa kura

curl https://ftir.fun/ftir/reports/rpt_abc123 \
  -H "X-API-Key: ftir_your_key_here"

Jibu la kura (inaendelea)

{"success": true, "task_id": "rpt_abc123", "status": "running", "progress": 45, "completed": false}

Jibu la uchunguzi (limekamilika)

{"success": true, "task_id": "rpt_abc123", "status": "completed", "completed": true,
 "result_num": "20260713...", "report_url": "https://ftir.fun/outputdata/?num=20260713..."}

Fungua ripoti ya mwisho Fungua URL kamili https://ftir.fun/outputdata/?num={result_num} kwenye kivinjari ili kutazama ukurasa kamili wa matokeo ya mhimili-tatu uliotolewa na FTIR.fun.

⚠️ Usiwasilishe ripoti hiyo hiyo tena ikiwa imepangwa au inaendesha. Weka task_id na endelea kupiga kura hadi ikamilike au ishindwe. Uwasilishaji wa nakala hupoteza pointi.

Utatuzi wa shida

Kile unachokiona	Maana yake	Nini cha kufanya
Kiteja hufungua ukurasa wa idhini ya kivinjari, au kinasema ukurasa wa idhini haupo.	Mteja wako anatumia ingizo la seva la zamani la mtindo wa OAuth. FTIR.fun haitumii OAuth — ufunguo wa API pekee.	Futa ingizo la zamani la seva ya ftirfun, bandika usanidi halisi kutoka ukurasa huu, pakia upya mteja, na anza ftirfun tena.
`401` (MCP) / `401 invalid_api_key` (REST)	Ufunguo wa API haupo, umekwisha muda, umeghairiwa, au umebandikwa vibaya.	Anzisha upya seva na bandika ufunguo mbichi pekee (unaoanza na ftir_). Tengeneza ufunguo mpya kutoka kwa Dashibodi ya Funguo za API ikihitajika.
Seva inaanza lakini hakuna zana zinazoonekana.	Mteja hajaburudisha katalogi yake, au usanidi unatumia jina lisilofaa la ufunguo.	Kwa VS Code, thibitisha mcp.json inatumia seva (si mcpServers). Kisha simamisha na uanze ftirfun, au upakie upya dirisha.
`403 insufficient_balance`	Akaunti haina pointi za kutosha kwa uchambuzi huo.	Angalia salio lako au usajili katika FTIR.fun, kisha jaribu tena.
`429 rate_limit_exceeded`	Uchambuzi na uchanganuzi wa REST huruhusu maombi 60 kwa dakika kwa kila ufunguo wa API; usomaji wa matokeo na ripoti-hali ya REST hutumia ndoo tofauti ya maombi 120 kwa dakika; MCP huruhusu simu 60 kwa dakika kwa kila ufunguo wa API na zana.	Subiri kipindi cha kurudia kinachoripotiwa na zana kabla ya kupiga tena.
Ripoti inabakia kwenye foleni au inaendelea.	Ripoti kamili zinaendeshwa kwa njia isiyo ya wakati mmoja na zinachukua muda mrefu kuliko uchunguzi wa haraka.	Weka task_id ileile na endelea kuuliza. Usiunde kazi za ripoti za kurudia.
`422` au `missing_input`	Mwili wa ombi unakosa sehemu zinazohitajika au umbizo si sahihi. Kwa analyze_spectrum, lazima utoe angalau moja ya: peaks, query, au file_base64.	Hakikisha JSON yako ni halali, Content-Type ni application/json, na sehemu zinazohitajika zipo. Tazama mifano ya maombi hapo juu.
`413 file_too_large`	Faili ya wigo iliyopakiwa inazidi kikomo cha ukubwa.	Hamisha faili ndogo au tumia tu nafasi za kilele kupitia uwanja wa spectrum.peaks.

Tayari kujenga?

Rejeleo kamili la REST lina kila sehemu ya mwisho, fomati za ombi na jibu, uthibitishaji, mipaka ya kiwango, misimbo ya makosa, ufafanuzi wa zana za MCP, na mifano ya msimbo katika Python na curl.

Tazama nyaraka kamili za API → Uunganisho maalum? Wasiliana nasi