esi / esi-issues

Issue tracking and feature requests for ESI
https://esi.evetech.net/
209 stars 23 forks source link

Manage corporation and alliance contacts #751

Open lunedis opened 6 years ago

lunedis commented 6 years ago

Feature request

Write access to corporation and alliance contacts analogous to personal contacts.

Routes

Corporations:

All routes would be analogous to the corresponding /characters/{character_id}/contacts/ endpoints

Authentication

Would require new SSO scopes, analogous to esi-characters.write_contacts.v1, just for corporation and alliance.

Additionally, the corp roles requirements must also be met. For corporations, the character needs the corporation role "Diplomat" (or director or CEO ofc). For alliances, the requirements are the same, but the characters must also be in the executor corporation of the alliance to set standings.

Source: https://support.eveonline.com/hc/en-us/articles/203217712-Roles-Listing

Use case

Automatic management of corporation and alliance standings.

Applications could include tools to manage blue standings of people's out-of-corporation alts (like neutral JFs) or managing of standings in a coalition consisting of multiple alliances (currently often realized with spreadsheets).

Combined with the feature #55 for write access to access lists lots of the manual work that corporation or alliance management has to do could be automated.

Example returns

Same as personal contact endpoints.

Previous XML or CREST route

None

ccp-zoetrope commented 6 years ago

Approved by GD

Headwuend commented 5 years ago

Having this would be lovely.