add skeleton for email confirmation endpoint

merwok · merwok · commit 4eced4707f4c · 2018-10-30T12:50:21.000-04:00
diff --git a/demo/demo/accounts/templates/rest_auth_toolkit/email_confirmation.html b/demo/demo/accounts/templates/rest_auth_toolkit/email_confirmation.html
@@ -8,9 +8,16 @@
 <body style="background-color: #F7F8FA;">
 <div>
 
-<p>{% trans "Follow this link to validate your email:" %}<br>
- {% url "pages:confirm-email" token=confirmation.external_id as confirmation_url %}
- <a href="{{ base_url }}{{ confirmation_url }}">{{ base_url }}{{ confirmation_url }}</a></p>
+<p>
+  {% trans "Follow this link to validate your email:" %}<br>
+  {% url "pages:confirm-email" token=confirmation.external_id as confirmation_url %}
+  <a href="{{ base_url }}{{ confirmation_url }}">{{ base_url }}{{ confirmation_url }}</a>
+</p>
+
+<p>
+  {% trans "Or send an API request to simulate a front-end application:" %}<br>
+  <code>HTTP POST {% url "auth:confirm" %} token="{{ confirmation.external_id }}"</code>
+</p>
 
 </div>
 </body>
diff --git a/demo/demo/accounts/templates/rest_auth_toolkit/email_confirmation.txt b/demo/demo/accounts/templates/rest_auth_toolkit/email_confirmation.txt
@@ -4,4 +4,7 @@
 {% trans "Follow this link to validate your email:" %}
 {{ base_url }}{% url "pages:confirm-email" token=confirmation.external_id %}
 
+{% trans "Or send an API request to simulate a front-end application:" %}
+  HTTP POST {% url "auth:confirm" %} token="{{ confirmation.external_id }}"
+
 {% endautoescape %}
diff --git a/demo/demo/urls.py b/demo/demo/urls.py
@@ -3,11 +3,18 @@
 from django.urls import include, path
 from django.contrib import admin
 
-from rest_auth_toolkit.views import FacebookLoginView, LoginView, LogoutView, SignupView
+from rest_auth_toolkit.views import (
+    EmailConfirmationView,
+    FacebookLoginView,
+    LoginView,
+    LogoutView,
+    SignupView,
+)
 
 
 auth_urlpatterns = [
     path('signup/', SignupView.as_view(), name='signup'),
+    path('confirm/', EmailConfirmationView.as_view(), name='confirm'),
     path('login/', LoginView.as_view(), name='login'),
     path('logout/', LogoutView.as_view(), name='logout'),
     path('fb-login/', FacebookLoginView.as_view(), name='fb-login'),
diff --git a/rest_auth_toolkit/app.py b/rest_auth_toolkit/app.py
@@ -5,7 +5,7 @@ class RestAuthToolkitConfig(AppConfig):
     """Default app config for RATK.
 
     This installs a signal handler to set user.is_active when
-    email_confirmed is emitted.
+    email_confirmed is emitted by EmailConfirmationView.
     """
     name = 'rest_auth_toolkit'
 
diff --git a/rest_auth_toolkit/views.py b/rest_auth_toolkit/views.py
@@ -75,6 +75,21 @@ def post(self, request):
         return Response(status=status.HTTP_201_CREATED)
 
 
+class EmailConfirmationView(generics.GenericAPIView):
+    """Validate an email address after sign-up.
+
+    Response: 200 OK (no content)
+
+    Error response (code 400):
+
+    ```json
+    {"errors": {"token": "Error message"}}
+    ```
+    """
+    def post(self, request):
+        pass
+
+
 class LoginView(generics.GenericAPIView):
     """Authenticate a user, return an API auth token if valid.
 
