Initial /avilable API view and tests

src/api/tests/test_available.py

@@ -0,0 +1,39 @@
+"""Test the available domain API."""
+
+import json
+
+from django.test import client, TestCase, RequestFactory
+
+from ..views import available
+
+class AvailableViewTest(TestCase):
+
+    """Test that the view function works as expected."""
+
+    def setUp(self):
+        self.factory = RequestFactory()
+
+    def test_view_function(self):
+        request = self.factory.get("available/test.gov")
+        response = available(request, domain="test.gov")
+        # has the right text in it
+        self.assertContains(response, "available")
+        # can be parsed as JSON
+        response_object = json.loads(response.content)
+        self.assertIn("available", response_object)
+
+
+class AvailableAPITest(TestCase):
+
+    """Test that the API can be called as expected."""
+
+    def test_available_get(self):
+        response = self.client.get("/available/nonsense")
+        self.assertContains(response, "available")
+        response_object = json.loads(response.content)
+        self.assertIn("available", response_object)
+
+    def test_available_post(self):
+        """Cannot post to the /available/ API endpoint."""
+        response = self.client.post("/available/nonsense")
+        self.assertEqual(response.status_code, 405)

src/api/views.py

@@ -0,0 +1,15 @@
+"""Internal API views"""
+
+from django.views.decorators.http import require_http_methods
+from django.http import JsonResponse
+
+@require_http_methods(["GET"])
+def available(request, domain=""):
+
+    """Is a given domain available or not.
+
+    Response is a JSON dictionary with the key "available" and value true or
+    false.
+    """
+    return JsonResponse({"available": False})
+

src/registrar/config/settings.py

@@ -86,6 +86,8 @@ INSTALLED_APPS = [
     "djangooidc",
     # let's be sure to install our own application!
     "registrar",
+    # Our internal API application
+    "api",
 ]
 
 # Middleware are routines for processing web requests.

src/registrar/config/urls.py

@@ -10,6 +10,7 @@ from django.urls import include, path
 from django.views.generic import RedirectView
 
 from registrar.views import health, index, profile, whoami
+from api.views import available
 
 urlpatterns = [
     path("", index.index, name="home"),
@@ -18,6 +19,7 @@ urlpatterns = [
     path("health/", health.health),
     path("edit_profile/", profile.edit_profile, name="edit-profile"),
     path("openid/", include("djangooidc.urls")),
+    path("available/<domain>", available, name="available"),
 ]
 
 if not settings.DEBUG: