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.json

Opsi 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.ipa

GitHub 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/publish

Upload IPA ≤ 95 MB dalam satu request (body = file).

POST/api/v1/uploads

Mulai multipart upload. Body: { fileName, size }.

PUT/api/v1/uploads/:id/parts/:n

Kirim part ke-n (body = bytes). Balikan { partNumber, etag }.

POST/api/v1/uploads/:id/complete

Selesaikan upload. Body: { parts, changelog?, app?, replace? }.

DELETE/api/v1/uploads/:id

Batalkan multipart upload.

PATCH/api/v1/apps/:bundleId

Ubah metadata app (nama, deskripsi, kategori, dll).

PUT/api/v1/apps/:bundleId/icon

Ganti icon (PNG/JPEG/WebP, maks 2 MB).

DELETE/api/v1/apps/:bundleId/versions/:id

Hapus satu versi.

GET/api/v1/me

Cek key yang sedang dipakai.

GET/api/v1/apps

Daftar app publik (tanpa auth).

GET/api/v1/apps/:bundleId

Detail 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.