Dokumentasyon
Isang backend, apat na paraan sa loob. Ang bawat seksyon ay nagdodokumento ng parehong mga kaso ng paggamit, kaya ang isang konsepto na natutunan mo sa REST API ay ang parehong konsepto sa MCP at sa CLI.
Pagsisimula
Pagpapatotoo, mga workspace, proyekto, at ang iyong unang na-publish na post.
Hindi pa nai-publishIsinulat ang seksyong ito laban sa ipinadalang API at nag-publish kasama nito. Mas gugustuhin naming magpakita sa iyo ng wala kaysa sa dokumentasyon para sa isang endpoint na maaaring magbago.
REST API
Mga mapagkukunan, pagination, idempotency, error code at mga limitasyon sa rate.
Hindi pa nai-publishIsinulat ang seksyong ito laban sa ipinadalang API at nag-publish kasama nito. Mas gugustuhin naming magpakita sa iyo ng wala kaysa sa dokumentasyon para sa isang endpoint na maaaring magbago.
MCP server
Transport, OAuth, tool catalog, mga saklaw at ang pagkakamay ng pag-apruba.
Hindi pa nai-publishIsinulat ang seksyong ito laban sa ipinadalang API at nag-publish kasama nito. Mas gugustuhin naming magpakita sa iyo ng wala kaysa sa dokumentasyon para sa isang endpoint na maaaring magbago.
CLI
I-install, i-authenticate, at ang kontrata ng output na nababasa ng makina.
Hindi pa nai-publishIsinulat ang seksyong ito laban sa ipinadalang API at nag-publish kasama nito. Mas gugustuhin naming magpakita sa iyo ng wala kaysa sa dokumentasyon para sa isang endpoint na maaaring magbago.
Mga Webhook
Catalog ng kaganapan, pag-verify ng lagda, muling pagsubok at muling paghahatid.
Hindi pa nai-publishIsinulat ang seksyong ito laban sa ipinadalang API at nag-publish kasama nito. Mas gugustuhin naming magpakita sa iyo ng wala kaysa sa dokumentasyon para sa isang endpoint na maaaring magbago.
Alinsunod sa mga kinakailangan sa platform, mga uri ng account, mga limitasyon at kilalang mga paghihigpit.
Sanggunian ng error
Bawat error code, kung ano ang sanhi nito, at kung ano ang gagawin tungkol dito.
Hindi pa nai-publishIsinulat ang seksyong ito laban sa ipinadalang API at nag-publish kasama nito. Mas gugustuhin naming magpakita sa iyo ng wala kaysa sa dokumentasyon para sa isang endpoint na maaaring magbago.
Kung ano ang maaasahan mo
- Ang bawat pagsusulat ay tumatagal ng isang idempotency key. Ang pag-replay ng kahilingan gamit ang parehong key ay nagbabalik ng orihinal na resulta sa halip na lumikha ng pangalawang post.
- Ang bawat error ay may stable na code, message key at mga detalyeng na-sanitize. Ang mga code ay hindi nagbabago ng kahulugan sa pagitan ng mga bersyon.
- Ang mga paglabag sa mga pagbabago ay makakakuha ng bagong bersyon at isang inihayag na window ng paghinto sa paggamit. Ang mga additive na pagbabago ay hindi.
- Ang pagbabasa, pag-draft, paghiling ng pag-apruba, pag-iskedyul at pag-publish ay magkahiwalay na saklaw. Nakukuha ng kredensyal ang pinakamaliit na hanay na gumagawa ng trabaho nito.