Skip to main content

The Ultimate Multisite Register API endpoint

Энэхүү тусламжтай материалд та Ultimate Multisite /register API endpoint-ийг ашиглан өөрийн сүлжээнд шинэ хэрэглэгч бүрт оруулах бүх анхан шатны үйл явцыг яаж хийхийг, мөн Zapier-ээр хэрхэн хийхийг сурч үзэх болно.

Энэ endpoint нь POST (POST) аргыг ашигладаг бөгөөд URL _**https://yoursite.com/wp-json/wu/v2/register**_ -ээр дуудагддаг. Энэ дохиог таны сүлжээнд 4 үйл явц гүйцэтгэнэ:

  • Шинэ WordPress хэрэглэгч эсвэл хэрэглэгчийн ID-ээр түүнийг тодорхойлох замаар шинээр үүсгэнэ.

  • Ultimate Multisite-д шинэ Хэрэглэгч эсвэл хэрэглэгчийн ID-ээр түүнийг тодорхойлох замаар шинээр үүсгэнэ.

  • WordPress сүлжээнд шинэ сайт үүсгэнэ.

  • Эцэст нь, Ultimate Multisite-д шинэ Гишүүнчлэл (Membership) үүсгэнэ.

Энэхүү үйл явцад таны API credentials хэрэгтэй болно. Үүнийг авахын тулд таны сүлжээний администратор панельд орж, Ultimate Multisite > Settings > API & Webhooks руу очиж, API Settings хэсгийг хайвал олж авна уу.

API Settings section in Ultimate Multisite

API settings хуудсан бүр дэлгэрэнгүй үзүүлэлт:

API settings full page

Enable API (API-г идэвхжүүлэх) -ийг сонгоод таны API credentials-ийг авна уу.

Одоо бид endpoint-ийг үзэж, дараа нь Zapier-д бүртгэл хийх үйлдлийг үүсгэе.

Endpoint body parameters

Endpoint руу илгээх шаардлагатай хамгийн бага мэдээллийн талаар ерөнхийдөө харъя. Энэ нийтлэл дууссаны дараа бид бүрэн дохиог үзэх болно.

Customer

Энэ нь Хэрэглэгч болон Ultimate Multisite-ийн Хэрэглэгчийг үүсгэх үйл явцад шаардлагатай мэдээлэл юм:

"customer_id" : integer

Танай сүлжээнд үүсгэсэн хэрэглэгчийн ID-г илгээх боломжтой. Хэрэв илгээхгүй бол доорх мэдээллийг ашиглан шинэ хэрэглэгч болон шинэ WordPress хэрэглэгчийг үүсгэнэ. Хэрэглэгчийн ID-г мөн ижил аргаар илгээж болно.

"customer" : { "user_id" : integer "username" : "string", "password" : "string", "email" : "string", },

Гишүүнчлэл (Membership)

Бидэнд энэ объект дотор зөвхөн Гишүүнчлэлийн Статус хэрэгтэй.

