Learn how to interact with GPSK-01 using the Ouro SDK or REST API.
API access requires an API key. Create one in Settings → API Keys, then set OURO_API_KEY in your environment.
Retrieve service
Get service metadata including name, visibility, description, and configuration. You can retrieve by service ID or identifier.
import osfrom ouro import Ouro# Set OURO_API_KEY in your environment or replace os.environ.get("OURO_API_KEY")ouro = Ouro(api_key=os.environ.get("OURO_API_KEY"))# Option 1: Retrieve by service IDservice_id = "8b2b0fab-fc48-4b03-9387-11c986a989ae"service = ouro.services.retrieve(service_id)# Option 2: Retrieve by service identifier (username/service-name)service_identifier = "will/gpsk-01"service = ouro.services.retrieve(service_identifier)print(service.name, service.visibility)print(service.metadata)
Read spec
Retrieve the OpenAPI specification for this service to understand available endpoints and their parameters.
# Retrieve the serviceservice = ouro.services.retrieve("will/gpsk-01")# Read the OpenAPI specspec = ouro.services.read_spec(service.id)print(spec.get("openapi"))print(spec.get("info"))
Read routes
Get all routes for this service and use them programmatically.
# Retrieve the serviceservice = ouro.services.retrieve("will/gpsk-01")# Get all routes for this serviceroutes = ouro.services.read_routes(service.id)for route in routes: print(f"{route.route.method} {route.route.path}") print(f" Summary: {route.route.summary}")
Click on an endpoint to view its detailed documentation.
Learn how to interact with GPSK-01 using the Ouro SDK or REST API.
API access requires an API key. Create one in Settings → API Keys, then set OURO_API_KEY in your environment.
Retrieve service
Get service metadata including name, visibility, description, and configuration. You can retrieve by service ID or identifier.
import osfrom ouro import Ouro# Set OURO_API_KEY in your environment or replace os.environ.get("OURO_API_KEY")ouro = Ouro(api_key=os.environ.get("OURO_API_KEY"))# Option 1: Retrieve by service IDservice_id = "8b2b0fab-fc48-4b03-9387-11c986a989ae"service = ouro.services.retrieve(service_id)# Option 2: Retrieve by service identifier (username/service-name)service_identifier = "will/gpsk-01"service = ouro.services.retrieve(service_identifier)print(service.name, service.visibility)print(service.metadata)
Read spec
Retrieve the OpenAPI specification for this service to understand available endpoints and their parameters.
# Retrieve the serviceservice = ouro.services.retrieve("will/gpsk-01")# Read the OpenAPI specspec = ouro.services.read_spec(service.id)print(spec.get("openapi"))print(spec.get("info"))
Read routes
Get all routes for this service and use them programmatically.
# Retrieve the serviceservice = ouro.services.retrieve("will/gpsk-01")# Get all routes for this serviceroutes = ouro.services.read_routes(service.id)for route in routes: print(f"{route.route.method} {route.route.path}") print(f" Summary: {route.route.summary}")
Click on an endpoint to view its detailed documentation.