Skip to main content

Overview

Implement quest systems that handle:
  • Quest validation and status checking
  • User eligibility verification through credential groups
  • Quest discovery and filtering
  • Loyalty points tracking

Basic Quest Operations

Get Quest Details

Response:

List Space Quests

Quest Status Reference

Quest Types

User Eligibility Verification

Check User Eligibility

Key Points:
  • When conditions.eligible is true, user meets requirements
  • When rewards.eligible is true, user can claim rewards
  • conditionRelation can be ALL (must meet all) or ANY (meet at least one)

Basic Implementation

Quest Validation

Check User Eligibility

Get Space Quests

Quest Status Helpers

Check Quest Phase

Usage Examples

Basic Quest Validation

User Eligibility Check

Quest Discovery

Complete Quest Check

Best Practices

  1. Status Validation: Always check quest status before showing participation UI
  2. Error Handling: Handle cases where quests are not found or access is denied
  3. Rate Limiting: Add delays when processing multiple quests or users
  4. Caching: Cache quest details for 1-5 minutes to reduce API calls
  5. Capacity Monitoring: Check both status and participant count vs cap

Quest Lifecycle

Common Integration Patterns

  • Quest Discovery: Filter by space, status, and type
  • Eligibility Pre-check: Verify user can participate before showing UI
  • Status Monitoring: Track quest lifecycle changes
  • Reward Tracking: Monitor available rewards and claim status
  • Points Calculation: Track potential loyalty points earnings

Next Steps