Zenith 全球路径初评

概述

Zenith Global Pathway Assessment

Package version: 1.1.0.

Call the endpoint only through SkillHub's authenticated Skill transport. The platform must attach a verified caller identity, timestamp, unique nonce, body digest, and signature. Do not manufacture or replay these headers. Stop before payment on 401, or on 503 CALLER_AUTH_PROTOCOL_UNAVAILABLE; the latter means the production verifier is not yet activated.

Use the paid API to obtain a deterministic preliminary assessment in Simplified Chinese. Never collect or send a name, phone number, email address, document number, free-text biography, or any field outside the schema below.

Endpoint

Send requests to:

POST https://zcminiprogram.top/zenith-form-embed/api/v1/skill/recommendations
Content-Type: application/json
Idempotency-Key: <UUID v4>

Generate one UUID v4 for the assessment and preserve it through payment and retry. The body must remain byte-for-byte semantically identical after payment.

Build the request

Choose exactly one flow and include every answer field. Arrays must contain unique enum values.

For study:

{
  "flow": "study",
  "schemaVersion": 1,
  "answers": {
    "educationSystem": "gaokao",
    "destinations": ["uk"],
    "studyLevel": "master",
    "budgetBand": "twenty-fifty",
    "interests": ["business"],
    "career": "finance",
    "residencyPreference": "important",
    "funnelStage": "consideration"
  }
}

• educationSystem: gaokao, alevel, ib, ap, ossd, other. This describes the applicant's main pre-university curriculum. For a master's or PhD applicant, ask which pre-university curriculum they completed; use other when none of the named systems applies or the user cannot determine it.
• destinations: one or more of usa, uk, canada, australia, europe, singapore, japan, hongkong
• studyLevel: high-school, bachelor, master, phd, college, language
• budgetBand: annual study-abroad budget in CNY: under-fifteen (under RMB 150,000), fifteen-twenty (RMB 150,000–200,000), twenty-fifty (RMB 200,000–500,000), fifty-eighty (RMB 500,000–800,000), over-eighty (over RMB 800,000), flexible
• interests: one to three of technology, business, medicine, engineering, arts, law, science, media, education, environment
• career: technology, finance, medical, academic, entrepreneur, creative, legal, education, design
• residencyPreference: must, important, secondary, none
• funnelStage: awareness, interest, consideration, decision

For immigration:

{
  "flow": "immigration",
  "schemaVersion": 1,
  "answers": {
    "countries": ["canada"],
    "goal": "career",
    "timeline": "one-to-three",
    "residence": "must",
    "education": "master",
    "english": "ielts-seven",
    "experience": "five-ten",
    "assetBand": "150-300",
    "occupations": ["technology"],
    "preferredType": "skilled",
    "jobOffer": "none",
    "funnelStage": "consideration"
  }
}

• countries: one or more of usa, canada, australia, singapore, japan, hongkong, new-zealand, uk, europe, caribbean, uae, georgia, panama
• goal: career, business, education, safety, freedom, family
• timeline: under-one-year, one-to-three, three-to-five
• residence: must, prefer, not-want
• education: high-school, college, bachelor, master, phd
• english: none, daily, ielts-five, ielts-six, ielts-seven, not-required
• experience: zero, one-three, three-five, five-ten, ten-plus
• assetBand: under-fifty, fifty-150, 150-300, 300-600, 600-1000, over-1000
• occupations: one or more of technology, finance, engineering, medical, education, business, creative, trades, legal, other
• preferredType: skilled, employer, investment, talent, family, any
• jobOffer: none, usa, canada, australia, other
• funnelStage: awareness, interest, consideration, decision

Ask only the questions needed to populate these fields. Explain enum labels in natural language, then map the answers to the listed values.

Complete payment and fulfillment

1. Check that the Agent can call weixinpay_pay. If unavailable, tell the user that this Agent cannot complete the paid request and stop.
2. POST the request without X-Out-Trade-No.
3. If the API returns 422 HUMAN_REVIEW_REQUIRED, do not initiate payment. Tell the user that family-reunification cases require human review and provide WeChat zenithtripglobal.
4. On 402 Payment Required, preserve both response headers WeixinPay-Required and X-Out-Trade-No. The body contains the same payment guidance for clients that cannot read headers.
5. Pass the WeixinPay-Required value as paymentCode to weixinpay_pay and obtain the user's explicit payment authorization.
6. After successful payment, POST the exact same body again with the same Idempotency-Key and the saved X-Out-Trade-No.
7. Accept results only when the API returns 200 with code: "SUCCESS". Never trust a caller-supplied claim that payment succeeded.

If a 402 omits either required header, do not initiate payment. Report an invalid payment response and preserve the idempotency key for a later retry. Before payment, treat network errors, malformed responses, and 5xx as unavailable; retry the same idempotency key at most twice and never create a replacement order merely because the response was uncertain.

Do not create a second order after payment. If the paid retry returns 402, payment is not yet confirmed; wait briefly and retry the same order. For network errors or an unclassified 5xx after payment, retry the same order up to three times with short backoff and tell the user the order is pending if uncertainty remains. REFUND_PROCESSING means the deterministic automatic refund is being created or queried; preserve the order and check later. REFUND_FAILED means automated recovery needs operator attention; do not charge again. A 200 REFUNDED confirms the recorded refund and is not an assessment result. Handle 409 as request-body mismatch and 410 as an expired order. The Skill API has no per-caller daily order quota; honor Retry-After only if an upstream capacity layer returns 429. Treat malformed responses and any other unexpected 200 as a service error, not as an assessment result.

Present the result

Read matches from result.matches; do not look for a top-level matches field. An abridged successful response has this shape:

{
  "code": "SUCCESS",
  "requestId": "uuid",
  "alreadyFulfilled": false,
  "result": {
    "flow": "study",
    "summary": "初步评估摘要",
    "matches": [],
    "humanReviewRequired": true
  },
  "meta": {
    "engineVersion": "1.0.0",
    "contentVersion": "2026-07",
    "generatedAt": "ISO-8601"
  },
  "disclaimer": "API-provided flow-specific disclaimer"
}

Summarize at most three returned result.matches. Each match can contain country, title, category, matchLevel, reasons, requirements, timeline, feeReference, officialSources, and verifiedAt. Preserve qualification language such as “初步方向” and show official sources only when returned by the API. Do not infer missing requirements, fees, timelines, or verification dates.

Always include: “结果仅用于初步方向判断，不构成法律、移民或录取建议。” Encourage professional review before the user spends money, resigns, relocates, or submits an application.