సంక్షిప్తంగా: ఏజెన్సీ తన సొంత చట్టపరమైన పేరుతో ఒకసారి నమోదు చేసుకుని, ప్రతి క్లయింట్ పేరును సభ్యులకు కనిపించే పేరు ఫీల్డ్‌లో నమోదు చేయడం ద్వారా తన క్లయింట్‌ల కోసం ప్రకటనలు ఇస్తుంది. ఏజెన్సీయే చెల్లిస్తుంది, నిల్వలను కలిగి ఉంటుంది మరియు ఇన్‌వాయిస్‌లను అందుకుంటుంది. డెవలపర్‌లు ప్రకటనల పోర్టల్ నుండి పొందిన API కీలతో Agilis REST API (https://ads.agilis.dating) ద్వారా ఆఫర్‌లు మరియు కార్యక్రమాలను సృష్టించి, నిర్వహించవచ్చు; పరీక్ష కీలు ఉచితం, వాటితో చేసినవి సభ్యులకు ఎప్పుడూ కనిపించవు.
ఏజెన్సీల కోసం
- ఏజెన్సీ సొంత చట్టపరమైన పేరుతో ఏజెన్సీని నమోదు చేయండి. → ఎలా నమోదు చేసుకోవాలి
- ఆఫర్ లేదా కార్యక్రమాన్ని సృష్టించేటప్పుడు, సభ్యులకు కనిపించే పేరు ఫీల్డ్‌లో మీ సభ్యులకు కనిపించే పేరును నమోదు చేయండి. సభ్యులకు మీ పేరు కాకుండా క్లయింట్ పేరు కనిపిస్తుంది.
- ప్రతి క్లయింట్ తరఫున ప్రకటనలు ఇవ్వడానికి మీకు వారి అనుమతి ఉండాలి. ప్రకటనల నిబంధనల ప్రకారం దీనికి ఏజెన్సీయే బాధ్యత వహిస్తుంది.
ఎవరు చెల్లిస్తారు, ఇన్వాయిస్ ఎవరికి వస్తుంది
- మీ ఏజెన్సీ ఖాతా నుండే, మీ ఏజెన్సీ బిల్లింగ్ కరెన్సీలో చెల్లింపు జరుగుతుంది.
- మీ ఏజెన్సీలో ప్రతి వ్యక్తికి సొంత నిల్వ ఉంటుంది, దాని నుండే చెల్లిస్తారు. సంస్థ నిల్వ అంటే వాటన్నిటి మొత్తం. → నిల్వలు ఎలా పనిచేస్తాయి
- ఇన్వాయిస్లు మరియు ఫలితాలు మీ ఏజెన్సీ పేరు మీద ఉంటాయి, ప్రతి చెల్లింపుకు ఒక ఇన్వాయిస్; కాబట్టి మీరు ప్రతి క్లయింట్కు తిరిగి బిల్ చేయవచ్చు.
- ప్రతి క్లయింట్ ఖర్చును వేరుగా ఉంచడానికి, ఒక్కో క్లయింట్కు ఒక్కో ఆఫర్ లేదా కార్యక్రమాన్ని ఉపయోగించి, దాని ఇన్వాయిస్ ఆధారంగా తిరిగి బిల్ చేయండి.
బృంద పాత్రలు
సంస్థ నిర్వాహకులు మరియు ప్రకటనదారులు ప్రకటనల పోర్టల్‌లో పనిచేస్తారు; డెవలపర్‌లు API ద్వారా పనిచేస్తారు. డెవలపర్‌లు ప్రకటనల పోర్టల్‌లో ఆఫర్‌లు లేదా కార్యక్రమాలను సృష్టించలేరు, కానీ తమ API కీలతో API ద్వారా వాటిని సృష్టించి, ప్రచురించి, వాటికి చెల్లించగలరు; ఆ కీల వినియోగానికి మీ వ్యాపారమే బాధ్యత వహిస్తుంది. పూర్తి పట్టిక బృంద పాత్రలు మరియు అనుమతులు పేజీలో ఉంది.
Agilis REST API
- బేస్ URL: https://ads.agilis.dating
- సూచన పత్రం: www.agilis.dating/api-doc — cURL, Python, Node.js మరియు PHPలో ఉదాహరణలు, అలాగే API సహాయకంతో
- యంత్రాలు చదవగలిగే రూపంలో: www.agilis.dating/openapi.json వద్ద OpenAPI 3.1, www.agilis.dating/api-doc.md వద్ద Markdown, మరియు AI సాధనాల కోసం పూర్తి పాఠ్యం www.agilis.dating/llms-full.txt వద్ద
- ఆఫర్‌లు: మీ వర్గాలు మరియు ఆసక్తుల జాబితాను పొందండి; సృష్టించే ముందు ఆఫర్ ధరను అంచనా వేయండి; ఆఫర్‌లను సృష్టించండి, జాబితా చేయండి, నిలిపివేయండి, పునఃప్రారంభించండి మరియు తొలగించండి; ప్రతి ఆఫర్ ఫలితాలను చూడండి
- కార్యక్రమాలు: కార్యక్రమాలను ముందుగా చూడండి, ప్రచురించండి, జాబితా చేయండి, సవరించండి, తేదీ మార్చండి, రద్దు చేయండి మరియు తొలగించండి; ప్రతి కార్యక్రమ ఫలితాలను చూడండి
API కీని పొందండి
- సంస్థ నిర్వాహకులు లేదా డెవలపర్‌గా ప్రకటనల పోర్టల్‌కు సైన్ ఇన్ చేయండి.
- పేజీ పైభాగంలోని స్విచ్‌తో పరీక్ష మోడ్ లేదా లైవ్‌ను ఎంచుకోండి.
- API కీలు → కొత్త కీ సృష్టించండి కి వెళ్లి, కీకి ఒక పేరు ఇవ్వండి; కావాలంటే గడువు తేదీని కూడా ఇవ్వండి.
- కీని వెంటనే కాపీ చేసుకోండి. దాన్ని మీరు మళ్లీ చూడలేరు.
పరీక్ష కీలు pk_test_ తో మొదలవుతాయి; లైవ్ కీలు pk_live_ తో మొదలవుతాయి. ప్రతి వ్యక్తికి ఒక్కో మోడ్‌లో గరిష్ఠంగా 10 కీలు ఉండవచ్చు. భర్తీ చేయండి ఒక కీని వెంటనే భర్తీ చేస్తుంది, కాబట్టి ముందుగా మీ సిస్టమ్‌లను అప్‌డేట్ చేయండి. కీని x-api-key అభ్యర్థన హెడర్‌లో పంపండి: x-api-key: pk_test_….
సురక్షితంగా అభివృద్ధి చేయండి
pk_test_కీతో అభివృద్ధి చేసి పరీక్షించండి: పరీక్ష ఆఫర్‌లు మరియు కార్యక్రమాలు ఉచితం, అవి సభ్యులకు ఎప్పుడూ కనిపించవు.- ఆఫర్‌ను సృష్టించే ముందు price-estimate ఎండ్‌పాయింట్‌తో దాని ధరను అంచనా వేయండి.
- కీలను కోడ్ రిపాజిటరీలలో, బ్రౌజర్‌లలో ఉంచవద్దు; మీ సర్వర్ నుండే APIని కాల్ చేయండి.
ప్రశ్నలు
ఒక ఏజెన్సీ ఒకే ఖాతా నుండి అనేక క్లయింట్‌లను నిర్వహించగలదా?
అవును. ఏజెన్సీని ఒకసారి నమోదు చేసి, ప్రతి ఆఫర్ లేదా కార్యక్రమంలో క్లయింట్ పేరును ఇవ్వండి.
ప్రతి క్లయింట్కు వేరే ఇన్వాయిస్ ఉండవచ్చా?
ఇన్వాయిస్లు మీ ఏజెన్సీకే జారీ అవుతాయి, ప్రతి చెల్లింపుకు ఒకటి. వాటి ఆధారంగా మీ క్లయింట్లకు తిరిగి బిల్ చేయండి.
పరీక్షా వాతావరణం (శాండ్బాక్స్) ఉందా?
అవును. pk_test_ కీలతో పరీక్ష మోడ్ పూర్తి శాండ్బాక్స్గా పనిచేస్తుంది. ఎలాంటి ఛార్జీ ఉండదు, సభ్యులకు ఏదీ కనిపించదు.
AI కోడింగ్ సాధనాలను అనుసంధానించవచ్చా?
అవును. మీ సాధనానికి www.agilis.dating/api-doc.md లేదా www.agilis.dating/openapi.json చిరునామాను ఇవ్వండి.