"membership" { "status" : "string", // "pending", "active", "trialing", "expired", "on-hold", "canceled" - эдгээрээс аль нэгийг сонгоно }

Бараа (Products)

Бараануудад танай сүлжээний 1 ба түүнээс дээш бүтээгдэхүүний ID-ийн массив өгөгдөнө. Анхаарна уу, энэ endpoint нь бараа үүсгэхгүй. Бараа үүсгэх endpoint-ийг Ultimate Multisite-ын documentation-ыг үзээд илүү сайн ойлгоорой.

"products" : [1,2],

Төлбөр (Payment)

Гишүүнчлэлийн шиг бидэнд зөвхөн статус хэрэгтэй.

"payment" { "status" : "string", // "pending", "completed", "refunded", "partially-refunded", "partially-paid", "failed", "canceled" - эдгээрээс аль нэгийг сонгоно }

Вэбсайт (Site)

Мөн доторх Site объектод вэбсайтын URL болон Нэр (Title)-ийг дуусгахын тулд хэрэгтэй.

"site" : { "site_url" : "string", "site_title" : "string" }

Register endpoint-ээс буцаагдах үр дүн нь шинээр үүссэн гишүүнчлэлийн мэдээллийн массив байх болно.

Zapier-д үйлдлийг (action) үүсгэх

Шинэ бөгөөд илүү хүчирхэг бүртгэл хийх endpoint-ийн нэвтрэлтээр та Zapier-д шинэ action-ыг ашиглаж эхлэх боломжтой болно.

Zapier-ийн шинэ хувилбараар юу хийж, яаж ашиглах талаар мэдэх үү? Үүнийг энд уншиж үзээрэй. (link?)

Үйлдлийг үүсгэх

Zapier-тэй registration endpoint-и хэрхэн ашиглахыг илүү сайн ойлгоход зориулж, бид Google Forms-той integration хийе. Энэ формоор мэдээлэл оруулахаа бүртэл, тухайн мэдээллийг form-ын хариулын хуудас (answer sheet)-т хадгаснаар Ultimate Multisite сүлжээнд шинэ гишүүнээр нэвтрэх үйл явц хийгдэнэ.

Google Forms-д сүлжээнд шинэ гишүүн үүсгэхэд шаардлагатай хамгийн бага талбаруудтай form үүсгээрэй.

Одоо Zapier-д шинэ Zap үүсгээд, өгөгдөл хадгалагдаж буй spreadsheet-тэй Google-ийн form-ыг холбоорой.

Бүх зүйл дууссан! Google Forms form нь Zapier-тэй холбогдсон бөгөөд сүлжээнд integration хийхэд бэлэн боллоо. Одоо Google Forms бүртэй холбогдох үйлдэл (Action)-т шилжих хэрэгтэй, энэ нь Google Forms-ийн бүртэл мэдээлэл оруулахаа бүрт гүйцэтгэгддэг Trigger-ээс үүснэ.

Ultimate Multisite app-ыг олж сонгоорой. Энэ төрлийн Zap-д Register (Бүртгүүлэх) оптийг сонгоно.

Энэ анхны алхам хийсний дараа, энэ Zap-тай холбогдох хаягийг сонгоорой.

Энэ бол бүх процессын хамгийн чухал хэсэг юм. Бид Google Forms-аас ирсэн талбаруудыг энэ нийт зүйлийн өмнөх хэсэгт харагдсан register endpoint-ийн шаардлагатай хамгийн бага талбаруудтай нь тохируулах ёстой.

Энэ жишээнд бид зөвхөн username (хэрэглэгчийн нэр), email, password (нууц үг), name (нэр) болон website-ийн URL-ийг тохируулах хэрэгтэй. Үлдсэн бүх зүйл нь өмнөх нийтлэлд харагдсан шиг урьдчилан тогтоосон бөгөөд энэ Google Forms-аар үүсгэгдсэн бүх гишүүдийн хувьд ижил төстэй продукт болон статусын загварыг дагах болно.

Когда информация настроена, переходите к финальному тесту. На последнем экране вы увидите все поля, которые будут отправлены в конечную точку, их соответствующую информацию и поля, которые будут отправлены пустыми.

Протестируйте свой новый Zap, и он должен завершиться успешно. Если произойдет какая-либо ошибка, проверьте все поля и убедитесь, что они отправляются правильно. Поскольку информации много, некоторые вещи могут незаметить.

Полные параметры конечной точки

Вот полный вызов и все возможности полей, которые могут быть отправлены.

"customer_id" : integer, "customer" : { "user_id" : integer "username" : "string", "password" : "string", "email" : "string", }, "membership" : { "status" : "string", // одно из "pending", "active", "trialing", "expired", "on-hold", "cancelled" "date_expiration" : "string", "date_trial_end" : "string", "date_activated" : "string", "date_renewed" : "string", "date_cancellation" : "string", "date_payment_plan_completed": "string", }, "products" : [1,2], "duration" : "string", "duration_unit" : "string", "discount_code" : "string", "auto_renew" : "boolean", "country" : "string", "currency" : "string", "payment" { "status" : "string", // одно из "pending", "completed", "refunded", "partially-refunded", "partially-paid", "failed", "cancelled" }, "payment_method" : { "gateway" : "string", "gateway_customer_id" : "string", "gateway_subscription_id" : "string", "gateway_payment_id" : "string", }, "site" : { "site_url" : "string", "site_title" : "string", "publish" : "boolean", "template_id" : "string", }