• ノウハウ
  • |Remogu(リモグ)" />

    MuleSoftの案件ではどこまで担う?APIを部品として作り公開し管理する範囲の違い

    監修・編集責任者:牛尾 昭昌(株式会社LASSIC 執行役員)

    会議室の大型モニターでAPIの図を囲む人々

    📘 この記事でわかること

    • 同じMuleSoftの募集でも、部品を作る・使う側に公開する・公開後に管理するの3つの持ち場に分かれうること
    • デジタル庁の公開例から分かる、APIの公開に添えられる仕様・試験環境・規約と、公開後に続く利用制限やメンテナンスの案内
    • 持ち場ごとに変わる時間の区切り方と、他の案件と並べて受けられるかを決める参画前の確認事項

    参画前の打ち合わせで「連携はMuleSoftで組んでいます」と聞き、システム同士をつなぐ処理を作る話だと思って頷きました。ところが相手は続けて「公開したAPIの問い合わせ窓口もお願いしたくて」と言います。業務委託の案件を検討している人にとって、募集文の「MuleSoft」の一語だけでは、作るだけの仕事なのか、公開後の管理まで抱える仕事なのかが読めません。MuleSoftの案件は、作る・公開する・管理するの、どこまでを持つかで決まります。

    リモートワーク案件特化のエージェント|Remogu(株式会社LASSIC運営) API連携の経験を生かす案件を探す API連携の経験を生かすリモート案件を探す

    1. MuleSoftの案件で範囲が読みにくい理由

    募集文の一語に収まるもの

    MuleSoftと書かれた募集文は、製品名がそのまま案件の看板になります。製品名は道具の名前なので、その道具を使って何を任されるのかまでは、一語から読み取れません。この記事では製品の機能や仕様には触れず、連携基盤の上で任される仕事の範囲だけを整理します。

    書き手の見立てでは、募集文に範囲が書かれにくいのは、発注側の頭の中で「連携はひとまとまりの仕事」として扱われているからです。システムをつなぐ処理を組む人も、そのAPIを使う側に案内する人も、止まったときに問い合わせを受ける人も、発注側から見れば同じ「連携の担当」に見えます。一方、受ける側にとっては、持ち場が違えば一週間の動き方がまったく変わります。

    3つの持ち場に分けて読む

    そこで本記事では、API連携の仕事を3つの持ち場に分けて読みます。1つ目は、つなぐ先のシステムに近い処理や業務の手順を部品として作る持ち場です。2つ目は、作った部品を使う側に公開し、仕様や資料を整える仕事です。3つ目は、公開したあとに利用状況や停止の連絡、問い合わせに対応する役回りが当たります。

    図1:MuleSoftの募集に含まれうる3つの持ち場
    MuleSoftの募集に含まれうる3つの持ち場 一語の募集が3つの仕事を含む 部品を作る つなぐ処理を組む 手順をまとめる 使う側に公開する 仕様を整える 資料を用意する 公開後に管理する 問い合わせへの対応 停止の連絡への対応

    図の作成:Remogu編集部。募集文から読み取れる持ち場の整理で、統計データではありません

    1つの案件が3つすべてを含むとは限らず、1つだけの案件も、2つにまたがる案件もあると考えられます。大事なのは、打ち合わせの早い段階で自分がどこを持つのかを言葉にしてもらうことです。次の節では、いちばん手前にある「部品として作る」考え方から見ていきます。

    2. APIを部品として作るという考え方

    APIは他のシステムが呼び出す窓口

    APIは、あるシステムの機能やデータを、別のシステムが決まった形で呼び出せるようにした窓口です。窓口の形が決まっていれば、呼び出す側はなかの作りを知らなくても使えます。連携基盤の案件では、この窓口を1回きりの配線として作るのか、何度も使い回せる部品として作るのかで、仕事の組み立てが変わります。

    実例として、デジタル庁は氏名突合支援サービスのなかで、氏名の漢字・アルファベットとカナを突合・推定する業務を支援するAPI等を提供しています1。ここで言えるのは、ある業務の支援を、決まった窓口から使える形で出している例があることまでです。このサービスを作った技術や体制までは、出典に書かれていません。

    部品の置き場所で仕事の中身が変わる

    部品の置き場所を3つに分けると、案件で任される仕事が想像しやすくなります。つなぐ先のシステムに近い部品は、相手先の仕様に合わせる作業が中心です。業務の手順をまとめる部品は、複数の呼び出しを束ねる設計が中心です。使う側に見せる口は、呼び出す人から見た分かりやすさが中心になります。これは書き手の整理であり、特定の製品の方法論ではありません。

    部品の置き場所中身案件での見え方
    つなぐ先のシステムに近い部品相手先の仕様に合わせて、データの取得や登録を受け持つ相手先の仕様書やデータ形式を読む場面が多い
    業務の手順をまとめる部品複数の呼び出しを順番に束ね、1つの業務として動かす業務の流れを聞き取り、手順に落とす場面が多い
    使う側に見せる口呼び出す人に向けて、窓口の形と返す内容を決める使う側の開発者とのやり取りが増える

    表の右の列で、使う側の開発者とのやり取りが出てくる点に注目します。作る持ち場でも、口の設計に近づくほど、窓口の先にいる人との調整が仕事に入ります。API の責任をどこで切るかは別の記事で詳しく扱っているので、あわせて読むと範囲の線引きが具体的になります。サーバーサイド側の切り方は、サーバーサイドの案件でAPIの責任はどこで切る?担当範囲の決まり方と条件を整理で確かめられます。

    部品を作るだけの持ち場であれば、納品物を区切りにして時間を組み立てやすくなります。ただし、作った部品を使う側に見せる段階に進むと、仕事の性質が少し変わります。次の節では、公開のときに一緒に用意されるものを見ます。

    3. 公開するときに一緒に用意されるもの

    仕様書を1枚ずつ確かめてチェックを入れる手元

    氏名突合支援サービスに並ぶ資料

    APIを使う側に公開するとき、窓口だけを置いて終わりにはなりません。デジタル庁の氏名突合支援サービスは、APIとあわせて、APIキー管理のページ、利用サンプルプログラム・Excelツール、デモなどを提供コンテンツとして並べています1。利用するには、利用規約とプライバシーポリシーへの同意を求めています1。

    この並びを見ると、公開の持ち場には、窓口の外側にある資料や手続きを整える仕事が含まれうると読み取れます。APIを公開すると周辺の資料も要る、というのは書き手の見立てです。出典が示すのは、公開されたAPIにこれだけのものが添えられている例がある、という事実までです。

    仕様ファイルと版の付いたファイル名

    同じサービスのAPI仕様のページは、OpenAPI Specificationに沿った仕様を、YAML形式のファイルで配っています2。そのファイル名には、版を表す「v1.8o」が入っています2。仕様が1つのファイルにまとまっていれば、使う側は同じファイルを手元に置いて開発を進められます。

    ただし、この出典から言えるのは、ファイル名に版が入っているところまでです。版の付け方の規則や、版を上げるときの手順は、書かれていません。版を上げる合意の相手や手順は案件ごとに異なるため、参画前に確かめる項目に回します。設計の規約や版の考え方は、API連携の案件はどこまでが自分の実装?相手の仕様との境目の見極め方が詳しく扱っています。

    試験用のSandboxは別のサービスの例

    試験用の環境の例は、別のサービスで示されています。デジタル庁のデジタル認証サービスのAPIリファレンス(民間事業者向け)は、本番環境とは別に、Sandboxの接続先を示しています3。氏名突合支援サービスとデジタル認証サービスは、別のサービスです。図2でも2つを分けて並べています。

    図2:APIを公開するときに添えられている資料と環境の例
    APIの公開に添えられている資料と環境の例 窓口の周りに資料と環境が並ぶ 氏名突合支援サービス 仕様ファイル(YAML) 版の入ったファイル名 規約とプライバシーポリシー キー管理 サンプルプログラム デジタル認証サービス 試験用のSandbox

    出典:デジタル庁 開発者サイト(氏名突合支援サービス・デジタル認証サービス)をもとに作成

    試験用の環境が示されている例があることは分かりますが、その環境をだれがどう運用しているかは、出典には書かれていません。案件でも、試験環境の有無と持ち主は、参画前に尋ねる価値のある項目です。公開の準備が整った先には、公開後に続く管理の仕事があります。

    4. 公開後に管理が続く部分

    利用制限と稼働の案内

    公開した窓口は、使う側がいる限り動かし続ける対象になります。氏名突合支援サービスのよくある質問は、誰でも利用できるとしたうえで、他の利用者に迷惑をかける使い方をする利用者には利用制限を行う可能性があるとしています4。回数の上限などの数値は、この質問には書かれていません。

    稼働については、同じよくある質問が、サービスは原則24時間365日稼働としています4。そのうえで、メンテナンス等でデジタル庁の判断により、事前の案内なく変更する場合があるとしています4。稼働率の保証を示したものではなく、「原則」と「事前の案内なく変更する場合がある」が一組で書かれている点に注意します。

    メンテナンスの案内と利用者側の備え

    メンテナンス情報は、原則として開発者サイトの「新着・更新」で案内されます4。一方で、場合により事前連絡なく停止することがあると、同じ質問は述べています4。利用制限やメンテナンス時間を気にする利用者には、セルフホスティングでの利用を検討するよう案内しています4。これは利用者向けの案内で、提供側の運用体制を説明したものではありません。

    管理の項目公開例での案内
    利用制限他の利用者に迷惑をかける使い方をする利用者には、制限を行う可能性がある4
    稼働原則24時間365日。事前の案内なく変更する場合がある4
    メンテナンス原則として開発者サイトの「新着・更新」で案内。場合により事前連絡なく停止する4
    利用者側の備え制限や停止を気にする場合は、セルフホスティングでの利用を検討するよう案内4

    表の項目は、そのまま公開後に管理する持ち場の仕事の見出しとして読めます。利用状況を見て制限を判断する、稼働の案内を保つ、停止やメンテナンスを使う側に伝える、といった仕事です。ただし、この3つを具体的にだれがどの時間帯で受け持つかは、出典に書かれていません。案件ごとに確かめる必要があります。

    公開後の互換や品質をどう保つかは、別の記事が詳しく扱っています。APIを公開する案件のガバナンスとは?互換設計と品質を保つ注意点を解説とあわせて読むと、管理の仕事の輪郭がつかみやすくなります。次の節では、3つの持ち場で時間の区切り方がどう変わるかを考えます。

    5. 持ち場ごとの時間の区切り方

    作る持ち場と公開する持ち場の区切り

    他の案件と並べて受けられるかどうかは、稼働時間の長さより、一日のなかで時間を区切れるかどうかで決まります。この節は書き手の見立てで、持ち場ごとの傾向を整理したものです。出典のある事実ではないので、打ち合わせで確かめる前提として使ってください。

    部品を作る持ち場は、納品物で区切りやすい傾向があります。つなぐ処理や手順をまとめた部品は、できあがりの範囲を先に決められるからです。午前は別の案件、午後はこの案件、と時間を割り振りやすい形です。

    一方、使う側に公開する持ち場は、仕様や資料の更新が区切りになりやすいと考えられます。公開例では、APIの周りに提供コンテンツや規約が並んでいました1。これらは更新のたびに作業が生まれますが、更新の予定を先に共有できれば、日程に組み込めます。

    管理する持ち場の区切りにくさ

    管理する持ち場は、区切りが外から決まりやすい持ち場です。問い合わせや停止の連絡は使う側の都合で届くため、自分の予定に合わせて集められません。

    公開例のよくある質問は、サービスは原則24時間365日稼働とする一方、メンテナンス等でデジタル庁の判断により事前の案内なく変更する場合があるとしています4。停止が事前の案内なく起こりうるなら、連絡が不定期に届く場面も想像できます。これも書き手の見立てです。

    図3:持ち場ごとの時間の区切りやすさ
    持ち場ごとの時間の区切りやすさ 区切りの目安が持ち場で分かれる 部品を作る 区切りやすい 納品物が目安 使う側に公開する 区切りやすい 仕様・資料の更新が目安 公開後に管理する 区切りにくい 問い合わせ・停止の連絡が目安

    図の作成:Remogu編集部。持ち場ごとの傾向を整理したもので、統計データではありません

    ただし、持ち場に管理が含まれていても、連絡を受ける時間帯があらかじめ決まっていれば、他の案件との並べにくさはやわらぎます。決まっているかどうかを、次の節で参画前の確認項目に落とします。

    6. 参画前に確かめておく項目

    ビデオ通話で話を聞きながらメモを取る男性

    持ち場と仕様の持ち主

    打ち合わせの席では、募集文の一語を持ち場の言葉に直してもらうところから始めます。「MuleSoftの案件」と聞いたら、作る・公開する・管理するのどこまでかを、そのまま尋ねます。

    公開を含むなら、仕様ファイルを更新する人を確かめます。公開例では、仕様がYAML形式のファイルで配られ、ファイル名に版が入っていました2。仕様の更新を自分が持つのか、発注側が持つのかで、日々の作業量は変わります。

    試験環境と問い合わせの窓口

    試験環境については、公開例のデジタル認証サービスが、本番環境とは別にSandboxの接続先を示していました3。案件では、試験環境があるか、その持ち主はだれかを尋ねます。試験環境が無い場合は、公開前の確認をどこで行うかを決めておく必要があります。

    問い合わせの窓口も同じです。使う側から届く問い合わせを最初に受けるのが自分なのか、発注側の窓口が先に受けて内容を整理してくれるのかで、一日のなかで作業が中断される回数が変わります。

    連絡の時間帯と版を上げる合意

    停止やメンテナンスの連絡を受ける時間帯は、掛け持ちの設計に直結します。公開例では、メンテナンス情報は原則として開発者サイトの「新着・更新」で案内する一方、場合により事前連絡なく停止することがあるとしています4。案件では、連絡を受ける時間帯と経路を、文面に残してもらいます。

    確かめること尋ね方の例
    担う持ち場部品を作るところまでか、公開や管理も含むか
    仕様ファイルの更新仕様ファイルを更新する人はだれか
    試験環境の有無本番とは別の試験用の環境はあるか。持ち主はだれか
    利用者からの問い合わせの窓口最初に問い合わせを受けるのはだれか
    停止やメンテナンスの連絡を受ける時間帯対応する時間帯と、連絡が届く経路はどうなっているか
    版を上げるときの合意の相手版を上げる前に、だれの了承が要るか

    版を上げるときの合意の相手も、忘れずに尋ねます。ファイル名に版が入る例はあっても、版の上げ方の手順までは出典に書かれていません。案件ごとの取り決めなので、文面にする前の打ち合わせで言葉にしてもらいます。確かめた結果は、次の節で他の案件と並べるための受け方に変えます。

    7. 他の案件と並べるための受け方

    確かめる順番

    確かめた項目は、そのまま受け方の順番になります。まず持ち場を決め、公開を含むかを見て、管理の当番があるかを確かめ、連絡の時間帯を合意し、最後に契約へ進みます。

    図4:他の案件と並べるための受け方の順番
    他の案件と並べるための受け方の順番 前の答えが後の確認を決める 持ち場 の確認 公開 の有無 管理の当番 の有無 連絡の時間帯 の合意 契約

    図の作成:Remogu編集部。受け方の順番を整理したもので、統計データではありません

    順番に意味があるのは、前の答えが後の質問を変えるからです。たとえば作るだけの持ち場なら、管理の当番や連絡の時間帯は聞かなくても済みます。公開や管理を含むときだけ、後ろの確認が重くなります。

    デジタル庁の公開例が示した範囲

    ここで公開例を振り返ります。デジタル庁は、氏名突合支援サービスで、氏名の漢字・アルファベットとカナを突合・推定する業務を支援するAPI等を提供しています1。周辺には提供コンテンツが並び、利用には規約とプライバシーポリシーへの同意を求めています1。仕様はYAML形式のファイルで配られ、ファイル名に版が入っています2。

    公開後については、他の利用者に迷惑をかける使い方をする利用者に利用制限を行う可能性があるとしています4。稼働は原則24時間365日で、事前の案内なく変更する場合があるとされ4、メンテナンス情報は原則として「新着・更新」で案内されます4。別のサービスであるデジタル認証サービスは、Sandboxの接続先を示しています3。

    これらはすべてデジタル庁のAPI公開の案内で、MuleSoftの案件の実態を示すものではありません。公開と管理に何が付いてくる例があるのかを、具体的に思い描くための材料として使いました。

    持ち場を言葉にしてから選ぶ

    冒頭の打ち合わせに戻ります。「公開したAPIの問い合わせ窓口もお願いしたくて」と言われたとき、「その窓口は何時から何時まで受けますか」と尋ねられれば、他の案件との並べ方も見えてきます。頷く前に尋ねる一言が、参画後の負担を決めます。

    Remogu(株式会社LASSIC運営)は、リモートワーク案件特化のエンジニアマッチングで、案件の90%以上がフルリモート可能です。登録して案件の条件を見比べながら、持ち場をひとつずつ確かめていく進め方なら、打ち合わせの前に自分の物差しを作れます。

    MuleSoftの案件は、作る・公開する・管理するの、どこまでを持つかで決まります。

    8. よくある質問

    MuleSoftの経験がまだ少なくても、API連携の経験は生かせますか

    書き手の見立てでは、部品を作る持ち場は、HTTPでの呼び出しやデータ形式の変換といった経験が土台になる場面があります。募集文に製品名が書かれていても、まず持ち場を尋ね、作る持ち場に近いかどうかを見ます。製品の機能や資格は、この記事の範囲外です。

    フルリモートで受けやすいのはどの持ち場ですか

    書き手の見立てでは、納品物や資料の更新で区切れる、作る持ち場と公開する持ち場が進め方を決めやすい傾向があります。管理する持ち場も、連絡を受ける時間帯と経路が決まっていれば、離れた場所から受けられる場面があります。案件ごとに異なるので、打ち合わせで確かめます。

    公開後の管理を頼まれたら何を決めておけばよいですか

    書き手の見立てでは、対応する時間帯、連絡が届く経路、自分が受けられないときに代わりに受ける人の3つを、先に決めておくと並べやすくなります。3つは確認の例であり、これだけで十分とは限りません。案件の事情に合わせて、文面にして残してもらいます。

    リモートワーク案件をお探しの方へ

    Remoguは、株式会社LASSICが運営するITエンジニア・デザイナー専門のリモートワーク案件紹介サービスです。フルリモート・ハイブリッドの案件から、スキルに合うものを探せます。

    MuleSoftの案件は、APIを作るのか、公開するのか、公開後も管理するのかで担う範囲が変わります。リモートで受けられるAPI連携の案件から探してみてください。

    API連携の経験を生かすリモート案件を探す30秒で無料登録

    会員登録無料 / 案件閲覧・相談は無料

    ※公開中の案件数は時期によって変わります。記事中の案件の傾向は執筆時点のものです。

    出典・参考情報

    *1 デジタル庁「氏名突合支援サービス」(2025年10月23日・2026年10月確認)
    *2 デジタル庁「API仕様(OpenAPI Specification)」(2025年11月25日・2026年10月確認)
    *3 デジタル庁「APIリファレンス(民間事業者向け)」(2026年8月25日・2026年10月確認)
    *4 デジタル庁「よくある質問」(2025年10月23日・2026年10月確認)