పంపినవారి గుర్తింపులు
ఇమెయిల్ ఖాతాలోని పంపినవారి గుర్తింపుల్లో ఒకదాని నుంచి పంపబడుతుంది: ఖాతాకు చెందిన డొమైన్ లేదా చిరునామా. Oblic ధృవీకరించిన గుర్తింపు నుంచి మాత్రమే పంపుతుంది. గుర్తింపులను జోడించడానికి, తొలగించడానికి కీలో identities:manage అవసరం; జాబితా చూడటానికి identities:manage లేదా email:send అవసరం.
గుర్తింపును జోడించడం
- పేరు
identityType- టైప్ చేయండి
- string
- వివరణ
అవసరం:
DomainలేదాEmail, పెద్ద, చిన్న అక్షరాలను ఇదే విధంగా ఉపయోగించండి.
- పేరు
identity- టైప్ చేయండి
- string
- వివరణ
అవసరం:
example.comవంటి డొమైన్ లేదాorders@example.comవంటి చిరునామా, గరిష్ఠంగా 255 అక్షరాలు.
- పేరు
email- టైప్ చేయండి
- string
- వివరణ
Domainకోసం అవసరం: గుర్తింపు పంపినవారిగా ఉపయోగించే అదే డొమైన్లోని చిరునామా.
- పేరు
displayName- టైప్ చేయండి
- string
- వివరణ
అవసరం: పంపినవారి పేరు, గరిష్ఠంగా 255 అక్షరాలు;
<,>,"లేదా పంక్తి విరామం ఉండకూడదు.
- పేరు
replyTo- టైప్ చేయండి
- string
- వివరణ
ప్రత్యుత్తరాలు పంపే చిరునామా.
డొమైన్ను జోడించడం
curl -X POST https://api.oblic.app/external/v1/identities \
-H 'Authorization: Bearer YOUR_API_KEY' \
-H 'Content-Type: application/json' \
-d '{
"identityType": "Domain",
"identity": "example.com",
"email": "orders@example.com",
"displayName": "Example Store"
}'
ప్రతిస్పందనలో గుర్తింపు వస్తుంది. డొమైన్ కోసం payload లో ప్రచురించాల్సిన DNS రికార్డ్లు ఉంటాయి; ప్రతి ఒక్కటి key నుంచి value వైపు CNAME: మొదట ఇమెయిల్ ప్రొవైడర్కు చెందిన మూడు DKIM రికార్డ్లు, తరువాత Oblic సొంత రికార్డ్.
ప్రతిస్పందనలో భాగం
{
"status": "success",
"data": {
"id": "OEM000R7ZM4Q2VXH00",
"email": "orders@example.com",
"displayName": "Example Store",
"domain": "example.com",
"verificationStatus": "PENDING",
"sendingMode": "OWN",
"payload": [
{ "key": "6gbrjpgwjskckoa6a5zn6fwqkn67xbtw._domainkey.example.com", "value": "6gbrjpgwjskckoa6a5zn6fwqkn67xbtw.dkim.amazonses.com" },
{ "key": "pwmp4w2fqavhvhqfsxe3ch7mhc6y3kzj._domainkey.example.com", "value": "pwmp4w2fqavhvhqfsxe3ch7mhc6y3kzj.dkim.amazonses.com" },
{ "key": "y2xbgbc34rt5t5yjzu4mktqq3e4zrl7n._domainkey.example.com", "value": "y2xbgbc34rt5t5yjzu4mktqq3e4zrl7n.dkim.amazonses.com" },
{ "key": "_9f86d081884c4d659a2feaa0c55ad015.example.com", "value": "2c26b46b68ffc68ff99b453c1d304134.qwertyui.validation.oblic.app" }
]
},
"errors": null
}
ఖాతాలో ఇప్పటికే ఉన్న గుర్తింపును జోడిస్తే దాని ప్రస్తుత స్థితి తిరిగి వస్తుంది. విలువ లేని ఫీల్డ్ వదిలివేయబడుతుంది.
గుర్తింపును ధృవీకరించడం
- డొమైన్ దాని DNS రికార్డ్లను ప్రచురించినప్పుడు ధృవీకరించబడుతుంది: DKIM రికార్డ్లతో ప్రొవైడర్ ఇమెయిల్పై సంతకం చేస్తుంది; Oblic సొంత రికార్డ్ డొమైన్ ఖాతాకు చెందినదని నిరూపిస్తుంది. ధృవీకరించిన డొమైన్లోని ప్రతి చిరునామా పంపగలదు.
- చిరునామాకు ఇమెయిల్ ప్రొవైడర్ నుంచి లింక్ వస్తుంది; దాని యజమాని దాన్ని తెరుస్తారు. దాని డొమైన్ కూడా ఖాతా డొమైన్ గుర్తింపుగా ధృవీకరించబడినప్పుడు పంపగలదు.
- Gmail లేదా Outlook వంటి పబ్లిక్ మెయిల్ సేవ చిరునామాతో DNS రికార్డ్లను ప్రచురించడం సాధ్యం కాదు; మరొక ప్రొవైడర్ ద్వారా దాని పేరుతో పంపిన ఇమెయిల్ తనిఖీల్లో విఫలమవుతుంది. అందువల్ల Oblic తన సేవ ద్వారా పంపుతుంది, ఇందులో
sendingModeవిలువOBLIC: Oblic సొంత పంపే డొమైన్ నుంచి “మీ పేరు via Oblic” పేరుతో పంపుతుంది, ప్రత్యుత్తరాలు అసలు చిరునామాకు వెళ్తాయి. యాజమాన్యాన్ని నిర్ధారించడానికి Oblic ఆ చిరునామాకు 72 గంటలు చెల్లుబాటయ్యే లింక్ పంపుతుంది; దాన్ని తెరిచే వరకు గుర్తింపుతో పంపడం సాధ్యం కాదు. పబ్లిక్ మెయిల్ సేవ డొమైన్నుDomainగా జోడించలేరు. ఈ మోడ్కు Oblic పంపే డొమైన్ కాన్ఫిగర్ చేయబడి ఉండాలి; లేకపోతే చిరునామాPUBLIC_MAILBOX_DOMAINతో తిరస్కరించబడుతుంది. - Oblic సొంత డొమైన్లు ఏ ఖాతాకూ గుర్తింపులు కాలేవు.
గుర్తింపు పంపగలిగినప్పుడు verificationStatus విలువ SUCCESS; అప్పటి వరకు PENDING.
| తిరస్కరణ | cd | ఎప్పుడు |
|---|---|---|
| 400 | INVALID_IDENTITY | Email గుర్తింపు ఇమెయిల్ చిరునామా కాదు, లేదా డొమైన్లోని email ఆ డొమైన్కు చెందినది కాదు |
| 400 | PUBLIC_MAILBOX_DOMAIN | gmail.com వంటి పబ్లిక్ మెయిల్ డొమైన్ను Domain గా జోడించినప్పుడు, లేదా Oblic పంపే డొమైన్ కాన్ఫిగర్ చేయనప్పుడు పబ్లిక్ మెయిల్ Email ఉపయోగించినప్పుడు |
| 400 | OBLIC_DOMAIN | Oblic సొంత డొమైన్లలో ఒకటి |
| 400 | IDENTITY_LIMIT_REACHED | ఇమెయిల్ ప్రొవైడర్ అనుమతించే గరిష్ఠ గుర్తింపుల సంఖ్య చేరింది |
| 503 | EMAIL_PROVIDER_UNAVAILABLE | ఇమెయిల్ ప్రొవైడర్ను చేరుకోలేకపోయింది; మళ్లీ ప్రయత్నించండి |
గుర్తింపుల జాబితా చూడడం
ఖాతా గుర్తింపులు, కాల్కు ముందే ధృవీకరించినవి ముందుగా. జాబితా తీసుకునేటప్పుడు పెండింగ్లో ఉన్న గుర్తింపులు మళ్లీ తనిఖీ చేయబడతాయి; ఈ తనిఖీలో ధృవీకరించబడిన గుర్తింపు అదే సమాధానంలో SUCCESS గా కనిపిస్తుంది.
గుర్తింపును తొలగించడం
గుర్తింపు పంపడం ఆపేస్తుంది; Oblic ద్వారా పంపే చిరునామా నిర్ధారణ కూడా ముగుస్తుంది. మళ్లీ జోడిస్తే మళ్లీ నిర్ధారించాలి. ఖాతాలో ఆ గుర్తింపు ఉన్నా లేకపోయినా ప్రతిస్పందన 200 అవుతుంది.