API, vefkrókar og MCP: tengdu ERP-kerfið við skráninguna

Ef þú rekur búið með ERP-kerfi, kostnaðarskjali eða forriti ráðgjafans er engin ástæða til að slá verkin inn tvisvar. Þetta er skjölunin til að sækja skráninguna, kostnaðinn og stöðu reglufylgni utan frá og til að skrá verk úr kerfinu sem þú notar nú þegar.

Grunnslóðin er https://agrogps-api.fly.dev/api/v1. Hún hefur verið í rekstri síðan 17. september 2026. Hún svarar alltaf með JSON, líka þegar villa kemur upp.

Tvær leiðir til að auðkenna sig

Lykillinn er búinn til einu sinni úr lotunni þinni og er aðeins sýndur einu sinni: eftir það geymum við aðeins tætigildi hans. Ef hann týnist er hann afturkallaður og nýr búinn til. Lesaðgangslykill sem reynir að skrifa fær 403 AUT_004. Lyklar geta ekki búið til eða eytt öðrum lyklum eða vefkrókum: það er alltaf gert með lotu manneskju.

curl -X POST https://agrogps-api.fly.dev/api/v1/api-keys \
  -H "Authorization: Bearer $SESION" \
  -H "Content-Type: application/json" \
  -d '{"name":"ERP Sage","scope":"read"}'

Hvað þú getur lesið

Með skrifaðgangslykli geturðu líka skráð verk með POST /sync/entries, með sama innihaldi og appið notar. Samstillingin fer eftir since, svo næturferli sækir aðeins það sem hefur breyst.

Byrja ókeypis

Undirritaðir vefkrókar

Í stað þess að spyrja á fimm mínútna fresti látum við þig vita. Þú skráir opinbera https-slóð og við sendum tilkynningu þegar eitthvað gerist á búi þar sem þú ert eigandi eða bústjóri.

Hver sending ber X-Agro-Event, X-Agro-Timestamp í Unix-sekúndum og X-Agro-Signature með HMAC-SHA256 af "<timestamp>.<cuerpo>". Athugaðu hvort tveggja: undirskriftina og að klukkan hafi ekki farið meira en fimm mínútur af leið.

import hmac, hashlib, time

ts = request.headers["X-Agro-Timestamp"]
assert abs(time.time() - int(ts)) < 300
esperada = "sha256=" + hmac.new(
    secreto.encode(), ts.encode() + b"." + cuerpo, hashlib.sha256
).hexdigest()
ok = hmac.compare_digest(esperada, request.headers["X-Agro-Signature"])

Reglur um sendingar, sagðar skýrt svo þær komi ekki á óvart: ein tilraun, sex sekúndna bið og engar endurtekningar. Við fylgjum ekki framsendingum og höfnum einkavistföngum, staðbundnum tengivistföngum og lýsigagnavistföngum skýja, bæði þegar slóðin er skráð og þegar DNS er flett upp fyrir hverja sendingu. Ef kerfið þitt þarf tryggingar, notaðu vefkrókinn sem tilkynningu og GET /sync/entries með since sem öryggisnet: tilkynningin er kurteisi, API-ið er sannleikurinn.

MCP fyrir gervigreindaraðstoðarmenn

Sama API er aðgengilegt sem MCP-þjónn, samskiptareglan sem aðstoðarmenn nota til að tengjast verkfærum. Þannig geturðu spurt aðstoðarmann til dæmis hvaða bú eru á eftir, hvað tímabilið kostaði eða hvað vantar áður en eftirlit fer fram.

{ "mcpServers": { "agro-gps": {
  "command": "npx", "args": ["-y", "agro-gps-mcp"],
  "env": { "AGROGPS_API_KEY": "agk_…" } } } }

Tiltæk verkfæri: list_farms, list_entries, entry_history, list_groups, group_overview, advisor_portfolio, advisor_pending og record_entry. Það síðasta virkar aðeins með skrifaðgangslykli, er merkt í sögunni sem skrifað í gegnum API og sendir aldrei neitt til yfirvalda.

Hvers vegna API-ið hentar ekki til svindls

API yfir skrá með lagalegt gildi verður að þola að vera skoðað beint. Á Spáni leyfir RD 1054/2022 að skráningin sé haldin í hvaða tölvukerfi sem er sem uppfyllir kröfur viðauka II og er samhæft við SIEX, og tekur skýrt fram að eigandinn, ekki forritið, beri ábyrgð á réttmæti gagnanna. Okkar hlutur er heilleikinn og hann er innbyggður í kóðann, í öllum löndum.

Villur

Alltaf {"code":"INT_NNN","message":"…"}, aldrei staflarakning. Þær sem þú sérð oftast: AUT_003 ógildur lykill, AUT_004 lesaðgangslykill, AUT_429 of margar tilraunir, AUT_503 auðkenning ekki tiltæk (ekki það sama og rangur lykill: reyndu aftur), INT_003 slóð sem er ekki https, INT_403 aðgerð sem krefst lotu, INT_404 lykill eða vefkrókur sem er ekki þinn.

Hvernig færðu lykil

API-ið fylgir fyrirtækja- og ráðgjafaráskriftunum. Ef þú ert þegar með aðgang býrðu lykilinn til í appinu sjálfu. Ef þú ert að meta tenginguna áður en þú gerir samning, skrifaðu á support@agrogps.eu hvaða kerfi þú vilt tengja og við veitum þér prufuaðgang. Skjölunin er opinber og ókeypis: við viljum frekar að þú skoðir hana áður en þú borgar.

Byrja ókeypis

Algengar spurningar

Get ég haldið allri skráningunni úr ERP-kerfinu án þess að opna appið? Já, til að skrá og lesa. Opinber sending er aðeins til á Spáni og krefst lotu manneskju með heimild til að senda. Þetta er meðvituð ákvörðun: sú aðgerð hefur lagalegar afleiðingar og á ekki að fara af stað í sjálfvirku ferli.

Eru gögnin mín? Já. Full útflutningur er alltaf ókeypis, líka ef þú hættir, og í gegnum API-ið færðu nákvæmlega það sama og þú sérð á skjánum, þar með talið söguna og ummerki breytinga.

Eru takmörk á fjölda kalla? Enginn birtur kvóti er fyrir venjulega ERP-notkun. Prófun vefkróks er takmörkuð við tuttugu sinnum á hvern notanda og IP-tölu á tíu mínútna fresti, svo enginn noti aðgerðina til að búa til umferð.

Hvað gerist ef þið breytið API-inu? Útgáfan er í slóðinni. Á meðan v1 er birt fjarlægjum við ekki reiti og breytum ekki merkingu þeirra sem fyrir eru; nýju er bætt við. Ef einhvern tíma kæmi v2 myndu þær lifa hlið við hlið.

Er MCP-þjónninn á npm? Ekki enn. Í dag er hann keyrður úr kóðasafninu; ekki hefur verið ákveðið hvenær hann verður birtur. Stillingin hér að ofan er sú sem mun virka daginn sem hann verður birtur.

Hentar þetta ráðgjafa með marga viðskiptavini? Til þess er advisor/portfolio: eitt kall segir hvaða bú eru í lagi og hver eru með ókláruð verk, án þess að fara inn í hvert og eitt.