Membuat merek

Membuat merek: objek tingkat teratas dalam Social API. Merek memiliki akun sosial yang Anda hubungkan dengannya dan setiap postingan yang dipublikasikan dari akun tersebut. Tidak ada operasi lain dalam Social API yang dapat dipanggil sebelum setidaknya satu merek tersedia, sehingga ini merupakan permintaan pertama dalam setiap integrasi Social.

Kasus penggunaan: menyiapkan klien untuk publikasi di media sosial. Saat pelanggan mendaftar di produk Anda, buat satu merek untuk setiap bisnis yang ingin mereka wakili dalam publikasi. Simpan socialProfile.id yang dikembalikan pada catatan bisnis tersebut di sistem Anda: nilai ini digunakan sebagai token jalur brandId dalam POST /social/brands/{brandId}/connections/link dan GET /social/brands/{brandId}/posts, serta sebagai field socialProfileId dalam body setiap postingan yang Anda buat. Kemudian arahkan pengguna melalui tautan koneksi yang dihosting untuk setiap platform tempat mereka ingin memublikasikan postingan.

Catatan.

• Body permintaan harus dibungkus dalam objek input. Setiap operasi tulis dalam Social API dibungkus dengan cara ini, dengan satu pengecualian: tautan koneksi menerima body tanpa pembungkus.
• Periksa success, bukan status HTTP. Kegagalan validasi — profileName yang tidak disertakan atau timezone.tzCode yang tidak dikenal — dikembalikan sebagai HTTP 200 dengan success: false dan alasannya dalam error. Anggap pemanggilan berhasil hanya jika success bernilai true.
• Hanya profileName dan timezone yang wajib diisi. businessIntent dan categories secara default masing-masing bernilai general dan daftar kosong, sehingga integrasi yang tidak memiliki padanan untuk field tersebut dapat menghilangkan keduanya sepenuhnya.
• timezone.tzCode bukan sekadar hiasan. Postingan yang dijadwalkan dengan scheduleDate + scheduleTime ditafsirkan dalam zona waktu merek, bukan zona waktu pemanggil dan bukan UTC. Mengubahnya nanti tidak mengubah waktu postingan yang sudah dijadwalkan.
• Merek selalu menjadi milik akun yang terkait dengan kunci API. Tidak ada cara untuk membuat merek di akun lain: pengenal akun apa pun dalam body diabaikan.
• ID merek berupa UUID biasa. ID tersebut bukan ID relay Base64 yang digunakan oleh Locations dan Posts lokasi, jadi jangan melakukan encoding atau decoding terhadapnya. ID yang sama muncul sebagai token jalur brandId dan sebagai field socialProfileId dalam body: brandId selalu hanya merupakan token URL, tidak pernah menjadi field dalam body.
• Tidak ada batas jumlah merek pada paket API. Jumlah merek tidak dibatasi dan tidak dihitung sebagai penggunaan, sehingga pemanggilan ini tidak pernah ditolak karena batas jumlah dan Anda tidak perlu memeriksa kapasitas yang tersisa sebelum membuat merek. Yang dihitung sebagai penggunaan adalah koneksi — satu akun sosial yang ditautkan ke satu merek di satu jaringan. Lihat Paket dan add-on untuk mengetahui tingkatan koneksi dan harga paket koneksi, serta GET /social/limits untuk membaca kapasitas koneksi Anda yang tersisa sebelum mengarahkan pengguna melalui tautan koneksi.

Operasi tulis: tidak dijalankan pada akun aktif. Permintaan dan respons yang ditampilkan dibuat berdasarkan skema API.