Written source by id API will be updated

[Simurgan]

This issue is ready to be started.

• 1. Response fields of the API will be updated
• 2. The input and output schema of the updated API will be shown in the comments section of this issue

Response properties can be found in the comments section of this issue.
Since the frontend is waiting for these developments, this issue is urgent.

[Simurgan]

@said-yolcu you can find the specifications below.

Return type should include:

• Name
• Alternate names
• Author
• Genre
• Language
• Translated languages
• Year written
• Known copies
• Survived copies
• Library information
• Other information
• Remarkable works
• Source referenced
• Cities the source written in
• Cities source mention

If there is a property in the above list which has no corresponding field in the database, please contact me. Most probably its title is changed in the frontend and it is referred with the new one.

[said-yolcu]

Source referenced does not exist in the DB. Other items are already returned, although some of them with slightly different names. In addition to this list related Ordinary persons and Unordinary Persons are also returned. If these are unnecessary I can remove them. So let me know @Simurgan

P.S. If Source Referenced is a mapping to Secondary Source, we can postpone it until the creation and integration of Secondary Source.

[Simurgan]

hi @said-yolcu , yes you are right. we will omit "source referenced" field. I think there has been a misunderstanding with it. also, ordinary and unordinary list can be kept there since we might use them in the frontend side even if it seems like that we won't use them for now.

[said-yolcu]

The endpoint already exists with requested properties, but below is its documentation is provided for future reference.

1. Endpoint: {{URL}}/writtensource/{{id}}

2. HTTP Request Method: GET

3. Request: Request has no body.

4. Response:

{
    int Id
    string Name
    List<string>? AlternateNames 
    string? Author 
    List<int>? YearWritten 
    int? ProbableYearWritten 
    GenreDto? Genre 
    LanguageDto? Language 
    List<LanguageDto>? TranslatedLanguages 
    List<CityBaseDto>? CitiesMentionedByTheSource 
    List<CityBaseDto>? CitiesWhereSourcesAreWritten 
    string? KnownCopies 
    string? SurvivedCopies 
    string? LibraryInformation 
    string? OtherInformation 
    string? RemarkableWorksOnTheBook 
    List<OrdinaryPersonBaseDto>? OrdinaryPersons 
    List<UnordinaryPersonBaseDto>? UnordinaryPersons 
}

[said-yolcu]

This issue can be closed after review. @Simurgan