POST/api/public/access-request/email/start-verification
கொடுக்கப்பட்ட மின்னஞ்சல் முகவரிக்கு ஆறு இலக்க, 10 நிமிடங்களுக்கு செல்லுபடியாகும் உறுதிப்படுத்தல் குறியீட்டை அனுப்புகிறது – அணுகல் கோரிக்கையின் முதல் படி.
உறுதிப்படுத்தப்பட வேண்டிய முகவரியை `email` புலத்தில் அனுப்பவும். பதிலில் `verification_id`, `expires_in_minutes` (10), `resend_cooldown_seconds` (60) ஆகியவை உள்ளன. `verification_id`-ஐ அதே மின்னஞ்சல் முகவரி மற்றும் `POST /api/public/access-request/email/verify`-இல் பெறப்பட்ட குறியீட்டுடன் பயன்படுத்தவும். காத்திருப்பு நேரம் முடிந்த பிறகே மீண்டும் அனுப்பலாம்; மீதமுள்ள நேரத்தை உங்கள் இடைமுகத்தில் காட்டவும். வரம்பு மீறப்பட்டால் முடிவுப்புள்ளி 429 `RATE_LIMIT_EXCEEDED` எனப் பதிலளிக்கும். மின்னஞ்சல் அனுப்ப முடியவில்லை எனில் 502 `MAIL_NOT_SENT` எனப் பதிலளிக்கும்; இந்த நிலையில் முகவரியைச் சரிபார்த்து பின்னர் மீண்டும் முயற்சிக்கவும்.
கண்ணோட்டம்
அழைப்பு: POST /api/public/access-request/email/start-verification. இந்த எண்ட்பாயிண்ட் Zentor App API-யின் “பொது படிவங்கள்” குழுவைச் சேர்ந்தது. இது பொதுவில் அணுகக்கூடியது; அங்கீகாரம் (authentication) தேவையில்லை. இந்த அழைப்பு idempotent அல்ல: ஒவ்வொரு வெற்றிகரமான அழைப்பும் செயலை மீண்டும் தூண்டும். கட்டாய அளவுருக்கள்: email (பாடி). ஆவணப்படுத்தப்பட்ட பிழை நிலைகள்: 429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT. கீழே உள்ள மாதிரி பதில், JSON வடிவில் வெற்றிகரமான பதிலின் கட்டமைப்பைக் காட்டுகிறது.
அங்கீகாரம் & பாதுகாப்பு
அங்கீகாரம் தேவையில்லை
ஒரு IP முகவரிக்கு 15 நிமிடங்களுக்கு அதிகபட்சம் 10 கோரிக்கைகள். கூடுதலாக Zentor-இன் அணுகல் விதிகள் (IP, நாடு, மின்னஞ்சல் டொமைன் விதிகள்) பொருந்தும்; நிராகரிக்கப்பட்ட அழைப்புகள் 403 பெறும்.
கோரிக்கை வரம்பு (Rate-Limit): 10 Anfragen pro 15 Minuten (IP-basiert)
Idempotent (மீண்டும் செய்தாலும் அதே விளைவு): இல்லை
அளவுருக்கள்
email(body, string, கட்டாயம்)— உறுதிப்படுத்தப்பட வேண்டிய மின்னஞ்சல் முகவரிஎடுத்துக்காட்டுக் கோரிக்கை
{"email":"max@example.com"}எடுத்துக்காட்டுப் பதில்
{"ok":true,"verification_id":"<UUID>","expires_in_minutes":10,"resend_cooldown_seconds":60}பிழைக் குறியீடுகள்
429 RATE_LIMIT_EXCEEDED — இந்த IP முகவரியிலிருந்து அதிகமான கோரிக்கைகள். புதிய குறியீட்டைக் கோருவதற்கு முன் காத்திருங்கள்.502 MAIL_NOT_SENT — உறுதிப்படுத்தல் குறியீட்டை மின்னஞ்சல் மூலம் வழங்க முடியவில்லை.சரிபார்க்கப்பட்ட நடத்தை
அழைப்பு `verification_id`-உடன் 200-ஐத் திருப்பி அளிக்கிறது, மேலும் குறியீடு மின்னஞ்சல் மூலம் வழங்கப்படும்; மீண்டும் மீண்டும் செய்யப்படும் அழைப்புகள் 429 `RATE_LIMIT_EXCEEDED`-ஐத் திருப்பி அளிக்கும்.
பொது படிவங்கள்
POST /api/public/contactZentor App இணையதளத்தின் தொடர்பு படிவத்திலிருந்து ஒரு கோரிக்கையைப் பெற்று அதை Zentor குழுவிற்கு அனுப்புகிறது.POST /api/public/consultationZentor App இணையதள படிவத்திலிருந்து ஒரு ஆலோசனைக் கோரிக்கையைப் பெறுகிறது.POST /api/public/access-requestஒரு தொகுப்புக்கு (Starter, தனிப்பயனாக்கப்பட்ட அல்லது 14 நாள் டெமோ) அணுகல் கோரிக்கையைச் சமர்ப்பிக்கிறது. இதற்கு முன்பே உறுதிப்படுத்தப்பட்ட மின்னஞ்சல் முகவரி தேவை.POST /api/public/access-request/email/verifyமின்னஞ்சல் மூலம் அனுப்பப்பட்ட குறியீட்டைச் சரிபார்த்து, பின்வரும் அணுகல் கோரிக்கைக்கான உறுதிப்படுத்தல் டோக்கனை வெளியிடுகிறது.GET /api/public/access-request/payment-statusஅணுகல் கோரிக்கைக்கு தற்போது எந்தக் கட்டண முறைகள் (PayPal, Stripe) கிடைக்கின்றன என்பதைக் குறிக்கிறது.GET /api/public/access-request/paypal/configகட்டணச் செயல்முறைக்கான பொது PayPal உள்ளமைவை (இயக்கப்பட்டது, முறை, நாணயம்) வழங்குகிறது.POST /api/public/access-request/paypal/create-orderதேர்ந்தெடுக்கப்பட்ட தொகுப்புக்கான PayPal ஆர்டரை உருவாக்குகிறது.POST /api/public/access-request/paypal/capture-orderமுன்பு உருவாக்கப்பட்டு வாங்குபவரால் PayPal செக்அவுட்டில் ஒப்புக்கொள்ளப்பட்ட ஆர்டரை முடிக்கிறது (Capture). தொகையை சர்வர் மட்டுமே தீர்மானிக்கிறது.POST /api/public/access-request/stripe/create-checkoutதேர்ந்தெடுக்கப்பட்ட தொகுப்புக்கான Stripe செக்அவுட் அமர்வை உருவாக்குகிறது.POST /api/public/activate-accountபுதிதாக உருவாக்கப்பட்ட கணக்கைச் செயல்படுத்தி முதல் கடவுச்சொல்லை அமைக்கிறது – அழைப்பு மின்னஞ்சலில் உள்ள இணைப்பு மூலம் தொடங்கப்படுகிறது.