Dokumentasi pengembang
Pertanyaan dan jawaban pengembang
Jawaban langsung tentang alias npm, pilihan API dan MCP, autentikasi, media, percobaan ulang aman, batas laju, dan arti sebenarnya dari dipublikasikan.
Baca sebagai MarkdownDitinjau tim SosoAPI ·
Apakah empat paket npm merupakan SDK berbeda?
Tidak. Instal sosoapi atau salah satu aliasnya: @sosoapi/cli, sosoapi-cli, atau sosoapi-mcp. Setiap alias menggunakan versi persis yang sama dari implementasi CLI dan MCP. Anda hanya memerlukan satu.
Haruskah saya menggunakan HTTP, CLI, atau MCP?
Gunakan HTTP dari server Anda, CLI untuk otomatisasi shell dan pemeriksaan skema, atau MCP dengan agen kompatibel. Semuanya menggunakan kontrak API publik yang sama. MCP juga menyediakan unggahan file lokal dan alat posting URL gambar yang menangani persiapan media untuk Anda. Jauhkan kredensial server dari kode browser.
Apakah pengaturan atau persetujuan OAuth memublikasikan postingan?
Tidak. Pengaturan tidak memublikasikan apa pun. Persetujuan OAuth memberikan akses berkelanjutan dalam cakupan pilihan Anda, tanpa persetujuan browser baru untuk setiap penulisan. Beri tahu agen kapan harus menunggu tinjauan, dan periksa akun, konten, serta waktu sebelum memintanya memublikasikan.
Apakah HTTP 200 atau 202 berarti sudah dipublikasikan?
Tidak. Permintaan mungkin diterima, terjadwal, atau masih diproses. Simpan ID postingan dan baca Scheduled Post yang sama sampai hasilnya mengonfirmasi publikasi. Sertakan permalink jika tersedia, dan laporkan hasil setiap tujuan secara terpisah.
Bisakah saya mencoba lagi setelah timeout?
Periksa operasi yang ada terlebih dahulu. Simpan ID Scheduled Post dan gunakan kunci idempotensi sama untuk permintaan sama. Jika payload berubah, itu permintaan berbeda. Untuk mencoba ulang, memperbarui, atau membatalkan postingan yang ada, gunakan versi terkini dan tindakan yang ditawarkan SosoAPI untuk status tersebut.
Mengapa alat tidak ada di klien saya?
Periksa profil, jenis koneksi, dan apakah klien telah memuat ulang server. Core menyembunyikan alat administrasi; koneksi HTTP tidak menyertakan unggahan file lokal. Referensi alat mencantumkan ketersediaan. Mengubah profil tidak mengubah izin atau kelayakan akun.
Bisakah MCP jarak jauh mengunggah file lokal?
Tidak. Gunakan MCP lokal untuk mengunggah file dari folder diizinkan, atau impor URL media publik melalui HTTP. Periksa impor sampai siap, lalu gunakan ID aset terdaftar bersama URL kanonis. Impor diterima masih dalam proses.
Apa batas laju dan paketnya?
Periksa setiap skema untuk batas kolom, daftar, dan paginasi. studio-api mengizinkan 240 permintaan per menit per pengguna untuk sesi manusia, dengan alokasi terpisah 480 per menit untuk kredensial mesin pengguna tersebut. Ikuti 429 dan Retry-After. Kuota paket, batas penyedia, dan kelayakan akun terpisah; baca informasi penagihan dan kemampuan terkini sebelum proses berskala besar.
Di mana Markdown dan skema?
Tambahkan .md ke URL panduan, operasi API, atau alat MCP untuk versi Markdown. Indeks API menautkan kontrak JSON publik dan dokumen OpenAPI 3.1. Mulai dari llms.txt untuk indeks halaman, atau llms-full.txt untuk referensi lengkap dalam kedua bahasa. File ini berisi dokumentasi publik, bukan data akun atau kredensial.
Apakah dokumentasi ini menjamin kemunculan di pencarian atau kutipan AI?
Tidak. Halaman HTML, URL kanonis, metadata terstruktur, dan Markdown membantu sistem membaca dokumentasi. Mesin pencari dan layanan AI tetap memilih yang akan diindeks, diberi peringkat, atau dikutip. Periksa hasil tersebut secara terpisah dari ketersediaan halaman.