Construite directe in suggestu "Annual Ads" — creatis praecones, publicatis praeconia, excitatis solutiones, et vestigatis ordinem, omnino per API.
Vide totam tabulam pretiorum.Tu 70% retines. Quod praecones tui in modo Connexo pro praeconiis suis solvunt, sponte in crumenam tuam solvitur. Infra vide quomodo operetur.
Omnis petitio clavis secreta in capite auctoritatis comprobatur, adhibito schemate possessoris.
POST https://api.adhub365.com/v1/partner/ads
Authorization: Bearer sk_sandbox_...
Content-Type: application/jsonClaves API rationibus sociorum probatis a turma Anuntiationum Anniversariarum emittuntur.
Rationem socii crea| POST | /v1/partner/advertisersCrea rationem praecones pro uno ex utentibus tuis (modus Coniungendi). | advertisers:write |
| GET | /v1/partner/advertisers/{id}Quaere rationem praeconesis a hoc socio creatam. | advertisers:read |
| POST | /v1/partner/adsCreā praeconium. In statū prōiectī incipit. Campī optiōnāles 'advertiser_type', 'promotion_type', 'link_type', et 'promoted_brand' praeconium sociōrum, commendaticum, auctōrum, vel singulōrum dēfīniunt — vide nōtām infra. | ads:write |
| GET | /v1/partner/ads/{id}Quaere praeconium. | ads:read |
| PATCH | /v1/partner/ads/{id}Renova materiam editorialem — titulum, descriptionem, nexum, genus praeconesis, genus promotionis, genus nexus, et notam promotam. Categoria, geographia, et omnia quae a machina ordinandi leguntur hic numquam mutari possunt. | ads:write |
| POST | /v1/partner/ads/{id}/imageImaginem praeconii directe impone (JPEG/PNG/WebP, ad summum 5 MB). Requiritur ante primam solutionem — vide gregem solutionum infra. | ads:write |
| POST | /v1/partner/ads/{id}/image-urlImaginem praeconii ex URL constitue potius quam documentum imponere — servus ipse eam et petit et in hospitio ponit. Idem requisitum: ante primam solutionem necessarium. | ads:write |
| GET | /v1/partner/ads/{id}/rankOrdo, categoria, et ambitus geographicus praesens praeconii. | ads:read |
| GET | /v1/partner/ads/{id}/statsSumma conspectuum et pulsationum praeconii — dies elapsi/remanentes ex campis "activated_at" et "expires_at" iam in GET /{id} praebentur, et ordo ex GET /{id}/rank. | ads:read |
| POST | /v1/partner/paymentsIncipe solutionem cryptographicam pro emptione initiali aut pro supplemento. Solutio initialis cum errore 422 defert, nisi praeconium iam imaginem habet — vide uploadAdImage/setAdImageUrl supra. | payments:write |
| GET | /v1/partner/payments/{id}Statum solutionis comproba. | payments:read |
| POST | /v1/partner/referralsCrea nexum commendaticum. | referrals:write |
| GET | /v1/partner/referrals/{code}/earningsSumma quaestuum ex commendationibus cumulata, per statum distributa. | referrals:read |
| GET | /v1/partner/ad-revenue/earningsPars tua septuaginta centesimarum (70%) ex iis quae praecones, quos in modo Coniuncto creavisti, pro praeconiis suis solverunt, per statum distributa. | ad-revenue:read |
| GET | /v1/partner/access-logHistoria plena vocationum huius clavis — methodus, via, inscriptio IP, nota temporis. | Ibi |
| GET | /v1/rankings?category={id}&geo={scope}Ordo solum legendus pro categoria et ambitu geographico. | Publicum |
| GET | /v1/tiersSeptem gradus pretiorum configurati (limen, praemia reserata). | Publicum |
| GET | /v1/referral-programPercentus commissionum nunc vigentes pro catena commendationum et Piscina Ducum. | Publicum |
| GET | /v1/partner-programPartitio praesens redituum ex praeconiis (modo Coniuncto) inter te et Praeconia Annua. | Publicum |
| GET | /v1/search?q={query}Quaestio linguae naturalis — quaestionem, ut "mobilia praecones in Kenia," ad categoriam et ambitum geographicum congruentem dirigit, deinde illud ordinamentum eius ordine vero et exacto reddit. | Publicum |
Praeconium Socii et Commendaticum
advertiser_type, promotion_type, link_type, et promoted_brand sunt campi optionales in POST et PATCH /v1/partner/ads — "Praeconia Annua" non solum negotiis se praedicantibus limitantur. Cum link_type est affiliate_link aut referral_invitation_link, aut promotion_type est affiliate_offer aut referral_opportunity, affiliate_terms_accepted verum esse debet, alioquin petitio errore 422 reicitur. Titulus ad triginta quinque litteras et descriptio ad octoginta coartantur — ambo ex parte servientis, non solum in interfacie usoris tabulae, coguntur.
Cuique rationi praeclaritori tribuitur copia instrumentorum intellegentiae artificialis insitorum — generator rerum praeconialium et imaginum, adiutor colloquialis, consiliarius sumptuum, et auditor externus SEO — quae creditis IA solvuntur, praeter pretium annuum fixum.
| POST | /v1/advertisers/{id}/ai/assistantAsk Annual Ads — adiutor colloquialis mobilis, solum informativus, data rationis solum legens. | Publicum |
| POST | /v1/advertisers/{id}/ai/creative-studioCreā titulum, descriptiōnem, et verba clāvī ex brevī descriptiōne negōtiī. | 2 fidem(es) |
| POST | /v1/advertisers/{id}/ai/creative-studio/imageCreā imaginem indicem (PNG) ex eadem descriptione negotii, hospitata et parata ut adscribatur praeconio. | 8 fidem(es) |
| POST | /v1/advertisers/{id}/ai/budget-advisorVerum proiectum statisticum — numquam coniectura generativa — probabilitatis retinendi certum ordinem diebus XXX/XC/CCCXC. | 1 fidem(es) |
| POST | /v1/advertisers/{id}/ai/seo-auditExamina situm externum praeconis ipsius et suade emendationes SEO concretas. | 2 fidem(es) |
Idem genus et descriptio negotii etiam machinam imaginum infra positam alunt.
POST https://api.adhub365.com/v1/advertisers/{advertiser_id}/ai/creative-studio
Authorization: Bearer <session access token>
Content-Type: application/json
{
"category_name": "Furniture",
"business_description": "We sell handmade oak dining tables"
}{
"title": "Handmade Oak Dining Tables — Built to Last",
"description": "Solid oak dining tables crafted by hand, built to last a lifetime.",
"keywords": ["oak furniture", "dining table", "handmade"],
"credits_remaining": 8
}Genera imaginem congruentem eiusdem praeconii:
POST https://api.adhub365.com/v1/advertisers/{advertiser_id}/ai/creative-studio/image
Authorization: Bearer <session access token>
Content-Type: application/json
{
"category_name": "Furniture",
"business_description": "We sell handmade oak dining tables"
}{
"visual_url": "https://cdn.uploadscenter.com/file_01m1...",
"credits_remaining": 4
}Pone unitatem praeconialem paratam in situ tuo — sine ulla constructione, sine iframe. Scriptura recta in paginam intra Shadow DOM seiunctum redditur, itaque stili eius numquam in situm tuum effluunt, et stili situs tui numquam in eam.
<div
class="annualads-widget"
data-category="YOUR_CATEGORY_ID"
data-geo="global"
data-count="4"
data-columns="2"
></div>
<script async src="https://adhub365.com/widget.js"></script>Per defaltam, hoc monstrat ordinem publicum plenum categoriae — omnes praecones in suggestu, non solum eos quos tu addidisti. Ut solum praeconia a praeconibus per modum "Connect" creatis monstrentur (qui partem tuam generant), adiunge "data-partner" cum ID socii tui (id inveni in pagina "Developers" tabulae instrumentorum tuae):
<div
class="annualads-widget"
data-category="YOUR_CATEGORY_ID"
data-geo="global"
data-partner="YOUR_PARTNER_ID"
></div>
<script async src="https://adhub365.com/widget.js"></script>Si praecones tui per plures categorias patent, "data-category" omnino omitte — cum solo "data-partner", enim, modulus omnes praeconia tua per omnes categorias in una craticula monstrat, potius quam ut unum blocum moduli pro unaquaque categoria requiratur.
<div
class="annualads-widget"
data-geo="global"
data-partner="YOUR_PARTNER_ID"
></div>
<script async src="https://adhub365.com/widget.js"></script>Visne unitatem in margine inferiore iuxta primam tuam in corpore textus, utramque diversa praeconia monstrantem? Adde secundum blocum instrumentorum cum proprietate "data-layout="compact" (unum praeconium, in pilulam parvam contrahibile) et proprietate "data-offset" ad numerum praeconiorum quem primum instrumentum iam monstrat accommodatam:
<!-- in your content -->
<div
class="annualads-widget"
data-category="YOUR_CATEGORY_ID"
data-geo="global"
data-count="4"
data-columns="2"
></div>
<!-- in your footer, showing different ads via data-offset -->
<div
class="annualads-widget"
data-category="YOUR_CATEGORY_ID"
data-geo="global"
data-layout="compact"
data-offset="4"
></div>
<script async src="https://adhub365.com/widget.js"></script>data-category | ID categoriae ad ostendendum. Necessarium — nisi "data-partner" definitur; quo definito, id omittere praeconia illius socii per omnes categorias ostendit. |
data-geo | Geo ambitus: localis, regionalis, an globalis. Defaultim globalis est. |
data-count | Numerus praeconiorum monstrandorum. Defectu ad quattuor stat. |
data-columns | Numerus columnarum retis. Valor praedefinitus est 2. |
data-layout | reticulata, elenchi, aut compacta. Praedefinitum est reticulata. Modus compactus unum tantum praeconium monstrat (numerus datorum neglegitur) cum globulo ad id in parvam pilulam contrahendum et reducendum — unitas ad modum pedis paginae, quae a scripto ipso numquam fixa ponitur; tu ipse receptaculum 'div' quomodo velis in pagina tua collocas et ornatas. |
data-offset | Numerus praeconiorum praestantissimorum praetermittendorum. Valor praedefinitus est 0. Permittit alteri instrumento in eadem pagina (e.g. compacto in pede paginae et reticulato alio loco superiore) praeconia diversa monstrare potius quam idem bis iterare — traditur numerus praeconiorum quae alterum instrumentum iam monstrat. |
data-partner | ID socii tui (inveni in pagina "Programmatores" tabulae instrumentorum tuae). Ad libitum — sine eo, modulus indicem publicum plenum illius categoriae ostendit, omnes praecones in suggestu. Cum eo, solum praeconia praeconum quos per modum "Connect" adduxisti — eorum qui re vera partem tuam generant. |
Petitiones per clavem per minutum limitantur. Omnis responsum authenticatum titulos X-RateLimit-Limit, X-RateLimit-Remaining, et X-RateLimit-Reset fert; si limitem exceditur, codex 429 "Nimis Multae Petitiones" cum titulo "Retry-After" redditur.
Ad libitum per socium. Donec inscriptionem addas, claves tuae petitiones ab omni inscriptione IP accipiunt; prima inscriptio omnes claves illius socii ad modum "tantum in indice permissorum" mutat.
Quisque webhook cum HMAC-SHA256 subscribitur, utendo secreto semel edito tempore creationis — subscriptio verificanda est antequam onus fidatur. Eventus solum socio traduntur qui praeconem cognatum possidet.
payment.succeeded | Pecunia soluta est. |
payment.refunded | Remissio pecuniae fit. |
ad.activated | Praeconium activum fit, sive automatice sive post moderationem administratoris. |
invoice.issued | Syngrapha editur. |
referral.payout.completed | Commissio commendaticia statum solutum attingit. |
referral.payout.failed | Series solutionum commendaticarum apud praebitorem deficit — quaestus ad solvendum redeunt et iterum conantur. |
rank.changed | Ordo praeconii mutatur, etiam cum solutio alterius praeconatoris id efficit. |
ad.expiring_soon | Triginta, septem, aut uno die antequam praeconium exspiraverit. |
partner_ad_revenue.payout.completed | Sortitio reditus ex praeconiis statum solutae attingit. |
partner_ad_revenue.payout.failed | Series solutionum partitionis redituum praeconiariorum apud praebitorem deficit — partes ad solvendum redeunt et denuo conantur. |
SDK officialia JavaScript/TypeScript et Python, ex eadem hac API specificatione generata, parantur sed nondum eduntur — interim API HTTP directe invoca.
Nondum SDK — hi API HTTP directe invocant et hodie in quolibet lingua operantur.
cURL
curl -X POST https://api.adhub365.com/v1/partner/ads \
-H "Authorization: Bearer sk_sandbox_..." \
-H "Content-Type: application/json" \
-d '{"advertiser_id":"adv_9f2a...","category_id":"cat_furniture","geo_scope":"local","title":"..."}'JavaScript
await fetch("https://api.adhub365.com/v1/partner/ads", {
method: "POST",
headers: {
Authorization: "Bearer sk_sandbox_...",
"Content-Type": "application/json",
},
body: JSON.stringify({
advertiser_id: "adv_9f2a...",
category_id: "cat_furniture",
geo_scope: "local",
title: "...",
}),
});Python
import requests
requests.post(
"https://api.adhub365.com/v1/partner/ads",
headers={"Authorization": "Bearer sk_sandbox_..."},
json={
"advertiser_id": "adv_9f2a...",
"category_id": "cat_furniture",
"geo_scope": "local",
"title": "...",
},
)