move qualifications API into v1 namespace

app/controllers/api/teacher_record_service/v1/qualifications_controller.rb

@@ -0,0 +1,31 @@
+module API
+  module TeacherRecordService
+    module V1
+      class QualificationsController < BaseController
+        def show
+          participant_outcomes = participant_outcome_query
+
+          render json: to_json(participant_outcomes)
+        end
+
+      private
+
+        def trn
+          params[:trn]
+        end
+
+        def participant_outcome_query
+          Qualifications::Query.new.qualifications(trn:)
+        end
+
+        def to_json(participant_outcomes)
+          QualificationsSerializer.render(trn, root: "data", participant_outcomes:)
+        end
+
+        def api_token_scope
+          APIToken.scopes[:teacher_record_service]
+        end
+      end
+    end
+  end
+end

config/routes.rb

@@ -210,7 +210,9 @@
     end
 
     namespace :teacher_record_service, path: "teacher-record-service", defaults: { format: :json } do
-      resources :qualifications, path: "npq-qualifications", only: %i[show], param: :trn
+      namespace :v1 do
+        resources :qualifications, path: "npq-qualifications", only: %i[show], param: :trn
+      end
     end
   end
 

docs/qualifications_api.md

@@ -15,7 +15,7 @@ It returns both qualifications that are currently held in NPQ registration and t
 
 To get qualifications for a TRN:
 
-`GET /api/teacher-record-service/npq-qualifications/1000207`
+`GET /api/teacher-record-service/v1/npq-qualifications/1000207`
 
 Example response:
 

spec/requests/api/teacher_record_service/qualifications_spec.rb

@@ -1,8 +1,8 @@
 require "rails_helper"
 
 RSpec.describe "Qualifications endpoint", type: :request do
-  describe "GET /api/teacher-record-service/npq-qualifications/:trn" do
-    let(:path) { "/api/teacher-record-service/npq-qualifications/#{trn}" }
+  describe "GET /api/teacher-record-service/v1/npq-qualifications/:trn" do
+    let(:path) { "/api/teacher-record-service/v1/npq-qualifications/#{trn}" }
 
     before { create(:api_token, :teacher_record_service) }