Semak dokumentasi
Rujukan API
YouTube Download API
Muaturun video atau audio YouTube ke penyimpanan awan anda. BAHASA Pilih resolusi, format dan durasi klip, kemudian lacak pekerjaan asinkron melalui penyelesaian.
API muat turun video YouTube — contoh Python
Bina permintaan
Karakter 11-karakter ID dari video URL, bukan URL penuh.
Pilihan media lanjutan
Pemilih format untuk format akan membatalkan kualitas, tingkat bingkai dan pemilihan audio-bahasa. Format keluaran dan batas klip yang masih berlaku. Klip Klip ujung harus mengikuti awal; kedua batas dapat diabaikan.
Destinasi Penyimpanan WARGA
Bousdon menggunakan tanggal upload UTC (YYYYMMDD).
Tambahkan bukti kelayakan penyimpanan Anda pada server Anda sebelum menjalankan kode. Mereka perlu izin untuk mengunggah file.
Persyaratan kelayakan dan penyimpanan Penyediaanwebhook pelengkapan hasil penyempurnaan dilakukan
Muatan Webhook, verifikasi dan retriyMarkdown berlaku untuk hasil yang telah selesai. Penerimaan dan status pekerjaan mempertahankan bidang asal mereka.
https://data.flashdata.dev/v1/queriesParameter
Kirim source Dan video_id Di tingkat atas. Pilihan sumber termasuk dalam params. Bidang opsional dapat diabaikan.
Badan permintaan
sourcestring / Wajib- Ditetapkan untuk youtube_download.
video_idstring / Wajib- Karakter 11-karakter YouTube video ID, seperti FUfGcZ092b0. 280 Terima huruf, angka, underscore dan tanda hubung.Tepatnya 11 aksaraDefault:
Tidak DisetFormat yang telah Diterima
^[A-Za-z0-9_-]{11}$ paramsobject / Wajib- Settings untuk permintaan ini.
callback_urlstring · nullable / Pilihan- Async dan hanya kelumpuhan. Kompisi HTTPS publik URL pada port 443, hingga karakter 2,048. Kelayakan pengguna tidak ada atau fragmen URL. Omit, gunakan null atau string kosong tanpa pemberitahuan. Dalam kelompok, set ini pada setiap pertanyaan, param luar.Default:
Tidak Diset
Video & audio
params.download_typestring / Pilihan- audio_video gabungkan video dan audio; video pilih video saja; audio pilih audio saja.1 Ke 11 aksaraNilai-Nilai:
audio_video / video / audioDefault:"audio_video" params.video_qualitystring / Pilihan- Pemilihan resolusi video. \"Omit\" untuk unduhan audio-saja.1 Ke 40 aksaraNilai-Nilai:
best / worst / <=144 / ==144 / >=144 / <=360 / ==360 / >=360 / <=480 / ==480 / >=480 / <=720 / ==720 / >=720 / <=1080 / ==1080 / >=1080 / <=1440 / ==1440 / >=1440 / <=2160 / ==2160 / >=2160 / <=4320 / ==4320 / >=4320Default:"<=720" params.fpsstring / Pilihan- Kekangan Frame-rate: >=, <= atau == diikuti dengan nilai dari 1 ke 240. \"Omit\" untuk unduhan audio-saja.1 Ke 6 aksaraDefault:
Tidak DisetFormat yang telah Diterima
^(?:>=|<=|==)(?:[1-9]\d?|1\d\d|2[0-3]\d|240)$ params.audio_languagestring / Pilihan- Pemilihan trek audio. Applise untuk audio_video dan audio.1 Ke 8 aksaraNilai-Nilai:
default / originalDefault:"default" params.audio_qualitystring / Pilihan- Audio berbasis-saja bitrate dalam kbps, atau terbaik. Pilihan angka angka harus dikirim sebagai string. Omit untuk unduhan video.1 Ke 10 aksaraNilai-Nilai:
best / 320 / 256 / 192 / 128Default:"best" params.output_formatstring / Pilihan- Video: mp4, webm atau mkv. Audio: m4a, mp3 atau opus.1 Ke 10 aksaraNilai-Nilai:
mp4 / webm / mkv / m4a / mp3 / opusDefault:mp4 (video) / m4a (audio) params.yt_dlp_formatstring / Pilihan- Pemilih format lanjutan dari 1 ke 1,024 karakter setelah pemangkasan spasi. Karakter kontrol jardin ditolak. Diskronds video_quality, fps dan audio_language, yang nilai-nilainya kemudian diabaikan; format output dan kliping masih berlaku.1 Ke 1,024 aksaraDefault:
Tidak Diset params.upload_metadataboolean / Pilihan- upload data metadata berkas JSON di samping berkas media dalam penyimpanan Anda.
trueOR atau ORANGfalseDefault:false
Klipping Kliping Kliping
params.start_atstring / Pilihan- Masa mula klip dalam format H:MM:SS atau HH:MM:SS, dari 00:00:00 hingga 12:00:00. Nilai lalai ialah 00:00:00 apabila hanya end_at diberikan.1 Ke 8 aksaraDefault:
Tidak DisetFormat yang telah Diterima
^\d{1,2}:[0-5]\d:[0-5]\d$ params.end_atstring / Pilihan- Klip klip Klip berakhir dalam format H:MM:SS atau HH:MM:SS, hingga 12:00:00. Pasti lebih lambat dari start_at.1 Ke 8 aksaraDefault:
Tidak DisetFormat yang telah Diterima
^\d{1,2}:[0-5]\d:[0-5]\d$
Destinasi Penyimpanan WARGA
params.storageobject / Wajib- Destinasi untuk berkas media yang telah selesai. Hanya ladang penyimpanan terdaftar yang diterima.
params.storage.storage_typestring / Wajib- Penyedia penyimpanan barang: s3, s3_compatible, oss, gcs, azure, cos, bos atau tos.
params.storage.storage_urlstring / Wajib- Nama ember atau wadah yang tidak kosong, hingga karakter 1,024. Ruang angkasa yang mengelilinginya telah dihapus. Untuk s3, gunakan nama baldi AWS yang valid tanpa URL atau jalur folder; folder termasuk dalam object_prefix.
params.storage.object_prefixstring / Pilihan- Awalan Object-key, 1 ke karakter 512. Setiap segmen dipisahkan garis miring menerima huruf ASCII, digit, titik, underscore dan tanda hubung; segmen kosong, . dan .. ditolak. Tidak ada garis miring terkemuka. Ruang putih yang mengelilingi dan satu jejak miring dihilangkan. YYYYYMMDD menggunakan tanggal unggah UTC, termasuk dalam archive/YYYYMMDD.Default:
"YYYYMMDD" params.storage.access_keystring / Pilihan- Kunci akses untuk S3, S3-compatible, OSS, COS, BOS atau TOS; dipasangkan dengan secret_key.
params.storage.secret_keystring / Pilihan- Kunci rahasia untuk S3, S3-compatible, OSS, COS, BOS atau TOS.
params.storage.endpoint_urlstring / Pilihan- Titik akhir HTTPS Publik untuk penyimpanan kompatibel S3 atau OSS. COS, BOS dan TOS menghasilkannya dari daerah.
params.storage.regionstring / Pilihan- Aquired untuk COS, BOS dan TOS; juga memasok untuk S3 dan S3-compatible downloads. Nama - nama ember baldi baldi dari COS termasuk APPID.
params.storage.service_accountobject / Pilihan- Akun layanan GCS: project_id, client_email dan PEM private_key.
params.storage.account_namestring / Pilihan- Nama akun penyimpanan Azure. Use the container nama dalam storage_url.
params.storage.sas_tokenstring / Pilihan- Azure yang dapat ditulis dengan kata sandi dan tanda tangan.
Respons
Ahli pembangun permintaan mengajukan unduhan dengan Async atau Batch dan membutuhkan params.storage. HTTP 200 dengan status: pending Kepastian penerimaan, bukan pengiriman. Haxeb Batch mengembalikan satu penerimaan kerja per video ID.
Submisi usage.credits Ini adalah.. 0. Unduhan-unduhan COMMAND ditagih oleh volume media yang disampaikan setelah pengiriman sukses; berkas data meta opsional tidak menambah biaya muat turun.
OB job.status Fijiananan-ananan sampai completed, kemudian mengambil hasil JSON. Baca rincian media di results[0], Termasuk objek yang diunggah file_url, ukuran berkas dan checksum.
Baca hasilnya
Setelah pekerjaan selesai, simpan JSON dari link hasil sebagai response.json. Simpan ini sebagai read-response.py dan jalankan python read-response.py. Ia membaca rincian berkas tanpa mengunduh media atau membuat permintaan lain.
import json
from pathlib import Path
response = json.loads(Path("response.json").read_text(encoding="utf-8-sig"))
if response.get("status") not in ("done", "completed") or not isinstance(response.get("results"), list):
raise SystemExit("Expected completed result JSON; inspect the response or job status.")
if not response["results"]:
print("[]")
raise SystemExit(0)
result = response["results"][0]
output = {name: result.get(name) for name in (
"file_url", "file_size", "md5", "duration", "output_format"
)}
# Use your storage credentials to access the media at file_url.
print(json.dumps(output, ensure_ascii=False, indent=2))Status faks mungkin mencakup rincian media dalam job.result. Default JSON Pengaliran kerja menggunakan mereka ketika tersedia dan sebaliknya mengikuti rel: results Hubungan vinalis; jangan menganggap hasil inline selalu ada.
Semua medan respon penyerahan
| Ukrainian | Keterangan |
|---|---|
idstring | download pekerjaan ID. |
sourcestring | youtube_download. |
statusstring | Bertangguh ketika pekerjaan diterima. |
created_atstring | Waktu penciptaan Job freak tooling dalam format ISO 8601. |
usage.creditsnumber | 0 pada pengiriman. Unduhan-unduhan telah dibebankan oleh volume data yang disampaikan setelah selesai. |
linksarray | ** Ikuti self link untuk status pekerjaan dan link hasil untuk keluaran selesai. |
links[].relstring | Kegandirian atau hasil. |
links[].hrefstring | URL pertanyaan untuk ditanya dengan pertanyaan yang sama API Kuncinya. |
links[].methodstring | GET. |
Medan berkas media Completed
| Ukrainian | Keterangan |
|---|---|
results[0].file_urlstring | Lokasi file media di penyimpananmu. |
results[0].file_sizeinteger | Ukuran berkas media di byte. |
results[0].downloaded_bytesinteger | Bile media yang dikirim digunakan untuk penagihan. |
results[0].md5string | Checksum MD5 dari berkas media. |
results[0].resolutionstring · nullable | Resolusi video, atau null untuk output audio-saja atau ketinggian tidak tersedia. |
results[0].durationnumber · nullable | Durasi dalam detik ketika tersedia. |
results[0].output_formatstring | format berkas keluaran. |
results[0].fpsnumber · nullable | Tingkat frame ketika tersedia. |
results[0].video_codecstring · nullable | Kodeks video kodeks faks bila tersedia. |
results[0].audio_codecstring · nullable | Kodeks audio kodeks kodeks faks bila tersedia. |
results[0].dynamic_rangestring · nullable | Kisaran dinamis video yang terkodinamik bila tersedia. |
results[0].metadataobject · optional | Metadata file_url, file_size dan md5 ketika upload_metadata adalah true. Metadata byte dikecualikan dari biaya muat turun. |
Bidang-bidang di atas menggambarkan respon JSON baku. Pilihan format yang diterapkan pada catatan pengiriman, bukan berkas media. JSON, teks polos dan Markdown format.
Zavous Async & batch lifecycle
Surat penyerahan mengembalikan penerimaan, bukan hasil. Async menciptakan satu pekerjaan; batch mengembalikan pekerjaan yang terpisah dalam queries[] Untuk setiap pertanyaan yang diterima. Track dan mendapatkan setiap pekerjaan secara independen.
Diserahkan ke data.flashdata.dev; baca status pekerjaan dan hasil dari api.flashdata.dev Dan X-API-Key yang sama. Contoh dasar API terkait menggunakan Python dan cURL.
1. Simpan pekerjaan IDs
Ajukan satu unduhan dengan Async, atau letakkan permintaan unduhan berganda di dalam sebuah Batch query array. Setiap entri membutuhkan params.storage. Simpan setiap pekerjaan yang dikembalikan ID.
2. Periksa status
GET https://api.flashdata.dev/v2/jobs/{jobId}pending/processing: jajak pendapat dengan penundaan dan rasa hormatRetry-AfterKetika hadir.completed: Hasil tangkapan.failed: [ : ] inspeksijob.error.Read job.status, bukan status penerimaan.
Periksa status · Python dan cURL
Referensi API status Job3. Hasil kutipan
GET https://api.flashdata.dev/v2/jobs/{jobId}/resultsSelepas selesai, sahkan akses untuk membaca hasil, kemudian ambil URL storan daripada 302 tanpa kunci API anda. Simpan JSON dalam masa 24 jam selepas selesai.
JSON menggambarkan media yang dikirimkan ke penyimpananmu. Akses berkas media.
Hasil kutip · Python dan cURL · Format respons
Hasil pengambilan gambar referensi API
Pengejaan dan pengambilan hasil yang sudah ada tidak mengkonsumsi kredit pertanyaan. TOPN TPS tidak membatalkan pekerjaan: menjaga ID daripada mengajukan pekerjaan yang dapat ditagih. Kode galat dan perilaku coba ulang dan kode galat.
Webhook penyelesaian
Langganan per pertanyaan
**Ditetapkan* callback_url Di tingkat atas dari permintaan async, atau lema di dalam setiap pertanyaan Di dalam kelompok, di luar params. Tidak ada permintaan pendaftaran-keuskupan webhook terpisah yang diperlukan.
Use a public HTTPS URL di port 443. FlashData POSTs sebuah pemberitahuan untuk setiap jangkauan pekerjaan completed OR atau ORANG failed; BARV; acara tersebut berisi tautan, bukan hasil itu sendiri.
Mengakui dan memverifikasi
AWAS 2xx Setelah menerima acara itu dengan baik. Duakan duplikasi oleh delivery_id, Dan dikirim sebagai.. X-Delivery-Id. Redirect tidak diikuti.
Pengiriman Gagal dicoba dengan pengunduran eksponensial, hingga Total percobaan 8 Zain dan paling banyak 24 jam sesudah selesai. Tetap melakukan pemungutan suara sebagai kemunduran.
Panggilan balik tidak ditandatangani. Konfirmasi pekerjaan ID, sumber dan status terminal melalui Titik akhir status tersahihkan Bekal sebelum memproses pemberitahuan. Kiriman ID adalah untuk deduksi, bukan bukti keaslian.
Contoh senam webhook peristiwa dan bidang
{
"delivery_id": "completion:job_example0001",
"id": "job_example0001",
"source": "youtube_download",
"status": "completed",
"links": [
{
"rel": "self",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001",
"method": "GET"
},
{
"rel": "results",
"href": "https://api.flashdata.dev/v2/jobs/job_example0001/results",
"method": "GET"
}
]
}| Ukrainian | Keterangan |
|---|---|
delivery_idstring | Pengenal pengiriman yang stabil. Pemberitahuan dundaplikasi menggunakan nilai ini; juga dikirim dalam header X-Delivery-Id. |
idstring | Yob ID. |
sourcestring | Sumber data yang dimintakan oleh KANTOR. |
statusstring | Gagal atau gagal. |
linksarray | Status dan hasil link. Pemakluman kata nifaks tidak termasuk konten hasil atau kunci API. |
links[].relstring | Kegandirian atau hasil. |
links[].hrefstring | Manajemen Absolute API URL; sahihkan dengan kunci API anda. |
links[].methodstring | GET. |
Pemrosesan berkas Bulk
loadloadload satu video ID per baris dan membuat pekerjaan Bulk dengan sumber: youtube_download. Pilihan terkongsi diterapkan untuk setiap ID dalam berkas.
Letakkan destinasi storan yang diperlukan dalam options.storage setting media di dalam options. download job-job tunggal dan Batch menggunakan params.storage sebagai gantinya.
File media telah dikirimkan ke penyimpanan awanmu. Hasil Bulk yang telah selesai termasuk bagian manifes dan hasil yang menggambarkan unduhan. Simpan manifes dan bagian dalam 24 jam setelah seluruh pekerjaan Bulk selesai.
Pemrosesan Bulk API · Python dan cURL · Permintaan Batch JSON
Bina aliran kerja Bulk untuk sumber ini · Dikaku, lanjutkan dan pulihkan
Destinasi Penyimpanan WARGA
Termasuk params.storage Di setiap permintaan unduhan. **Ditetapkan* storage_url Ke dalam ember atau nama kontainermu, dan pengadaan kelayakan dengan akses tulis. Simpan bukti penyimpanan di servermu.
{
"storage_type": "s3_compatible",
"storage_url": "your-media-bucket",
"object_prefix": "archive/YYYYMMDD",
"endpoint_url": "https://your-s3-endpoint.example.com",
"region": "your-provider-region",
"access_key": "<storage-access-key>",
"secret_key": "<storage-secret-key>"
}object_prefix default ke YYYYMMDD, diganti dengan tanggal unggahan UTC. Use an fixed directory atau template seperti archive/YYYYMMDD.
s3- Bekalan access_key dan secret_key dengan akses tulis. Wadison Set wilayah ke wilayah AWS ember Anda.
s3 Contoh
{ "storage_type": "s3", "storage_url": "your-media-bucket", "access_key": "YOUR_ACCESS_KEY", "secret_key": "YOUR_SECRET_KEY", "region": "us-east-1" } s3_compatible- Bekalan access_key, secret_key dan HTTPS umum endpoint_url. Kelayakan Set wilayah sebagaimana diperlukan oleh penyedia Anda; Cloudflare R2 menggunakan auto.
s3_compatible Contoh
{ "storage_type": "s3_compatible", "storage_url": "your-media-bucket", "access_key": "YOUR_ACCESS_KEY", "secret_key": "YOUR_SECRET_KEY", "endpoint_url": "https://YOUR_ACCOUNT_ID.r2.cloudflarestorage.com", "region": "auto" } azure- Bekalan account_name dan sas_token, sebuah wadah SAS dengan izin penulisan (sp termasuk w), sumber daya sr=c, expiry se, versi sv dan tanda tangan sig. storage_url adalah nama wadah. Jangan kirim endpoint_url, access_key atau secret_key.
azure Contoh
{ "storage_type": "azure", "storage_url": "your-media-container", "account_name": "yourstorageaccount", "sas_token": "sv=2023-11-03&sr=c&sp=w&se=2099-01-01T00%3A00%3A00Z&sig=YOUR_SAS_SIGNATURE" } bos- Bekalan access_key, secret_key dan wilayah: bj, su atau hkg. Titik akhir lema diambil dari wilayah ketika diabaikan. buldon Gunakan nama ember tanpa titik.
bos Contoh
{ "storage_type": "bos", "storage_url": "your-media-bucket", "access_key": "YOUR_ACCESS_KEY", "secret_key": "YOUR_SECRET_KEY", "region": "bj" } cos- Bekalan access_key, secret_key dan wilayah ap-*, seperti ap-hongkong. storage_url harus termasuk akhiran APPID. Jangan sesekali mengirim endpoint_url; ini berasal dari wilayah.
cos Contoh
{ "storage_type": "cos", "storage_url": "your-media-bucket-1234567890", "access_key": "YOUR_ACCESS_KEY", "secret_key": "YOUR_SECRET_KEY", "region": "ap-hongkong" } gcs- Bekalan service_account dengan project_id, client_email (sebuah alamat .gserviceaccount.com), dan PEM private_key dari akun layanan Anda. Akun itu pasti punya akses untuk menulis ke ember. Jangan kirim access_key, secret_key, wilayah atau endpoint_url.
gcs Contoh
{ "storage_type": "gcs", "storage_url": "your-media-bucket", "service_account": { "project_id": "your-project-id", "client_email": "[email protected]", "private_key": "-----BEGIN PRIVATE KEY-----\nYOUR_PRIVATE_KEY\n-----END PRIVATE KEY-----\n" } } oss- Bekalan access_key, secret_key dan wilayah ember umum HTTPS endpoint_url.
oss Contoh
{ "storage_type": "oss", "storage_url": "your-media-bucket", "access_key": "YOUR_ACCESS_KEY", "secret_key": "YOUR_SECRET_KEY", "endpoint_url": "https://oss-cn-hongkong.aliyuncs.com" } tos- Bekalan access_key, secret_key dan wilayah dengan awalan cn-, ap-, eu- atau us-. Titik akhir lema diambil dari wilayah ketika diabaikan. buldon Gunakan nama ember tanpa titik.
tos Contoh
{ "storage_type": "tos", "storage_url": "your-media-bucket", "access_key": "YOUR_ACCESS_KEY", "secret_key": "YOUR_SECRET_KEY", "region": "cn-beijing" }
Hasil yang dihasilkannya file_url Kekekalan mengidentifikasi sebuah objek di penyimpanan Anda. Objek-objek swasta membutuhkan otorisasi penyedia penyimpanan Anda atau URL yang ditandatangani; kunci FlashData API tidak memberikan akses ke ember Anda.
Untuk penyerahan lengkap, pemungutan suara dan unduh alur kerja, lihat Muaturun audio YouTube ke Amazon S3.
Penyerahan Fail
Pekerjaan itu rel: results default titik akhir untuk arah kembali ke Hasil nirfitch JSON, Bukan unduhan MP4. FlashData mengunggah media yang sebenarnya ke dalam ember atau wadah yang Anda sediakan. Retensi media cambuk mengikuti kebijakan ember Anda; hasil pekerjaan JSON berakhir 24 jam setelah selesai.
results[0].file_url mengidentifikasi objek tersebut tetapi tidak secara otomatis menjadi publik atau ditandatangani URL. Media swasta akses bertransaksi dengan penyimpanan SDK, atau hasilkan URL yang bertanda pendek pada server Anda sendiri. Jangan kirim kunci FlashData API ke penyedia penyimpanan anda.
Dayakan upload_metadata Untuk upload {video_id}_meta.json pendamping dalam awalan yang sama. Lokasi dan checksum muncul di bawah results[0].metadata.
Mode unduhan Browser konsol terpisah. unduhan API Publik tunggakan menggunakan storan anda sendiri; jangan sertakan konsol-sahaja browser_delivery setting.
Pemulihan Galat
MUKA kegagalan atau penyimpanan 403, periksa provider, ember, wilayah, titik akhir dan obyek-tulis ijin. ORANG atau swasta yang tidak dapat dijangkau atau swasta file_url Bukan dengan sendirinya berarti unggahan gagal: periksa objek melalui penyedia penyimpanan anda.
COMVE Sebuah video yang dihapus atau tidak tersedia tidak dapat dipulihkan dengan polling. Untuk format yang tidak tersedia, inspeksi Format metadata, kekangan kualitas relaks atau hapus pemilih lanjutan. Permintaan hanya-Audio diperlukan m4a, mp3 OR atau ORANG opus; permintaan video diperlukan mp4, webm OR atau ORANG mkv.
Jika hasil JSON telah berakhir, pertama cek ember Anda untuk media yang disampaikan. Perpindahan ulangan akan menciptakan unduhan baru dan mungkin menimbulkan muatan lain; ia tidak memulihkan hasil lama JSON.
Untuk autentikasi, keseimbangan, permintaan-format dan tingkat-batas kegagalan, gunakan referensi kesalahan bersama. Pengerahan surat perintah mungkin masih menciptakan pekerjaan; memeriksa pekerjaan yang sudah ada sebelum mencoba lagi.
Ralat dan kod status · Bila hendak mencoba lagi · Batasan kadar laklak
Panduan langkah demi langkah: unduh satu video dan sahkan pengiriman
Harga
| Rencana | Kadar penggunaan terminologiPer GB terkirim | Langganan | Kredit yang disertakan per perioda penagihan |
|---|---|---|---|
| Bayar mengikut penggunaan | USD 0.10 | Tiada yuran bulanan | Tambah nilai apabila perlu |
| Micro | USD 0.08 | USD 49.00 / month | 1,000 Kerugian (USD 50.00 WOVE API penggunaan ) disertakan |
| Starter | USD 0.07 | USD 199.00 / month | 4,000 Kerugian (USD 200.00 WOVE API penggunaan ) disertakan |
| Pro | USD 0.06 | USD 499.00 / month | 10,000 Kerugian (USD 500.00 WOVE API penggunaan ) disertakan |
| Scale | USD 0.05 | USD 999.00 / month | 20,000 Kerugian (USD 1,000.00 WOVE API penggunaan ) disertakan |
| Business | USD 0.04 | USD 1,999.00 / month | 40,000 Kerugian (USD 2,000.00 WOVE API penggunaan ) disertakan |
Satu pelan akaun. Kredit dikongsi merentas ketiga-tiga produk. Penggunaan yang diliputi kredit pelan tidak dikenakan caj sekali lagi.
Harga dasar dan batas rencana