Get started

    API Endpoint

        https://api.westeros.com/
                

server.aibentopup.com API is a RESTful API that allows you to make data & airtime topup, cable subsription, electricity bills payment, recharge card printing, etc.

To use this API, you need an API key. Please contact us at jon.snow@nightswatch.wes to get your own API key.

Data Topup

Fetch Data Plans

To get our available data plans you need to make a GET call to the below url:
https://server.aibentopup.com/api/data/topup

                # Here is a curl example
                curl -X GET http://localhost:8000/api/data/plans -H "Authorization: Bearer 12345"
                    

Result example :

{
  query:{
    offset: 0,
    limit: 50,
    house: [
      "Stark",
      "Bolton"
    ],
  }
  result: [
    {
      id: 1,
      first_name: "Jon",
      last_name: "Snow",
      alive: true,
      house: "Stark",
      gender: "m",
      age: 14,
      location: "Winterfell"
    },
    {
      id: 2,
      first_name: "Eddard",
      last_name: "Stark",
      alive: false,
      house: "Stark",
      gender: "m",
      age: 35,
      location: 'Winterfell'
    },
    {
      id: 3,
      first_name: "Catelyn",
      last_name: "Stark",
      alive: false,
      house: "Stark",
      gender: "f",
      age: 33,
      location: "Winterfell"
    },
    {
      id: 4,
      first_name: "Roose",
      last_name: "Bolton",
      alive: false,
      house: "Bolton",
      gender: "m",
      age: 40,
      location: "Dreadfort"
    },
    {
      id: 5,
      first_name: "Ramsay",
      last_name: "Snow",
      alive: false,
      house: "Bolton",
      gender: "m",
      age: 15,
      location: "Dreadfort"
    },
  ]
}
                

QUERY PARAMETERS

Field	Type	Description
secret_key	String	Your API key.
search	String	(optional) A search word to find character by name.
house	String	(optional) a string array of houses:
alive	Boolean	(optional) a boolean to filter alived characters
gender	String	(optional) a string to filter character by gender: m: male f: female
offset	Integer	(optional - default: 0) A cursor for use in pagination. Pagination starts offset the specified offset.
limit	Integer	(optional - default: 10) A limit on the number of objects to be returned, between 1 and 100.

Errors

The Westeros API uses the following error codes:

Error Code	Meaning
X000	Some parameters are missing. This error appears when you don't pass every mandatory parameters.
X001	Unknown or unvalid secret_key. This error appears if you use an unknow API key or if your API key expired.
X002	Unvalid secret_key for this domain. This error appears if you use an API key non specified for your domain. Developper or Universal API keys doesn't have domain checker.
X003	Unknown or unvalid user token. This error appears if you use an unknow user token or if the user token expired.