Developer resources
Endpoint:
GET https://scripttonic.com/api/account/details
Description: Retrieves details of the account associated with the provided API key.
Endpoint:
GET https://scripttonic.com/api/items/all
Description: Retrieves all items associated with the provided API key.
Endpoint:
GET https://scripttonic.com/api/items/item
Description: Retrieves details of a specific item based on the provided item ID and API key.
Endpoint:
POST https://scripttonic.com/api/purchases/validation
Description: Validate a purchase code and returns details about the purchase if valid.
The user should first log in to their account on the platform. Then, they can navigate to the "Settings" section of their workspace.
Within the workspace settings, the user should look for a section specifically labeled "API Key" or "API Access."
In this section, the user can either generate a new API key or retrieve an existing one if it has been previously generated. If there is an option to generate a new key, the user can click on it to create a fresh API key.
Once the API key is generated or retrieved, the user should be able to see it displayed on the screen. They can simply click on a button or icon next to the key to copy it to their clipboard.
With the API key copied, the user can now use it to authenticate their requests when accessing the platform API endpoints. They typically need to include the API key as part of the request headers or parameters, depending on the API authentication mechanism.
Its essential to remind users to keep their API keys secure and not share them publicly. They should avoid hardcoding API keys in client-side code or sharing them in publicly accessible repositories. Instead, they should consider storing the API key securely on their server-side applications and using appropriate access controls.
Use the Authorization header; never put secrets in URLs. Legacy api_key parameters remain supported for existing clients. Authorization: Bearer st_live_xxxxxxxxx
Retrieves details of the account associated with the provided API key
GET https://scripttonic.com/api/account/details
(Legacy alternative to the Authorization header)
Success Response:
{
"status": "success",
"data": {
"name": {
"firstname": "John",
"lastname": "Doe",
"full_name": "John Doe"
},
"username": "johndoe",
"email": "john.doe@example.com",
"balance": 100.00,
"currency": "USD",
"profile": {
"heading": "Profile Heading",
"description": "Profile Description",
"contact": {
"email": "contact@example.com"
},
"social_links": [
"facebook": "/",
"x": "/",
// etc...
],
"media": {
"avatar": "https://example.com/avatar.jpg",
"cover": "https://example.com/cover.jpg"
}
},
"registered_at": "2024-04-27T12:00:00Z"
}
}
Error Response:
{
"status": "error",
"msg": "Invalid request"
}
Use the Authorization header; never put secrets in URLs. Legacy api_key parameters remain supported for existing clients. Authorization: Bearer st_live_xxxxxxxxx
Retrieves all items associated with the provided API key
GET https://scripttonic.com/api/items/all
(Legacy alternative to the Authorization header)
Success Response:
{
"status": "success",
"items": [
{
"id": 1,
"name": "Sample Item",
"description": "This is a sample item",
"category": "Category Name",
"sub_category": "Subcategory Name",
"options": ["option1", "option2"],
"version": 1.0.0,
"demo_link": "https://example.com/demo",
"tags": ["tag1", "tag2"],
"media": {
"thumbnail": "https://example.com/thumbnail.png",
"preview_image": "https://example.com/preview.jpg", // This is not included for audio items
"preview_video": "https://example.com/video.mp4", // This is only included for video items
"preview_audio": "https://example.com/audio.mp3", // This is only included for audio items
"screenshots": [ // This is only included if item has screenshots
"https://example.com/screenshot1.jpg",
"https://example.com/screenshot2.jpg"
],
},
"price": {
"regular": 19.99,
"extended": 29.99
},
"currency": "USD",
"published_at": "2024-04-27T12:00:00Z"
},
{
// Next item...
}
]
}
Error Response:
{
"status": "error",
"msg": "No items found"
}
Use the Authorization header; never put secrets in URLs. Legacy api_key parameters remain supported for existing clients. Authorization: Bearer st_live_xxxxxxxxx
Retrieves details of a specific item based on the provided item ID and API key.
GET https://scripttonic.com/api/items/item
(Legacy alternative to the Authorization header)
(Required)
Success Response:
{
"status": "success",
"item": {
"id": 1,
"name": "Sample Item",
"description": "This is a sample item",
"category": "Category Name",
"sub_category": "Subcategory Name",
"options": ["option1", "option2"],
"version": 1.0.0,
"demo_link": "https://example.com/demo",
"tags": ["tag1", "tag2"],
"media": {
"thumbnail": "https://example.com/thumbnail.png",
"preview_image": "https://example.com/preview.jpg", // This is not included for audio items
"preview_video": "https://example.com/video.mp4", // This is only included for video items
"preview_audio": "https://example.com/audio.mp3", // This is only included for audio items
"screenshots": [ // This is only included if item has screenshots
"https://example.com/screenshot1.jpg",
"https://example.com/screenshot2.jpg"
],
},
"price": {
"regular": 19.99,
"extended": 29.99
},
"currency": "USD",
"published_at": "2024-04-27T12:00:00Z"
}
}
Error Response:
{
"status": "error",
"msg": "Item Not Found"
}
Use the Authorization header; never put secrets in URLs. Legacy api_key parameters remain supported for existing clients. Authorization: Bearer st_live_xxxxxxxxx
Validate a purchase code and returns details about the purchase if valid.
POST https://scripttonic.com/api/purchases/validation
(Legacy alternative to the Authorization header).
(Required).
Success Response:
{
"status": "success",
"data": {
"purchase": {
"purchase_code": "abcdefghijklmnopqrstuvwxyz123456789",
"license_type": "Regular",
"price": 19.99,
"currency": "USD",
"item": {
"id": 1,
"name": "Sample Item",
"description": "This is a sample item",
"category": "Category Name",
"sub_category": "Subcategory Name",
"options": ["option1", "option2"],
"version": 1.0.0,
"demo_link": "https://example.com/demo",
"tags": ["tag1", "tag2"],
"media": {
"thumbnail": "https://example.com/thumbnail.png",
"preview_image": "https://example.com/preview.jpg", // This is not included for audio items
"preview_video": "https://example.com/video.mp4", // This is only included for video items
"preview_audio": "https://example.com/audio.mp3", // This is only included for audio items
"screenshots": [ This is only included if item has screenshots
"https://example.com/screenshot1.jpg",
"https://example.com/screenshot2.jpg"
],
},
"price": {
"regular": 19.99,
"extended": 29.99
},
"currency": "USD",
"published_at": "2024-04-27T12:00:00Z"
},
"supported_until": "2024-04-27T12:00:00Z", // This will not exist if support is disabled or its not supported
"downloaded": false,
"date": "2024-04-27T12:00:00Z"
}
}
}
Error Response:
{
"status": "error",
"msg": "Invalid purchase code"
}