Pengenalan Perkhidmatan

Perkhidmatan langganan platform Weibo meningkatkan kecekapan aplikasi dalam mendapatkan data Weibo. Mengikut syarat langganan yang ditentukan oleh aplikasi, seperti kata kunci, pengguna, nama domain, dsb., platform secara aktif menolak data yang baru dijana ke aplikasi dalam masa nyata, dan aplikasi tidak perlu meninjau antara muka permintaan.

Kelebihan perkhidmatan langganan adalah seperti berikut:

1. Menolak data baru ke dalam masa nyata

2 kecekapan antara muka akses aplikasi ;

Syarat langganan

Pelanggan:

Pembangun boleh menentukan sehingga 10,000 pengguna. Apabila melanggan Weibo, jika Weibo disiarkan oleh pengguna yang ditentukan, ia akan ditolak apabila melanggan ulasan, ulasan yang disiarkan oleh pengguna yang ditentukan di Weibo (bukan ulasan yang disiarkan oleh pengguna yang dinyatakan) akan ditolak; , tiada sekatan sedemikian.

Kata kunci langganan:

Pembangun boleh menentukan sehingga 20,000 kata kunci. Apabila melanggan Weibo, jika Weibo mengandungi kata kunci yang ditentukan, ia akan ditolak apabila melanggan ulasan, jika Weibo yang sepadan dengan ulasan mengandungi kata kunci ini, atau ulasan itu sendiri mengandungi kata kunci ini, ia akan ditolak; , tidak akan ada had sedemikian. Nota: Apabila kandungan Weibo yang dimajukan tidak mengandungi kata kunci ini, tetapi Weibo asal mengandungi, ia tidak akan ditolak dalam kes ini

Nama domain langganan:

Pembangun boleh menentukan sehingga 20 nama domain. Apabila melanggan Weibo, jika pautan asal yang sepadan dengan pautan pendek dalam Weibo berada di bawah nama domain yang ditentukan, ia akan ditolak apabila melanggan ulasan, ulasan yang sepadan dengan Weibo yang mengandungi pautan pendek dan pautan asal yang sepadan kepada nama domain yang ditentukan akan ditolak; Jika tidak dinyatakan, tiada sekatan sedemikian.

Aplikasi langganan:

Pembangun boleh menentukan untuk menolak hanya data yang dijana oleh aplikasi yang menjana langganan Jika tidak dinyatakan, data semua aplikasi akan ditolak.

Jenis media langganan:

Syarat ini hanya boleh dinyatakan apabila melanggan Weibo. Pembangun boleh menentukan jenis asal, dimajukan, video, muzik atau gambar. Kemudian tolak jenis Weibo yang ditentukan, jika tidak dinyatakan, tiada sekatan sedemikian apabila melanggan komen, tiada syarat penapisan sedemikian;

Jenis data langganan:

Pembangun boleh menentukan untuk menolak Weibo atau mengulas data jika tidak dinyatakan, Weibo akan ditolak secara lalai.

Peratusan langganan:

Pembangun boleh menentukan peratusan data yang memenuhi syarat langganan di atas Jika tidak dinyatakan, 1% daripada data yang memenuhi syarat akan ditolak.

Julat masa langganan:

Pembangun boleh menentukan masa mula tolak dan masa tamat. Perkhidmatan tolak sedia pada masa mula yang ditentukan dan ditamatkan pada masa tamat. Jika tidak dinyatakan, masa mula lalai kepada masa penjanaan langganan dan sentiasa ditolak. Apabila perkhidmatan tolak sedia, pembangun boleh memanggil antara muka untuk menyambung dan menerima data.

Langkah untuk menggunakan

Langkah-langkah untuk menggunakan perkhidmatan langganan adalah seperti berikut:

① Jana langganan:

Pembangun mengisi borang permohonan perkhidmatan langganan di luar talian, mengisi maklumat seperti syarat langganan, dan kakitangan platform menjana langganan berdasarkan maklumat borang permohonan. Setiap aplikasi boleh mempunyai berbilang langganan. Pembangun yang perlu mencuba perkhidmatan langganan boleh menghantar permohonan dalam talian (lihat panduan akses untuk butiran) tanpa mengisi borang permohonan.

