Dokumentasi Solusi & Panduan Developer

PetStore Mock API

Endpoint mock yang kompatibel dengan Swagger Petstore, dibangun dengan Boomi Web Services

Versi 1.0 · November 2026 · Untuk integration engineer dan developer front-end

Ringkasan eksekutif

PetStore Mock API adalah project Boomi Web Services kecil yang meniru dua operasi Swagger Petstore publik: ambil pet berdasarkan ID dan buat pet. Project ini memberi tim front-end dan integrasi endpoint yang stabil untuk dikembangkan sebelum back end sebenarnya tersedia.

Project ini juga menjadi referensi rapi untuk pola berlapis yang dipakai di project yang lebih besar: proses listener yang tipis, sub-proses berisi logika bisnis, profil JSON sebagai kontrak, dan respons error bergaya Petstore.

2endpoint REST
4proses Boomi
1profil JSON (Pet)
2aturan validasi

Tujuan

Membuka jalan tim klien

Developer front-end dan mobile langsung mendapat API yang kompatibel dengan Petstore sejak hari pertama.

Uji kontrak

Respons yang dapat diprediksi — termasuk error — memudahkan pengujian penanganan error di klien.

Pola referensi

Menunjukkan pola API → [SUB], decision regex, dan respons Message-shape dalam bentuk paling sederhana.

Yang didemonstrasikan

Web Services Server

Mengekspos proses Boomi sebagai endpoint REST di shared web server Atom Cloud.

Parameter query sebagai DPP

petId diterima sebagai dynamic process property query_petId.

Profil JSON

j.PetStore.Pet mengikuti skema Pet Swagger Petstore dan dipakai untuk akses field di decision.

Validasi input

Decision regex menolak ID yang salah dan nama kosong sebelum langkah lain berjalan.

Error yang konsisten

Error memakai bentuk ApiResponse Petstore: code, type, message.

Observabilitas

Shape Notify mencatat setiap pet yang diterima di process log.

Arsitektur solusi

Klien Boomi Atom Cloud · shared web server cURL / Postmanuji manual Aplikasi front-endpengembangan klien Konsol webGitHub Pages /ws/simpleBasic authrute per operasiHTTPS API - Get PetWSS GET · no input DecisionpetId ~ ^[0-9]+$ true → Message: Pet mock false → Message: ApiResponse 400 API - Create PetWSS CREATE · JSON Decisionname ~ .*\S.* true → Notify “Pet accepted” · echo false → Message: ApiResponse 405 Return Documents → respons HTTP (JSON)setiap proses API memanggil proses [SUB]; sub-proses berisi decision dan message
Dua listener Web Services meniru Swagger Petstore. Semua validasi terjadi di proses [SUB], yang dapat diuji secara terpisah.

Referensi API

Base URL: https://<atom-cloud>/ws/simple · autentikasi Basic dengan user shared web server Atom Cloud.

Endpoint BoomiSwagger PetstoreProsesInput → output
GET /getPetstorePet?petId=GET /pet/{petId}PetStore API - Get Pettidak ada → single data
POST /createPetstorePetPOST /petPetStore API - Create Petsingle JSON → single data

Skema Pet (profil j.PetStore.Pet)

FieldTipeKeterangan
idinteger (int64)ID pet
categoryobject {id, name}Kategori
namestringWajib — harus berisi minimal satu karakter selain spasi
photoUrlsarray of stringURL foto
tagsarray of {id, name}Tag
statusstringavailable | pending | sold

Respons

KasusHTTPBody
GET dengan petId angka200Pet mock “doggie” dengan id yang diminta
GET dengan petId kosong atau bukan angka200{"code": 400, "type": "error", "message": "Invalid ID supplied"}
POST dengan nama200Body request, dikembalikan apa adanya
POST tanpa nama yang valid200{"code": 405, "type": "error", "message": "Invalid input: pet name is required"}
Catatan: proses tidak mengatur status HTTP, sehingga listener menjawab 200 bahkan untuk error. Klien perlu mengecek type == "error" di body.

Contoh

curl -u "$BOOMI_USER:$BOOMI_TOKEN" \
  "https://<atom-cloud>/ws/simple/getPetstorePet?petId=123"
{ "id": 123, "category": {"id": 1, "name": "Dogs"}, "name": "doggie",
  "photoUrls": ["https://petstore.swagger.io/photos/doggie.jpg"],
  "tags": [{"id": 1, "name": "friendly"}], "status": "available" }
