blob: 466e3e186e1041734485be583482852b5a11561c [file] [log] [blame]
Zdravko Bozakov2da76342019-10-21 09:47:35 +02001.. _BBSimAPI:
2
3BBSimAPI
4--------
5
Zack Williams4b0ef4d2019-12-18 14:25:20 -07006BBSim exposes gRPC and REST APIs for external control of the simulated OLT. The
7API is defined using the protocol buffer specification in
8`api/bbsim/bbsim.proto`.
9
10By default, the gRPC server is started on port 50070 and the REST server is
11started on port 50071. The following endpoints are currently defined:
Zdravko Bozakov2da76342019-10-21 09:47:35 +020012
13.. openapi:: ../swagger/bbsim/bbsim.swagger.json
14
15Legacy BBSimAPI
16---------------
17
Zack Williams4b0ef4d2019-12-18 14:25:20 -070018Additionally, a legacy API is available, defined in `api/legacy/bbsim.proto`.
19This API is deprecated and will be removed once BBSim reaches feature parity
20with the legacy version.
21
22By default, the legacy gRPC server is started on port 50072 and the
23corresponding REST server is started on port 50073. The following endpoints are
24currently defined:
Zdravko Bozakov2da76342019-10-21 09:47:35 +020025
26.. openapi:: ../swagger/legacy/bbsim.swagger.json