Add external API for sending SMS to openapi

docs/api-usage.md

@@ -11,18 +11,28 @@ An API key can be created at https://notifications-admin.app.cloud.gov/services/
 
 ## Using OpenAPI documentation
 
-### Retrieving a bearer token for use
+### Retrieving a jwt-encoded bearer token for use
 
 On a mac, run
 
+#### Admin UI token
+
 ```
 flask command create-admin-jwt | tail -n 1 | pbcopy
 ```
 
+#### User token
+
+```
+flask command create-user-jwt --token=<USER_API_TOKEN> | tail -n 1 | pbcopy
+```
+
 to copy a token usable by the admin UI to your pasteboard. This token will expire in 30 seconds
 
 ### Disable token expiration checking in development
 
+Because jwt tokens expire so quickly, the development server can be set to allow tokens older than 30 seconds:
+
 ```
 env ALLOW_EXPIRED_API_TOKEN=1 make run-flask
 ```

docs/openapi.yml

@@ -441,3 +441,28 @@ paths:
                     type: array
                     items:
                       $ref: "#/components/schemas/userObject"
+  /v2/notifications/sms:
+    post:
+      security:
+        - bearerAuth: []
+      description: 'Send an SMS message'
+      tags:
+        - external-api
+      requestBody:
+        required: true
+        content:
+          application/json:
+            schema:
+              type: object
+              properties:
+                phone_number:
+                  type: string
+                template_id:
+                  type: string
+                personalisation:
+                  type: object
+                reference:
+                  type: string
+      responses:
+        '201':
+          description: Sent