Ìbẹ̀rẹ̀ kíákíá
Wọlé, ṣẹ̀dá iṣẹ́ àdánwò, ṣẹ̀dá kọ́kọ́rọ́ pẹ̀lú àwọn scope tó yẹ nìkan, pe GET /v1/tools, ṣètò iṣẹ́ kan, lẹ́yìn ìdánwò ìtẹ́wọ́gbà ṣẹ̀dá kọ́kọ́rọ́ live míì.
export GALON_API_BASE="https://api.galon.ai"
export GALON_API_KEY="gln_test_..."
curl "$GALON_API_BASE/v1/tools" -H "Authorization: Bearer $GALON_API_KEY"
Ìjẹ́rìísí àti ìyàsọ́tọ̀
Fi kọ́kọ́rọ́ API ránṣẹ́ nínú akọsori Authorization: Bearer. Kọ́kọ́rọ́ kọ̀ọ̀kan so mọ́ tenant, iṣẹ́ akanṣe àti ayíká kan. Pa á mọ́ sínú ibi ìkọ̀kọ̀ olupin nìkan; má ṣe fi sínú aṣàwákiri, app alágbèéká tàbí ibi kóòdù.
Kọ́kọ́rọ́ tó ní ààlà iṣẹ́
Fúnni ní scope pàtó bí mail:send, domain:lookup tàbí build:create. Lo kọ́kọ́rọ́ kan fún app kọ̀ọ̀kan. Yẹra fún àṣẹ gbogbo iṣẹ́ bí kò ṣe pé ìṣepọ̀ náà nílò gbogbo ìgbésẹ̀, kí o sì fagilé kọ́kọ́rọ́ tí a kò lò lẹ́sẹ̀kẹsẹ̀.
mail:send
domain:lookup
domain:read
build:create
build:read
artifact:read
job:read
Àwọn job aláìdúró àti idempotency
Ìyípadà máa ń dá job padà. Fi Idempotency-Key tó dúró ránṣẹ́: kọ́kọ́rọ́ àti èrò kan náà dá job kan náà padà; kọ́kọ́rọ́ kan náà pẹ̀lú èrò mìíràn dá HTTP 409 padà. Ṣàyẹ̀wò job kí o sì tún ìbéèrè tó ní ààbò tàbí idempotent nìkan ṣe.
POST /v1/jobs
GET /v1/jobs/{job_id}
POST /v1/jobs/{job_id}/cancel
GET /v1/builds/{job_id}/artifacts
Fífi ímeèlì ránṣẹ́
POST /v1/emails ń gba from_email, subject, text tàbí html, àti to: àdírẹ́sì kan tàbí àtòkọ. cc àti bcc jẹ́ àtòkọ àṣàyàn; to, cc àti bcc lápapọ̀ kò lè ju olùgbà ọ̀tọ̀ọ̀tọ̀ 50 lọ, a sì ń ka olùgbà kọ̀ọ̀kan sínú ìpín rẹ àti ìlò tí a ń gba owó fún. Olùgbà kọ̀ọ̀kan ń gba ẹ̀dà tirẹ̀ pẹ̀lú ìjápọ̀ ìyọkúrò onítẹ̀ẹ́-kan tirẹ̀, nítorí náà a kì í fi àwọn olùgbà bcc hàn rárá; a ń fo àwọn olùgbà tí a dènà (ìfàsẹ́yìn, ẹ̀sùn, ìyọkúrò). attachments jẹ́ àtòkọ ohun tí kò ju 10 lọ pẹ̀lú filename, content (base64) àti content_type àṣàyàn; ìfiránṣẹ́ tí a ti kódì gbọ́dọ̀ wà ní ìsàlẹ̀ 25 MB, a sì ń kọ àwọn fáìlì tí ó ṣeé ṣiṣẹ́. scheduled_at (ISO 8601 pẹ̀lú agbègbè àkókò, tí kò ju wákàtí 72 ṣáájú lọ) ń sún fífiránṣẹ́ síwájú; POST /v1/emails/{job_id}/cancel ń fagilé e níwọ̀n ìgbà tí ó bá ṣì wà nínú ìlà. POST /v1/emails/batch ń gba {"emails": [...]} pẹ̀lú ìfiránṣẹ́ 1 sí 100 láìsí àsomọ́; ìfiránṣẹ́ kọ̀ọ̀kan di job tirẹ̀, idempotent nípasẹ̀ Idempotency-Key ti àkójọpọ̀ náà àti ipò rẹ̀. A ṣì ń gba to_email fún olùgbà kan ṣoṣo. Ìforúkílẹ àkójọpọ nìkan ni atomiki (atomic=true); ìṣẹ́ àti ifijiṣẹ́ jẹ́ ọ̀tọ̀. Àtúnṣe nilo àtòkọ kan naa ni ìlànà kan naa; ìyípadà akoonu, iṣẹ́dá tabi ìsọsọ̀rọ̀ padà HTTP 409.
POST /v1/emails
POST /v1/emails/batch
POST /v1/emails/{job_id}/cancel
Àwọn àṣìṣe
HTTP 401 túmọ̀ sí ìdánimọ̀ tí kò tọ́ tàbí tó parí, 403 sí scope tí kò tó, 409 sí ìjà idempotency tàbí version, 422 sí ìbéèrè tí kò tọ́, 503 sí àìsí iṣẹ́ fún ìgbà díẹ̀.
Ìtọ́kasí tí ẹ̀rọ lè kà
Lo àdéhùn OpenAPI fún schema àti ìtọ́sọ́nà ìṣepọ̀ LLM fún àṣẹ agent. Gẹ̀ẹ́sì ni orísun àṣẹ; path, field, scope àti àpẹẹrẹ jẹ́ bákan náà nínú gbogbo ìtumọ̀.