{"openapi":"3.1.0","info":{"title":"WMP participant registry","description":"Registers WMP participants in the SMP and publishes their BDXL DNS records.","version":"1.0.0"},"paths":{"/participants":{"get":{"summary":"List Participants","operationId":"list_participants_participants_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ParticipantList"}}}}}}},"/participants/{participant_id}":{"get":{"summary":"Get Participant","operationId":"get_participant_participants__participant_id__get","parameters":[{"name":"participant_id","in":"path","required":true,"schema":{"type":"string","description":"\"<ICD>:<id>\" or \"ebcore:iso6523:<ICD>:<id>\"","examples":["0007:5567164818"],"title":"Participant Id"},"description":"\"<ICD>:<id>\" or \"ebcore:iso6523:<ICD>:<id>\""}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Participant"}}}},"404":{"description":"Not registered"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"put":{"summary":"Put Participant","description":"Register a participant, or replace its certificate and services.\n\nPublishes the SMP entry (ServiceGroup + ServiceMetadata) and the BDXL U-NAPTR records.\nEach service is published as wss://<host>/wmp and https://<host>/wmp.","operationId":"put_participant_participants__participant_id__put","parameters":[{"name":"participant_id","in":"path","required":true,"schema":{"type":"string","description":"\"<ICD>:<id>\" or \"ebcore:iso6523:<ICD>:<id>\"","examples":["0007:5567164818"],"title":"Participant Id"},"description":"\"<ICD>:<id>\" or \"ebcore:iso6523:<ICD>:<id>\""}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Registration"}}}},"responses":{"200":{"description":"Replaced an existing registration","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Participant"}}}},"201":{"description":"Registered","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Participant"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}},"delete":{"summary":"Delete Participant","description":"Remove the participant's SMP entry and DNS records.","operationId":"delete_participant_participants__participant_id__delete","parameters":[{"name":"participant_id","in":"path","required":true,"schema":{"type":"string","description":"\"<ICD>:<id>\" or \"ebcore:iso6523:<ICD>:<id>\"","examples":["0007:5567164818"],"title":"Participant Id"},"description":"\"<ICD>:<id>\" or \"ebcore:iso6523:<ICD>:<id>\""}],"responses":{"204":{"description":"Successful Response"},"404":{"description":"Not registered"},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}}},"components":{"schemas":{"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"Participant":{"properties":{"id":{"type":"string","title":"Id","examples":["0007:5567164818"]},"wmp_id":{"type":"string","title":"Wmp Id","examples":["ebcore:iso6523:0007:5567164818"]},"certificate":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Certificate","description":"PEM; null if the SMP holds no services for it"},"services":{"items":{"$ref":"#/components/schemas/Service"},"type":"array","title":"Services"},"dns":{"additionalProperties":{"type":"string"},"type":"object","title":"Dns","description":"The BDXL names published for the participant"},"warnings":{"items":{"type":"string"},"type":"array","title":"Warnings","description":"Non-fatal problems, e.g. CS-15 8.4 certificate issues"}},"type":"object","required":["id","wmp_id","certificate","services","dns"],"title":"Participant"},"ParticipantList":{"properties":{"participants":{"items":{"type":"string"},"type":"array","title":"Participants"}},"type":"object","required":["participants"],"title":"ParticipantList"},"Registration":{"properties":{"certificate":{"type":"string","title":"Certificate","description":"The participant's Subscriber certificate (CS-15 8.4), PEM"},"services":{"items":{"$ref":"#/components/schemas/Service"},"type":"array","minItems":1,"title":"Services"}},"type":"object","required":["certificate","services"],"title":"Registration","description":"What a client sends to register (or replace) a participant."},"Service":{"properties":{"process":{"type":"string","maxLength":200,"pattern":"^[A-Za-z0-9][A-Za-z0-9._:-]*$","title":"Process","examples":["wmp-evidence"]},"host":{"type":"string","maxLength":253,"pattern":"^[A-Za-z0-9]([A-Za-z0-9-]*[A-Za-z0-9])?(\\.[A-Za-z0-9]([A-Za-z0-9-]*[A-Za-z0-9])?)*(:\\d{1,5})?$","title":"Host","examples":["qerds.qtsp.example"]}},"type":"object","required":["process","host"],"title":"Service"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"},"input":{"title":"Input"},"ctx":{"type":"object","title":"Context"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"}}}}