② Tetapkan kata kunci langganan dan pengguna:

Jika anda memilih Tidak untuk "Kata Kunci Langganan" dan "Langgan Pengguna" dalam borang permohonan perkhidmatan langganan, abaikan langkah ini. Apabila anda memilih Ya, anda perlu memastikan bahawa senarai langganan kata kunci dan senarai langganan pengguna tidak kosong. Langgan kata kunci dan pengguna (jika anda telah melanggan kata kunci dan pengguna, anda boleh mengabaikan langkah ini), minta antara muka: subscribe/update_subscribe

IP yang diminta untuk antara muka ini mestilah alamat IP dalam senarai IP yang dinyatakan semasa langganan , jika tidak mesej ralat akan dikembalikan: Ip adalah terhad. Apabila hanya subid diluluskan, maklumat langganan langganan dikembalikan, termasuk senarai kata kunci langganan dan senarai pengguna.

Setiap kata kunci dipisahkan dengan koma dan terdapat hubungan logik "ATAU" antara kata kunci yang dipisahkan dengan koma.

Panjang setiap kata kunci tidak boleh melebihi 36 aksara Cina.

Setiap kata kunci menyokong logik "DAN" dan "TIDAK" secara dalaman "DAN" logik dipisahkan oleh "ruang": seperti A B; logik "NOT" dipisahkan oleh "ruang -": seperti A -B. Apabila terdapat petikan berganda pada kedua-dua belah kata kunci, ini bermakna kandungan kata kunci benar-benar sepadan dan operasi logik adalah tidak sah, seperti: "A B", yang tidak lagi mewakili logik A dan B.

Jumlah bilangan subkata kunci yang dipisahkan oleh operator logik dalam setiap kata kunci tidak boleh melebihi 1,000 dan bilangan operator logik untuk setiap langganan tidak boleh melebihi 500.

Kata kunci yang dilanggan setiap kali antara muka dipanggil tidak boleh melebihi 20. Bilangan pengguna yang melanggan setiap panggilan ke antara muka tidak boleh melebihi 50. Jumlah kata kunci dan pengguna untuk setiap langganan tidak boleh melebihi 20,000 dan langganan berulang tidak dibenarkan.

Platform Weibo akan menetapkan kata kunci dan pengguna tertentu kepada keadaan yang dilindungi, dan kata kunci dan pengguna yang dilindungi tidak boleh dilanggan. Selepas kata kunci dilindungi, perkataan yang mengandungi kata kunci ini tidak boleh dilanggan. Kata kunci dan data yang dilanggan yang ditapis mengikut kata kunci tidak sensitif huruf besar-besaran, dipermudahkan atau tradisional.

③ Perkhidmatan tolak sedia:

Jika pembangun menyatakan masa mula tolak dalam borang permohonan, perkhidmatan tolak langganan akan sedia pada masa mula yang ditentukan, perkhidmatan tolak akan sedia selepas langganan dijana .

④ Sambungan aplikasi dan tolak mula:

Jika langganan telah dijana tetapi perkhidmatan tolak belum siap, status tolak dalam latar belakang pengurusan langganan pembangun akan menunjukkan: Menyediakan jika perkhidmatan tolak sudah sedia, ia akan menunjukkan: Sedia . Hanya dalam keadaan sedia boleh aplikasi memanggil antara muka untuk menyambung dan menerima data. Jika tidak, ralat akan dilaporkan semasa memanggil antara muka.

Antara muka panggilan adalah seperti berikut:

● Untuk melanggan Weibo, antara muka panggilan ialah: datapush/status

● Untuk melanggan komen, antara muka panggilan ialah: datapush/komen

panggilan java, lihat kod contoh.

⑤ Data penerimaan aplikasi:

Selepas sambungan berjaya, antara muka akan menolak data Weibo atau mengulas ke alamat sambungan pembangun. Setiap data Weibo atau ulasan yang lengkap dikembalikan dalam bentuk json, pengekodan UTF-8 digunakan secara lalai, dan dipisahkan oleh rn. Panjang maksimum setiap mesej data ialah 4096 bait.

Pulangan data lihat: contoh.

⑥ Penamatan tolak:

