WHERE TO START

Juengo uses a RESTful web API with JSON responses. In order to be able and use the API, you must be registered to Juengo for Communities. Sign up is completely free. You only pay for the amount of juengos you will be giving out to your users/clients. Http variables are mostly send using POST. Each web service has it’s own documentation and explanation whether POST or GET is used. The base URI for Juengo web API is: http://developers.juengo.com/api/stable/ (latest stable version)

WHAT YOU WILL NEED

To start using Juengo API you need to generate an API Key and an APP Secret. These can be obtained from within the Juengo for Communities platform (my.juengo.com) under the Apps section. Once you have obtained your API Key and APP Secret you will be able to start using the API. Please note that both key and secret are required post variables to any http call. We also provide a console that will help you test the web services (read only services) and provide you with a visual representation of the JSON output (lint-like). You can access the console here (or from the option CONSOLE from the top menu).

PAY ATTENTION

If you are registered to a local Juengo platform (i.e. Greece) then you must make all HTTP calls to that country’s specific domain. Therefore if you are registered to www.juengo.gr then you must make the HTTP calls to developers.juengo.gr (mind the suffix). If your app’s scope within Juengo is read only, you will not be able to create rewarding transactions.

Last 7 days, UTC

Average Latency
388ms

Average Uptime
100.0%

Current Status
Online

  • No information
  • Outage
  • Disruption
  • Normal
Average latency determined from Mashape to API Response time
Query Authentication
 

Generate a new app in http://my.juengo.com


Authentication
Description
Parameter
String

Your app’s API key

apikey

Required

String

Your app’s secret

secret

Required

Offers & Merchants

HTTP 200 : Merchant POST/api/stable/merchant/
						[{
    "response": {
        "name": "Merchant name",
        "address": "0 Nowhere Av.",
        "zip": "0000",
        "town": "Neverland",
        "phone": "000 0000 000",
        "url": "http://www.merchantdomain.com/",
        "lat": "0",
        "lng": "0",
        "logo": "http://cp.juengo.com/_thumbs/thumbnail_image.jpg",
        "total_offers": 2,
        "offers": [
            {
                "offer_id": "0123456789abcdefghijklmnopqrstuv",
                "title": "Offer title",
                "description": "Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.",
                "quantity": "100",
                "timestamp_from": "2013-09-01 15:10:00",
                "timestamp_to": "2099-09-30 00:00:00",
                "juengos": "50",
                "delivery_option": "yes",
                "image_url": "http://cp.juengo.com/_offers/thumbnail_offer.jpg"
            },
            [...]
        ]
    }
}]						
Merchant

Retrieve merchant information and active offers from Juengo Market


Test console
Description
Parameter
string

The unique Juengo ID for a specific merchant

merchant_id

Required

HTTP 200 : Offers Model POST/api/stable/offers/
						{
    "response": [
        {
            "offer_id": "0123456789abcdefghijklmnopqrstuv",
            "merchant": "Merchant Name",
            "title": "Offer Title",
            "description": "Offer full text description",
            "quantity": "10",
            "timestamp_from": "2013-09-01 00:00:00",
            "timestamp_to": "2014-09-01 00:00:00",
            "juengos": "50",
            "delivery_option": "no",
            "image_url": "http://cp.juengo.com/_offers/thumbnail_title.jpg"
        },
        [...]
    ]
}						
Offers

Get all active offers from Juengo Market


Test console
Description
Parameter
string

A numeric limit (1 to 100000) for returned results

limit

Optional

Profile

HTTP 200 : Profile POST/api/stable/profile/
To fetch your Juengo profile, make an HTTP call to http://developers.juengo.com/api/stable/profile/
						[{
  "response": [
    {
      "id": "your@email.com",
      "name": "Your profile name",
      "url": "www.yourdomain.com",
      "juengos": "0"
    }
  ]
}]						
Profile

Get your profile informaiton


Rewarding

HTTP 200 : New Reward Model POST/api/stable/reward/
						{
  "response": {
    "status": "1",
    "msg": "The rewarding transaction was successfully completed!"
  }
}						
New Reward

The essence of Juengo: a new reward with juengos! Please note that this service won't work unless you have a READ/WRITE scope in your generated app.


Test console
Description
Parameter
string

The number of juengos to reward per user. If you are rewarding 2 users with the same HTTP post and each user gets 1 juengo, then your juengos parameter should be 1

juengos

Required

string

A string array containg the emails of the users to be rewarded. If the user is only one, you can send the user email as a string instead of a string array

users

Required

string

A string containing the description of the action to be rewarded. This will provide an in-depth analysis when viewing the analytics in the Juengo for Communities platform.

action

Required

Transactions

HTTP 200 : Transactions POST/api/stable/transactions/
						{
    "response": [
        {
            "user_mail": "some@user.com",
            "juengos": "1",
            "status": "complete",
            "type": "reward",
            "timestamp": "2013-10-01 01:40:51"
        },
        {
            "user_mail": "support@juengo.com",
            "juengos": "100",
            "status": "complete",
            "type": "purchase",
            "timestamp": "2013-09-28 01:00:00"
        },
        [...]
    ]
}						
All Transactions

Fetch all transactions, both incoming and outgoing, of purchasing juengos or giving out juengos


Test console
Description
Parameter
string

A numeric limit (1 to 100000) for returned results

limit

Optional

HTTP 200 : Incoming Transactions POST/api/stable/transactions/in/
						{
    "response": [
        {
            "user_mail": "support@juengo.com",
            "juengos": "200",
            "status": "complete",
            "type": "purchase",
            "timestamp": "2013-09-28 01:00:00"
        },
        {
            "user_mail": "support@juengo.com",
            "juengos": "100",
            "status": "complete",
            "type": "purchase",
            "timestamp": "2013-09-28 00:00:00"
        },
        [...]
    ]
}						
Incoming Transactions

Fetch all incoming transactions (juengos you purchased from the System)


Test console
Description
Parameter
string

A numeric limit (1 to 100000) for returned results

limit

Optional

HTTP 200 : Outgoing Transactions Model POST/api/stable/transactions/out/
						{
    "response": [
        {
            "user_mail": "some@user.com",
            "juengos": "1",
            "status": "complete",
            "type": "reward",
            "timestamp": "2013-10-01 01:40:51"
        },
        {
            "user_mail": "another@user.com",
            "juengos": "1",
            "status": "complete",
            "type": "reward",
            "timestamp": "2013-10-01 01:37:25"
        },
        [...]
    ]
}						
Outgoing Transactions

Fetch all outgoing transactions (juengos given out by you to users)


Test console
Description
Parameter
string

A numeric limit (1 to 100000) for returned results

limit

Optional

string

The status of the transaction (valid values are complete, pending)

status

Optional

Consume this API completely for free!


By joining the mashape API marketplace you can start using Juengo API today!

Login to your account or signup: Create Account

or
   Signup with GitHub

By signing up you agree to our terms of service.