Document API Routes in POSTMAN and Generate API Documentation

[prasenjeet-symon]

Title: Document API Routes in POSTMAN and Generate API Documentation

Description: This GitHub issue focuses on documenting all the existing API routes in POSTMAN to improve the accessibility and understanding of our APIs. It involves creating API documentation with clear descriptions, request examples, and response structures for each route. Additionally, we'll generate API documentation and add a link to the README file for easy reference.

Tasks:

1. API Route Documentation:

   • [ ] Create POSTMAN documentation for each existing API route.
   • [ ] Include detailed descriptions of each route, specifying the purpose and functionality.
   • [ ] Add request examples to demonstrate how to interact with each API, including required parameters and headers.
   • [ ] Document the expected response structure for each route, indicating the possible status codes and response payloads.

2. API Documentation Generation:

   • [ ] Generate API documentation in POSTMAN using the documented API routes.
   • [ ] Ensure that the POSTMAN documentation reflects the latest state of our APIs.

3. README Update:

   • [ ] Add a link to the generated API documentation in the README file to make it easily accessible for developers.

Acceptance Criteria:

• Each existing API route is documented in POSTMAN with clear descriptions, request examples, and response structures.
• The POSTMAN documentation accurately reflects the latest state of our APIs.
• A link to the generated API documentation is added to the README file for easy reference.

Additional Information:

• Documenting our APIs enhances their accessibility and usability.
• Keeping the documentation up-to-date is essential to ensure developers have accurate information.
• The README file serves as a central hub for accessing API documentation.

[Shuhua-L]

Hi, I would like to work on this issue, can you assign it to me?

[prasenjeet-symon]

@Shuhua-L Yes, assigned to you

[kenudeh]

Hi, what is the state of this project now? Still open for contribution?

[prasenjeet-symon]

Hi, what is the state of this project now? Still open for contribution?

Yes it is open . We need clear and concise API documentation.

[kenudeh]

Alright, can you please direct me to where the endpoints and other relevant details are defined?

[prasenjeet-symon]

Alright, can you please direct me to where the endpoints and other relevant details are defined?

Check the server folder, there are API routes ( in a specific folder ). And use link on the readme to setup POSTMAN

[kenudeh]

Ok, I'll go through everything and get back to you.

[kenudeh]

Hi Prasenjeet! I can work on this documentation. So far, I have cloned the POSTMAN collection, however, I am having issues cloning the repository to my local machine. I'm getting the following error:

"git@github.com: Permission denied (publickey). fatal: Could not read from remote repository.

Please make sure you have the correct access rights and the repository exists."

I'm still trying to see if I can resolve it myself, but I'd welcome your assistance.

[prasenjeet-symon]

Hi Prasenjeet! I can work on this documentation. So far, I have cloned the POSTMAN collection, however, I am having issues cloning the repository to my local machine. I'm getting the following error:

"git@github.com: Permission denied (publickey). fatal: Could not read from remote repository.

Please make sure you have the correct access rights and the repository exists."

I'm still trying to see if I can resolve it myself, but I'd welcome your assistance.

Hi. I think this is the basis of cloning the public repository. Can you watch some YouTube vids that will make it super clear. Thanks

[kenudeh]

I've resolved the issue and started the app, but I'm unable to create an account. The "sign up with Goggle" link isn't working either.

[prasenjeet-symon]

I've resolved the issue and started the app, but I'm unable to create an account. The "sign up with Goggle" link isn't working either.

This issue is related to server side , and need no client interaction . Setup POSTMAN and start the server that's all. We are working on the client side , but we want to finish server-side task first .

[kenudeh]

Just ran into another issue. The server isn't running on localhost:3001 and I believe it has to do with the following error I got:

[nodemon] app crashed - waiting for file changes before starting...

I'm sure it's why I'm not getting any response on POSTMAN, as contained in the README guide.

[prasenjeet-symon]

Just ran into another issue. The server isn't running on localhost:3001 and I believe it has to do with the following error I got:

[nodemon] app crashed - waiting for file changes before starting...

I'm sure it's why I'm not getting any response on POSTMAN, as contained in the README guide.

Okay i will take a look . Weather server is running or not .

[Believet2]

Hi i will like to be part of this, can you pls assign me?

[Believet2]

Thank you @prasenjeet-symon, so are we working individually or we can work as a team?

[prasenjeet-symon]

Thank you @prasenjeet-symon, so are we working individually or we can work as a team?

If you can work individually, that would be great. Thanks.

[Believet2]

For the sake of me begin a first timer can i work with someone that can help me? cuz im looking to gain experience and this is my time contributing to an open source project pls.

