Oblic

పంపినవారి గుర్తింపులు

ఇమెయిల్ ఖాతాలోని పంపినవారి గుర్తింపుల్లో ఒకదాని నుంచి పంపబడుతుంది: ఖాతాకు చెందిన డొమైన్ లేదా చిరునామా. Oblic ధృవీకరించిన గుర్తింపు నుంచి మాత్రమే పంపుతుంది. గుర్తింపులను జోడించడానికి, తొలగించడానికి కీలో identities:manage అవసరం; జాబితా చూడటానికి identities:manage లేదా email:send అవసరం.


POST/external/v1/identities

గుర్తింపును జోడించడం

  • పేరు
    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ఎప్పుడు
400INVALID_IDENTITYEmail గుర్తింపు ఇమెయిల్ చిరునామా కాదు, లేదా డొమైన్‌లోని email ఆ డొమైన్‌కు చెందినది కాదు
400PUBLIC_MAILBOX_DOMAINgmail.com వంటి పబ్లిక్ మెయిల్ డొమైన్‌ను Domain గా జోడించినప్పుడు, లేదా Oblic పంపే డొమైన్ కాన్ఫిగర్ చేయనప్పుడు పబ్లిక్ మెయిల్ Email ఉపయోగించినప్పుడు
400OBLIC_DOMAINOblic సొంత డొమైన్‌లలో ఒకటి
400IDENTITY_LIMIT_REACHEDఇమెయిల్ ప్రొవైడర్ అనుమతించే గరిష్ఠ గుర్తింపుల సంఖ్య చేరింది
503EMAIL_PROVIDER_UNAVAILABLEఇమెయిల్ ప్రొవైడర్‌ను చేరుకోలేకపోయింది; మళ్లీ ప్రయత్నించండి

GET/external/v1/identities

గుర్తింపుల జాబితా చూడడం

ఖాతా గుర్తింపులు, కాల్‌కు ముందే ధృవీకరించినవి ముందుగా. జాబితా తీసుకునేటప్పుడు పెండింగ్‌లో ఉన్న గుర్తింపులు మళ్లీ తనిఖీ చేయబడతాయి; ఈ తనిఖీలో ధృవీకరించబడిన గుర్తింపు అదే సమాధానంలో SUCCESS గా కనిపిస్తుంది.


DELETE/external/v1/identities/{identityId}

గుర్తింపును తొలగించడం

గుర్తింపు పంపడం ఆపేస్తుంది; Oblic ద్వారా పంపే చిరునామా నిర్ధారణ కూడా ముగుస్తుంది. మళ్లీ జోడిస్తే మళ్లీ నిర్ధారించాలి. ఖాతాలో ఆ గుర్తింపు ఉన్నా లేకపోయినా ప్రతిస్పందన 200 అవుతుంది.

ఈ పేజీ సహాయకరంగా ఉందా?