Jika pembangun tidak menyatakan masa tamat tolak, tolakan akan terus ditolak; jika masa tamat ditentukan, tolakan akan ditamatkan pada masa tamat tolak yang ditentukan. Ini bersamaan dengan tamat tempoh langganan ini dan tidak akan dimulakan semula.

Arahan penggunaan

Aplikasi menerima data melalui antara muka permintaan sambungan panjang HTTP /datapush/status atau /datatapush/komen. Parameter subid (ID langganan) perlu dihantar untuk memberitahu platform data langganan yang hendak ditolak. Jika permintaan itu betul, hasil data yang sepadan akan dikembalikan. Jika permintaan tidak normal, mesej ralat yang sepadan akan dikembalikan.

Untuk melegakan tekanan pada pelayan, data tolak platform akan diputuskan sambungan setiap sepuluh minit Aplikasi perlu serasi dan antara muka permintaan sambungan panjang HTTP, dan boleh membawa nilai id pemutusan sambungan yang terakhir. nilai parameter since_id Enter, seperti: /datapush/status?subid=xxx&since_id=XXX. Aplikasi boleh terus mendapatkan data dari titik terputus. Oleh itu, aplikasi perlu mengekalkan id apabila perkhidmatan diputuskan sambungan sebagai nilai parameter permintaan seterusnya.

Oleh kerana data yang ditolak oleh perkhidmatan langganan adalah masa nyata, platform hanya mengekalkan lima minit data Jika ia diputuskan selama lebih daripada lima minit, parameter since_id tidak lagi disokong jika since_id dimasukkan, an mesej ralat akan dikembalikan: Param tidak sah since_id (sejak_id Haram, melebihi had masa). Jika since_id tidak diluluskan, platform akan menapis data yang layak antara 50,000 data pertama pada titik masa semasa dan menolaknya kepada pengguna.

Apabila aplikasi menghadapi operasi yang menyalahi undang-undang atau sebab lain, platform akan menggantung fungsi tolak data langganan, iaitu, ia tidak akan menolak data lagi. Sehingga masalah itu diselesaikan, platform boleh memulakan semula fungsi tolak. Aplikasi ini memerlukan sambungan panjang HTTP untuk meminta semula antara muka.

Selain itu, IP antara muka permintaan aplikasi mestilah alamat IP dalam senarai IP yang dinyatakan semasa melanggan, jika tidak mesej ralat akan dikembalikan: Ip terhad (ip terhad).

Penerangan status

Dalam pusat pengurusan pemaju, anda boleh melihat pelbagai status paparan perkhidmatan, seperti yang ditunjukkan dalam kotak merah di bawah:

Terdapat lima status perkhidmatan: menyediakan, sedia, didayakan, digantung dan ditamatkan.

1) Menyediakan:

Langganan telah dijana tetapi belum mencapai masa mula tolak yang ditentukan oleh pembangun, dan berada dalam keadaan penyediaan (pembangun tidak boleh menyambung untuk menerima data pada masa ini). Jika pembangun tidak menyatakan masa mula tolak, selepas langganan dijana, tidak akan ada keadaan penyediaan dan ia akan terus memasuki keadaan sedia.

2) Sedia:

Langganan dijana dan masa mula tolak telah tiba, tetapi pembangun tidak disambungkan untuk menerima data, jadi ia berada dalam keadaan sedia. Atau apabila langganan dijana, pembangun tidak menyatakan masa mula tolak, dan pembangun tidak disambungkan untuk menerima data, perkhidmatan itu juga dalam keadaan sedia.

3) Didayakan:

Dalam keadaan sedia, pembangun menyambung untuk menerima data dan perkhidmatan memasuki keadaan didayakan.

4) Digantung:

Apabila aplikasi mempunyai operasi yang menyalahi undang-undang atau atas sebab lain, platform menggantung fungsi tolakan langganan, perkhidmatan akan bertukar menjadi keadaan digantung.

5) Ditamatkan:

Jika pembangun tidak menyatakan masa tamat tolak, tolakan akan terus ditolak; jika masa tamat ditentukan, tolakan akan ditamatkan pada masa tamat tolak yang ditentukan. Ini bersamaan dengan tamat tempoh langganan ini dan tidak akan dimulakan semula. Perkhidmatan ditamatkan pada masa ini;