[prasenjeet-symon]

For the sake of me begin a first timer can i work with someone that can help me? cuz im looking to gain experience and this is my time contributing to an open source project pls.

Do you understand the issue ?? if not plzz ask me any questions you may have . I will help you understand the issue.

[Believet2]

For the sake of me begin a first timer can i work with someone that can help me? cuz im looking to gain experience and this is my time contributing to an open source project pls.

Do you understand the issue ?? if not plzz ask me any questions you may have . I will help you understand the issue.

i will be very glad if i can attach with someone to work on this, plzz this is my first time. plzzzzz

[Believet2]

For the sake of me begin a first timer can i work with someone that can help me? cuz im looking to gain experience and this is my time contributing to an open source project pls.

Do you understand the issue ?? if not plzz ask me any questions you may have . I will help you understand the issue.

i don't understand the issue very clearly, i need a deep explanation

[prasenjeet-symon]

Well there are multiple api routes in server folder . Your task to is to add that to postman and also document it to the postman API documentation.

[Believet2]

what about cloning the repo to local machine, does it still solve and issue?

[prasenjeet-symon]

what about cloning the repo to local machine, does it still solve and issue?

Have you ever worked with API before?

[Believet2]

what about cloning the repo to local machine, does it still solve and issue?

Have you ever worked with API before?

no, that is why i am seeking for someone to work with on this, i just finish learning technical writing and API documentation

[Believet2]

Just ran into another issue. The server isn't running on localhost:3001 and I believe it has to do with the following error I got:

[nodemon] app crashed - waiting for file changes before starting...

I'm sure it's why I'm not getting any response on POSTMAN, as contained in the README guide.

Hello @kenudeh can i pair with you to work on this project, i am a newbies and will like someone to work with in other for me to gain experience

[Believet2]

So nobody is willing to help me?

[Believet2]

Seems the link to the APIs are not working

[prasenjeet-symon]

So nobody is willing to help me?

Sorry about that, Make sure to have a clear and good understanding of API/POSTMAN . You can watch and read good videos about these topics. Thanks

[prasenjeet-symon]

Seems the link to the APIs are not working

We will take a look since I am currently busy with the Sculify Work.

[kenudeh]

Hi Prasenjeet-symon, were you able to confirm if the server is running or not? It didn't start on my machine when I tried. That meant I couldn't get any response to plug into POSTMAN.

[kenudeh]

@Believet2 just read the instructions contained on the Readme, it's self-explanatory. If I'm able to solve the technical issue I faced, I wouldn't mind carrying you along anyway.

[prasenjeet-symon]

Hi Prasenjeet-symon, were you able to confirm if the server is running or not? It didn't start on my machine when I tried. That meant I couldn't get any response to plug into POSTMAN.

I will check and let you know

[kenudeh]

Alright.

On Tue, Dec 26, 2023, 9:50 AM Prasenjeet Symon @.***> wrote:

Hi Prasenjeet-symon, were you able to confirm if the server is running or not? It didn't start on my machine when I tried. That meant I couldn't get any response to plug into POSTMAN.

I will check and let you know

— Reply to this email directly, view it on GitHub https://github.com/prasenjeet-symon/intellectia/issues/212#issuecomment-1869376298, or unsubscribe https://github.com/notifications/unsubscribe-auth/AKF7V7AQIG7RVU53F327L6TYLKFUDAVCNFSM6AAAAAA6INHLH2VHI2DSMVQWIX3LMV43OSLTON2WKQ3PNVWWK3TUHMYTQNRZGM3TMMRZHA . You are receiving this because you were mentioned.Message ID: @.***>

[Believet2]

@Believet2 just read the instructions contained on the Readme, it's self-explanatory. If I'm able to solve the technical issue I faced, I wouldn't mind carrying you along anyway.

Alright @prasenjeet-symon

[Believet2]

@prasenjeet-symon has the server been resloved?

[prasenjeet-symon]

@prasenjeet-symon has the server been resloved?

Hey @Believet2 can you plzz share the screenshot of error , so that i can take a look.

[Believet2]

@prasenjeet-symon ![Uploading Capture.PNG…]()

[prasenjeet-symon]

@Believet2 Image not uploaded successfully. Plzz try again

[Believet2]

[Believet2]

@prasenjeet-symon

[prasenjeet-symon]

I have tested server is running fine. You need to learn how to setup the postman there is doc on the readme file. @Believet2

[Believet2]

Do I have to install docker on my system? Cuz I have forked the repository in postman and it still shows me same error message

[satokenta940]

It's great, but I recommend using Apidog to record and generate API documentation. I'm currently doing this, and it has been very effective.