curl -u "$BOOMI_USER:$BOOMI_TOKEN" -X POST -H "Content-Type: application/json" \
  "https://<atom-cloud>/ws/simple/createPetstorePet" \
  -d '{"id": 10, "name": "Bobby", "category": {"id": 1, "name": "Dogs"}, "status": "available"}'

Desain proses

ProsesShapeLogika
PetStore API - Get PetStart (WSS Listen: PetStore WSS Get Pet) → Process Call → Return DocumentsMenerima GET, meneruskan request ke sub-proses.
[SUB] PetStore Get PetStart (passthrough) → Decision “Valid Pet ID?” → Message → Return Documentsquery_petId cocok dengan ^[0-9]+$ → Pet mock dengan id tersebut; selain itu ApiResponse 400.
PetStore API - Create PetStart (WSS Listen: PetStore WSS Create Pet) → Process Call → Return DocumentsMenerima body JSON, meneruskannya ke sub-proses.
[SUB] PetStore Create PetStart (passthrough) → Decision “Pet Name Provided?” → Notify / Message → Return Documentsname cocok dengan .*\S.* → Notify “Pet accepted: {1}” dan body dikembalikan; selain itu ApiResponse 405.

Keputusan desain

Kasus uji

#RequestHasil yang diharapkan
1GET petId=123Pet doggie, id 123
2GET petId=abcApiResponse 400
3GET petId=-1ApiResponse 400 (tanda minus bukan digit)
4GET tanpa petIdApiResponse 400
5POST dengan nama “Bobby”Body dikembalikan; “Pet accepted” di process log
6POST tanpa namaApiResponse 405
7POST dengan nama hanya spasiApiResponse 405
8POST dengan body kosongApiResponse 405

Semua kasus dapat dijalankan secara interaktif di konsol web.

Mockup konsol web

Konsol statis menjalankan kedua endpoint di browser dengan logika yang sama seperti proses Boomi.

API Console

Susun request GET atau POST, pakai preset untuk setiap kasus uji, dan baca body, header, process log, serta cURL.

Jalur eksekusi

Diagram proses menyorot cabang yang dilalui setiap request.

Pet Shop Demo

Toko kecil yang menambah pet lewat POST dan mengambilnya lewat GET.

Referensi API

Endpoint, skema, respons, dan contoh cURL.

Riwayat request

Setiap request dalam sesi; klik untuk menjalankan ulang.

Jalan di mana saja

HTML, CSS, dan JavaScript biasa di GitHub Pages; tema terang dan gelap.

Buka konsol →

Komponen

JenisKomponenFungsi
Process (WSS)PetStore API - Get PetListener untuk GET getPetstorePet
Process (WSS)PetStore API - Create PetListener untuk POST createPetstorePet
Sub-process[SUB] PetStore Get PetValidasi petId, bangun Pet mock
Sub-process[SUB] PetStore Create PetValidasi nama, catat log, dan kembalikan body
Connector operationPetStore WSS Get PetWeb Services Server · GET · input none · output single data
Connector operationPetStore WSS Create PetWeb Services Server · CREATE · input single JSON · output single data
JSON profilej.PetStore.PetSkema Pet Swagger Petstore

Struktur repositori

Penyiapan & deployment

  1. Salin .env.example ke .env lalu isi akun Boomi, API token, folder tujuan, environment, dan test atom.
  2. Push komponen di active-development/ ke folder platform.
  3. Deploy PetStore API - Get Pet dan PetStore API - Create Pet ke environment Atom Cloud dengan shared web server aktif.
  4. Panggil endpoint dengan user shared web server (Basic auth) dan jalankan kasus uji di atas.

Keterbatasan & langkah berikutnya

Data GET statis

GET selalu mengembalikan “doggie”; pet yang dibuat tidak disimpan.

Kode status HTTP

Atur status HTTP (400/405) lewat header respons agar klien tidak perlu memeriksa body.

Penyimpanan

Simpan pet di database atau Disk V2 dan cari berdasarkan id.

Operasi tambahan

Tambahkan PUT /pet, DELETE /pet/{petId}, dan findByStatus.

API Management

Publikasikan lewat komponen Boomi API Service dengan spesifikasi OpenAPI.

Validasi skema

Validasi status terhadap available | pending | sold serta tipe setiap field.