Starts a job to collect the profile of a business on one social media platform. Use it when you need one platform, not a summary.

Lifecycle: POST returns 201 and a request_id. Poll Get social media by platform with that request_id: 425 means not ready, and 200 means complete. If you send callback_url, Coris posts the result when it is done, as Handle async requests explains.

sequenceDiagram
  accTitle: Request social media by platform sequence diagram
  accDescr: Request social media by platform. You send POST .../social_media/{platform}/. Coris replies 201 request_id. You send GET ?request_id=... Coris replies 425 not ready. You send GET ?request_id=... Coris replies 200 complete. Coris sends POST callback_url, if sent.
  participant You
  participant Coris
  You->>Coris: POST .../social_media/{platform}/
  Coris-->>You: 201 request_id
  You->>Coris: GET ?request_id=...
  Coris-->>You: 425 not ready
  You->>Coris: GET ?request_id=...
  Coris-->>You: 200 complete
  Coris->>You: POST callback_url, if sent