PHP Classes

Ajudaime API: Find people close to the user who needs help

Recommend this page to a friend!
  Info   Documentation   View files Files   Install with Composer Install with Composer   Download Download   Reputation   Support forum   Blog    
Ratings Unique User Downloads Download Rankings
Not yet rated by the usersTotal: 55 All time: 10,609 This week: 455Up
Version License PHP version Categories
ajudaime-api 1.0.0GNU General Publi...7.4PHP 5, Web services, Geography
Description 

Author

This package provides an API to find people close to the user who needs help.

The API can record needs of users with details like their location, as well list, update and remove those needs from the database on which those needs are recorded.

It can also manage donations by other users that address those needs.

Innovation Award
PHP Programming Innovation award nominee
April 2020
Number 5
Many people need help sometimes to solve urgent problems, so they need to let other people that can solve those problems know how they can be contacted to provide a solution.

This package provides an API to find close people that can find a solution. This allows to implement Web or mobile applications that can connect people with problems with people that can provide solutions.

Manuel Lemos
Picture of Paulo Henrique
Name: Paulo Henrique <contact>
Classes: 5 packages by
Country: Brazil Brazil
Innovation award
Innovation award
Nominee: 4x

 

Documentation

API Be The Hero

A simple API to control donations to people who need. This API use elasticsearch using that ` https: // github.com / phzao / Ajudaime-db`

Ps. This API was made on 2 days and is there is no unit tests for routes yet.

Requirements

You must have installed Git, Docker, Docker-compose and Make before proceeding.

These ports must be available: - 8888 (api)

Installing

After cloning the repository you must run:

make up

The whole process can take a while, it depends on your computer.

After finish, just access the url, to register a user and start using:

`` http://localhost:8888/google-authenticate ``

Note.: This installation must be done only once.

Routes

Open Routes

GET - http://localhost:8888/public/donations/{user_id}/user  -> Show donations by user.
GET - http://localhost:8888/public/donations/{status}/status -> Show donations by status.
GET - http://localhost:8888/public/needs/{user_id}/user -> Show needs by user.
GET - http://localhost:8888/public/needs -> List all needs not canceled.

Private Routes

POST - http://localhost:8888/api/v1/needs 
PUT - http://localhost:8888/api/v1/needs/{uuid}
DELETE - http://localhost:8888/api/v1/needs/{uuid}
GET - http://localhost:8888/api/v1/needs/{uuid} -> show details 

PUT - http://localhost:8888/api/v1/donations/{uuid}/done -> did by a helper
PUT - http://localhost:8888/api/v1/donations/{uuid}/cancel -> did by a helper
PUT - http://localhost:8888/api/v1/donations/{uuid}/confirm -> did by who needs help
POST - http://localhost:8888/api/v1/donations

POST - http://localhost:8888/api/v1/talks/{donation_id}

PUT - http://localhost:8888/api/v1/users


  Files folder image Files (151)  
File Role Description
Files folder imagebin (2 files)
Files folder imageconfig (4 files, 2 directories)
Files folder imagephpdocker (2 directories)
Files folder imagepublic (1 file)
Files folder imagesrc (1 file, 11 directories)
Files folder imagetemplates (1 file)
Files folder imagetests (2 files, 4 directories)
Accessible without login Plain text file .env.dist Data Auxiliary data
Accessible without login Plain text file .env.test Data Auxiliary data
Accessible without login Plain text file .stack-symfony.yaml Data Auxiliary data
Accessible without login Plain text file .stack.yaml Data Auxiliary data
Accessible without login Plain text file composer.json Data Auxiliary data
Accessible without login Plain text file composer.lock Data Auxiliary data
Accessible without login Plain text file docker-compose.yml Data Auxiliary data
Accessible without login Plain text file index.php Aux. Auxiliary script
Accessible without login Plain text file Makefile Data Auxiliary data
Accessible without login Plain text file package-lock.json Data Auxiliary data
Accessible without login Plain text file phpunit.sh Data Auxiliary data
Accessible without login Plain text file phpunit.xml.dist Data Auxiliary data
Accessible without login Plain text file README.md Doc. Documentation
Accessible without login Plain text file serverless.yml Data Auxiliary data
Accessible without login Plain text file template.yml Data Auxiliary data

The PHP Classes site has supported package installation using the Composer tool since 2013, as you may verify by reading this instructions page.
Install with Composer Install with Composer
 Version Control Unique User Downloads Download Rankings  
 100%
Total:55
This week:0
All time:10,609
This week:455Up