Developer
Publish dari terminal, CI, atau agent.
Satu API key, satu perintah. Bundle ID, versi, build, iOS minimal, dan icon dibaca langsung dari file IPA. Upload versi baru dengan bundle ID yang sama = update.
1. Minta API key
Admin membuat key di panel admin. Key bisa dibatasi ke satu bundle ID, atau bebas untuk app baru.
2. Upload IPA
Pakai publish.mjs (Node 18+, tanpa dependency) atau curl biasa. File besar otomatis dipecah per 64 MB.
3. Otomatis tayang
App muncul di katalog dan source AltStore. Pengguna yang sudah add source dapat notifikasi update.
Quickstart
Cara paling gampang. Script mengurus multipart, retry, dan icon.
curl -fsSLO https://sideload.upkan.id/publish.mjs
SIDELOAD_KEY=upk_xxxxxxxx node publish.mjs build/MyApp.ipa \
--changelog "Perbaikan crash di halaman login" \
--metadata app.jsonOpsi lain: --changelog-file CHANGES.md, --icon icon.png, --replace (timpa versi+build yang sama), --url untuk server lain.
Metadata app
Opsional. Dikirim saat upload (field app) atau kapan saja lewat PATCH /api/v1/apps/:bundleId.
{
"name": "MyApp",
"subtitle": "Catatan cepat untuk anak kos",
"description": "Deskripsi panjang…",
"developerName": "Nama kamu",
"category": "utilities",
"websiteUrl": "https://example.com",
"sourceCodeUrl": "https://github.com/kamu/myapp",
"tintColor": "#F97316"
}Kategori: games, utilities, social, entertainment, photo-video, lifestyle, developer, other.
Pakai curl saja
Untuk IPA sampai 95 MB. Di atas itu, pakai multipart upload.
curl -X POST "https://sideload.upkan.id/api/v1/publish?filename=MyApp.ipa" \
-H "Authorization: Bearer $SIDELOAD_KEY" \
-H "X-Changelog: $(printf %s 'Versi baru' | jq -sRr @uri)" \
--data-binary @build/MyApp.ipaGitHub Actions
Simpan key sebagai repository secret SIDELOAD_KEY.
# .github/workflows/sideload.yml
name: Publish to Upkan Sideload
on:
release:
types: [published]
jobs:
publish:
runs-on: macos-latest
steps:
- uses: actions/checkout@v4
# … build & export .ipa ke build/MyApp.ipa …
- name: Upload IPA
env:
SIDELOAD_KEY: ${{ secrets.SIDELOAD_KEY }}
run: |
curl -fsSLO https://sideload.upkan.id/publish.mjs
node publish.mjs build/MyApp.ipa --changelog "${{ github.event.release.body }}"Endpoint
Semua endpoint tulis butuh header Authorization: Bearer upk_…. Error selalu berbentuk { error }.
| POST | /api/v1/publishUpload IPA ≤ 95 MB dalam satu request (body = file). |
| POST | /api/v1/uploadsMulai multipart upload. Body: { fileName, size }. |
| PUT | /api/v1/uploads/:id/parts/:nKirim part ke-n (body = bytes). Balikan { partNumber, etag }. |
| POST | /api/v1/uploads/:id/completeSelesaikan upload. Body: { parts, changelog?, app?, replace? }. |
| DELETE | /api/v1/uploads/:idBatalkan multipart upload. |
| PATCH | /api/v1/apps/:bundleIdUbah metadata app (nama, deskripsi, kategori, dll). |
| PUT | /api/v1/apps/:bundleId/iconGanti icon (PNG/JPEG/WebP, maks 2 MB). |
| DELETE | /api/v1/apps/:bundleId/versions/:idHapus satu versi. |
| GET | /api/v1/meCek key yang sedang dipakai. |
| GET | /api/v1/appsDaftar app publik (tanpa auth). |
| GET | /api/v1/apps/:bundleIdDetail app + semua versi (tanpa auth). |
Aturan
Biar katalog tetap rapi.
- Kombinasi versi + build harus unik per app. Naikkan CFBundleVersion untuk tiap upload.
- Key yang dibatasi ke satu bundle ID akan ditolak (403) bila IPA berisi bundle ID lain.
- Ukuran maksimal IPA 4 GB. Part multipart 64 MB, kecuali part terakhir.
- Hanya upload aplikasi yang kamu punya haknya untuk didistribusikan.