Special Occasion Posts
With Dragla's Special Occasion Posts API, you can create posts for all special dates such as national days, celebrations, or holidays in seconds for your application or users. This documentation will explain how to perform post creation tasks using the Special Occasion Posts feature step-by-step.
Getting Started
To use the API, you will need an API key. Visit (https://app.dragla.co/api) to obtain this key by registering on the platform. Once you have your API key, you can use it to authenticate your API requests.
Authorization: X-Api-Key: YOUR_API_KEY
Parameters
| Property | Data Type | Required | Description | Parameters |
|---|---|---|---|---|
| Title | String | Required | Specifies the title of your post. | Example: "Republic Day" |
| LogoUrl | String | Required | Used for the logo area in your post. | Example : "https://www.storagesite.com/logo.png" |
| Website | String | Required | Used for the website area in your post. | Example: "www.yoursite.com" or "@username" |
| Language | String | Required | Specifies the language of your post. | English, Turkish, Espanol, French, German, Italian, Japanese, Korean |
| PostSize | String | Required | Specifies the size of your post. | square, vertical, story |
| Keywords | String | Optional | Specifies the keywords for your post. | Example: "celebration", "holiday", "national day" |
| Audience | String | Optional | Defines the target audience for your post. | Example: "Citizens" |
| Tone | String | Optional | Specifies the tone of your post. | excited, professional, encouraging, dramatic, engaging, creative |
| ColorPalette | Object | Optional | Changes the color settings of your posts. If you want Dragla's AI to choose the colors for your posts, leave this field empty! |
ColorOne, ColorTwo, ColorThree, ColorFour fields are all mandatory and should be in Hex Code! (e.g., #ad8b73) |
| Images | Array | Optional | The field needed to separately add images in your posts. If you want Dragla's AI to choose the images for your posts, leave this field empty! |
Takes "Index" and "URL" values. The "Index" value indicates which post it is for. Example: "Index: 1" means you will change the images in the first post. |
Request [POST]
Note: The example below provides a complete request structure; you are not required to send fields outside the mandatory ones.
Successful Response
The turnaround time will be approximately 30 to 45 seconds. Please consider these processing times.
To retrieve the results, you need to make a "GET" request with the `creationId` as shown below.
Results [GET]
If the creation process is ongoing, you will receive a "Processing" response.
If the images have been created, you will receive a successful response as shown below.
Error Codes
| Code | Name | Description |
|---|---|---|
| 400 | Bad Request | Invalid Request Format: Check your request parameters. |
| 401 | Unauthorized | Unauthorized User: Verify your API key. |
| 404 | Not Found | No valid results found for the specified address. |
| 406 | Not Acceptable | Check your API key. |
| 500 | Server Error | Request could not be completed due to a server issue. |
