Authenticated Guild Query

Version: 1.0.0 Workflow: authenticated-guild-query Category: Authentication


Description

Authenticate and query current player’s guild information.

Prerequisites

Steps

1. Authenticate with Webapp

Request Body:

{
  "username": "",
  "password": ""
}

Request Headers:

Header Value
Content-Type application/json

Data Extraction:

Expected Response:

Error Handling:

Status Action
401 Invalid credentials - verify username/password
500 Server error - retry with exponential backoff

2. Get Current Player’s Guild

Request Headers:

Header Value
Cookie ``
Accept application/json

Data Extraction:

Expected Response:

Error Handling:

Status Action
401 Session expired - re-authenticate (go to step 1)
404 Player not in a guild
500 Server error - retry with exponential backoff

3. Get Guild Member Count

Request Headers:

Header Value
Cookie ``
Accept application/json

Data Extraction:

Expected Response:

Result

{
  "guild": {
    "id": "",
    "name": "",
    "member_count": ""
  },
  "session": {
    "cookie": ""
  }
}

Error Handling Summary

Step Status Action
1 401 Invalid credentials - cannot proceed
1 500 Server error - retry with exponential backoff
2 401 Session expired - re-authenticate and retry
2 404 Player not in a guild - result.guild will be null

Notes

This workflow demonstrates authentication followed by authenticated API calls. The session cookie from step 1 is used in subsequent requests.