Giftoin Docs
  • 👋INTRODUCTION
    • Welcome to Giftoin
    • Overview
    • Quick Start
    • FAQs
    • Key Features
  • 🧩API REFERENCE
    • Standards and Conventions
    • Orders API
      • Tokens/Points
      • Collectibles/Cards
      • Collectibles/Random Cards
    • Users API
      • Inventory
      • Progress
    • Error Handling
  • 💻PLATFORM GUIDES
    • Roblox
      • Why use Giftoin?
      • Basic Usage
      • Developer Access
      • Installation
      • Additional Example / Use-Cases
        • Point Reward
        • Daily Reward
        • Advanced Point Distribution System
        • Managed Codes & In-Game Rewards (Coming Soon)
          • Registering Reward Types
      • Tools and Scripts
        • Rotating Script
        • Floating Script
        • Quest System (Coming Soon)
    • Discord
      • Introduction
      • Getting Started
      • Command Reference
      • Role System
      • User Guides
      • Troubleshooting
      • FAQs
    • Wordpress
  • 📚Resources
    • Use Cases
      • Basic
      • eCommerce
      • Games
    • Support
Powered by GitBook
On this page

Was this helpful?

  1. INTRODUCTION

Quick Start

PreviousOverviewNextFAQs

Last updated 2 months ago

Was this helpful?

Acquiring an API Key

Your API requests are authenticated using API keys. Any request that doesn't include an API key will return an error.

You can can access your API key directly from your management dashboard:

  1. Login to the management dashboard with your account

  2. Using the left side navigation panel click on Settings -> Account

  3. Here you can reveal your API key or easily copy it.

Important to know: Currently you can have only one API key. Make sure to save it in a secure location and do not share it. Also make sure to use it only on secured environments like your backend and absolutely not your front end.

Using Your API Key

You may use any server-side programming language that can make HTTPS requests to target the Giftoin API. All requests should target the URL: https://api.giftoin.org/api/v1

You need to supply your API Key in REST API calls in the header with a custom header: x-gft_api_key

Make your first request

To make your first request, send an authenticated request to the campaigns endpoint. This will return you an array of existing campaigns, if you have none it will return an empty array.

Don't forget: You must include your API key with every API call, otherwise you will receive an error.

👋

Get all campaigns

get
Authorizations
Responses
200
success response
application/json
get
GET /api/v1/gcm/reseller/campaign HTTP/1.1
Host: api.giftoin.org
x-gft_api_key: YOUR_API_KEY
Accept: */*
200

success response

{
  "data": {
    "campaignsData": [
      {
        "id": "APlTWgfNOmoTZHR61L4C",
        "name": "March Campaign",
        "description": "Dedicated campaign to be used only in March",
        "type": "Coupon",
        "productSKU": "C4JxBVOSisgoU45eydRb",
        "networkType": "Main Net"
      }
    ]
  }
}
  • Acquiring an API Key
  • Using Your API Key
  • Make your first request
  • GETGet all campaigns