Request + response examples

1
syntax = "proto3";
2
3
package userservice.v1;
4
5
service UserService {
6
  rpc CreateUser(CreateUserRequest) returns (User) {
7
    option (x_fern_examples) = '{
8
      "StandardUser": {
9
        "description": "Create a regular user account",
10
        "request": {
11
          "email": "john@example.com",
12
          "name": "John Doe",
13
          "age": 30,
14
          "preferences": {
15
            "theme": "dark",
16
            "notifications": true
17
          }
18
        },
19
        "response": {
20
          "id": "user_123",
21
          "email": "john@example.com",
22
          "name": "John Doe",
23
          "created_at": "2024-01-15T10:30:00Z"
24
        }
25
      },
26
      "AdminUser": {
27
        "description": "Create an admin user with special permissions",
28
        "request": {
29
          "email": "admin@example.com",
30
          "name": "Admin User",
31
          "role": "admin",
32
          "permissions": ["read", "write", "delete"]
33
        },
34
        "response": {
35
          "id": "user_456",
36
          "email": "admin@example.com",
37
          "name": "Admin User",
38
          "role": "admin",
39
          "created_at": "2024-01-15T10:30:00Z"
40
        }
41
      }
42
    }';
43
  }
44
}