JustPinPoint API v1
Documentation on using the JustPinPoint.com API V1 (JSON API)
Overview
Version 1 of the JustPinPoint API is structured around REST, HTTP, and JSON. API endpoint URLs are organized around resources, such as lotto results or its features. It uses HTTP methods for indicating the action to take on a resource, and HTTP status codes for expressing error statuses. Resources are represented in JSON following a conventional schema.
Base URL
The API is accessed using a base URL that is specific to JustPinPoint account. In the examples provided in this documentation, we use the URL as a stand-in for real account API URL. In addition, URL paths should begin with api/v1 to specify version 1 of the API. Generally, the URL will be in the form:
https://www.justpinpoint.com/api/v1/#resource.
Authentication
All requests to the API are authenticated by providing your API key. The API key should be provided as an HTTP header named Authorization or as api_key query parameter.
Headers
Params
Authorization
api_key
vb564a67**********************
jb762862v*********************
HTTP Methods
The v1 API uses standard HTTP methods for indicating the action to take on a resource.
Method
Action
GET
Retrieve a resource
POST
Create a new resource
PUT
Update a resource
DELETE
Remove a resource
Schema
All API requests and response bodies adhere to a common JSON format representing individual items and collections of items.
Single Resources
Individual resources are represented by top level member named after the resource in the singular form. Below is a representation of a single contact. This could be used in the body of a PUT request and it’s what would be returned in the body of a GET request.
{ "numbers": [ 1, 16, 24, 28, 32, 37 ], "supplement": [ 35, 38 ], "type": "wed", "country": "Australia", "draw_date": "2022-05-25" }
Collections
Collections of resources are represented by a top level member named after the resource in the plural form. Below is a representation of a collection of contacts.
[{ "numbers": [ 1, 16, 24, 28, 32, 37 ], "supplement": [ 35, 38 ], "type": "wed", "country": "Australia", "draw_date": "2022-05-25" }, { "numbers": [ 4, 12, 19, 21, 24, 36 ], "supplement": [ 8, 37 ], "type": "mon", "country": "Australia", "draw_date": "2022-05-23" }]
Pagination
Endpoints that return collections of resources must limit the number of records returned in a given response. A typical endpoint will return 25 records by default, the query parameter limit can be used to alter the number of records returned.
{ "meta": { "current": 1, "limit": 15, "total_pages": 4, "total_count": 50 } }
Parameter
Description
Limit
The number of results to display in each page (default = 25, max = 1000 ).
Page
Current page with data.
Errors
The API uses HTTP status codes to indicate an error has occurred while processing a request. There are four main error status codes used by the API
Code
Description
401
Unauthorized. Similar to 403 Forbidden.
403
In case the API key is not provided
404
In case the requested data does not exist
422
The request could not be processed, usually due to a missing or invalid parameter
Sixdigit
URL
GET https://www.justpinpoint.com/api/v1/sixdigits/:id
BODY raw
{ "numbers": [ 1, 16, 24, 28, 32, 37 ], "supplement": [ 35, 38 ], "type": "wednesday", "country": "Australia", "draw_date": "2022-05-25" }
URL
GET https://www.justpinpoint.com/api/v1/sixdigits
BODY raw
[{ "numbers": [ 1, 16, 24, 28, 32, 37 ], "supplement": [ 35, 38 ], "type": "wednesday", "country": "Australia", "draw_date": "2022-05-25" }, { "numbers": [ 4, 12, 19, 21, 24, 36 ], "supplement": [ 8, 37 ], "type": "monday", "country": "Australia", "draw_date": "2022-05-23" }]
URL
GET https://www.justpinpoint.com/api/v1/sixdigits/lotto/monday
BODY raw
[{ "numbers": [ 4, 12, 19, 21, 24, 36 ], "supplement": [ 8, 37 ], "type": "monday", "country": "Australia", "draw_date": "2022-05-23" }, { "numbers": [ 6, 12, 17, 34, 35, 43 ], "supplement": [ 10, 25 ], "type": "wednesday", "country": "Australia", "draw_date": "2022-05-16"}]
URL
GET https://www.justpinpoint.com/api/v1/sixdigits/lotto/wednesday
BODY raw
[{ "numbers": [ 1, 16, 24, 28, 32, 37 ], "supplement": [ 35, 38 ], "type": "wednesday", "country": "Australia", "draw_date": "2022-05-25" }, { "numbers": [ 12, 14, 17, 19, 27, 30 ], "supplement": [ 28, 32 ], "type": "wednesday", "country": "Australia", "draw_date": "2022-05-18"}]
URL
GET https://www.justpinpoint.com/api/v1/sixdigits/lotto/saturday
BODY raw
[{ "numbers": [ 5, 9, 12, 30, 33, 39 ], "supplement": [ 7, 25 ], "type": "saturday", "country": "Australia", "draw_date": "2005-10-17" }, { "numbers": [ 15, 20 ,25, 27, 35, 39 ], "supplement": [ 9, 21 ], "type": "saturday", "country": "Australia", "draw_date": "2022-05-14"}]
Sevendigit
URL
GET https://www.justpinpoint.com/api/v1/sevendigits/:id
BODY raw
{ "numbers": [ 10, 13, 16, 19, 21, 25, 33 ], "type": "powerball", "powerball": 18, "country": "Australia", "draw_date": "2022-05-26" }
URL
GET https://www.justpinpoint.com/api/v1/sevendigits
BODY raw
[ { "numbers": [ 10, 13, 16, 19, 21, 25, 33 ], "type": "powerball", "powerball": 18, "country": "Australia", "draw_date": "2022-05-26" }, { "numbers": [ 5, 19, 29, 37, 45, 46, 47 ], "supplement": [ 40, 42, 43 ], "type": "oz", "country": "Australia", "draw_date": "2022-05-24" }]
URL
GET https://www.justpinpoint.com/api/v1/sevendigits/lotto/oz
BODY raw
[ { "numbers": [ 5, 19, 29, 37, 45, 46, 47 ], "supplement": [ 40, 42, 43 ], "type": "oz", "country": "Australia", "draw_date": "2022-05-24" }, { "numbers": [ 5, 8, 21, 30, 39, 44, 45 ], "supplement": [ 1, 25, 40 ], "type": "oz", "country": "Australia", "draw_date": "2022-05-17" }]
URL
GET https://www.justpinpoint.com/api/v1/sevendigits/lotto/powerball
BODY raw
[ { "numbers": [ 10, 13, 16, 19, 21, 25, 33 ], "type": "pow", "powerball": 18, "country": "Australia", "draw_date": "2022-05-26" }, { "numbers": [ 5, 8, 11, 15, 27, 28, 34 ], "type": "pow", "powerball": 3, "country": "Australia", "draw_date": "2022-05-19" }]
URL
GET https://www.justpinpoint.com/api/v1/sevendigits/lotto/set_for_life
BODY raw
[ { "numbers": [ 4, 13, 19, 31, 32, 34, 37 ], "supplement": [ 25, 41 ], "type": "Set For Life", "country": "Australia", "draw_date": "2022-09-05" }, { "numbers": [ 5, 11, 20, 21, 25, 27, 42 ], "supplement": [ 7, 43 ], "type": "Set For Life", "country": "Australia", "draw_date": "2022-09-04" }]
