Overview

The Decentraland Referral Service API provides a comprehensive reward and campaign management system for the Decentraland ecosystem. This service enables users to create campaigns, manage rewards, assign tokens to users, and handle the complete lifecycle of referral-based incentives

Key Features

• Campaign Management: Create and manage reward campaigns with configurable parameters

• Reward System: Assign and distribute various types of rewards (NFTs, tokens) to users

• Blockchain Integration: Support for multiple blockchain networks (Ethereum, Polygon)

• Authentication: Secure user authentication and authorization

• Transaction Management: Handle reward claims and blockchain transactions

• Referral System: Track and manage user referrals and codes

Architecture

The service is built on a microservices architecture with the following main components:

• Campaigns: Core campaign management and configuration

• Rewards: Reward assignment, tracking, and distribution

• Transactions: Blockchain transaction handling and monitoring

• Users: User management and authentication

• Referrals: Referral tracking and code management

Authentication

Most endpoints require authentication using Decentraland's authentication system. Users must sign requests with their wallet to access protected resources.

Rate Limiting

The API implements rate limiting to ensure fair usage. Please refer to response headers for current rate limit information.

Error Handling

The API uses standard HTTP status codes and provides detailed error information in the response body when errors occur.