You don't need to wait for backend delivery your api any more, you can simulate the api response with this simple fakeApi, you can continue developing your frontend without dependencies.
It is a simple way to mock your api response.
- FakeApi Source
- Version: 1.4.0
- License: MIT-style
- Download
- Configure bindata
- Requirements to build
- Execute
- Seeds File
- Multiple Responses for Seed
- Multiple Domains
- Delay of response
- Condition Status Code
- List of links available (api)
- Web documentation
- Web documentation category
- Seed file for documentation
- Slack integration
- WebHook Autoupdate
- FakeApi with Supervisor - (writing...)
- FakeApi with Nginx - (writing...)
You can see the full available binary list here or compile those files from different platforms in your owner computer.
You can just download and use, without compile anything.
Download for Mac OSx
Download for Linux x386
Download for Linux amd64
Download for Windows x386
Download for Windows x64
If you want to build in your own computer you need follow this steps below, if you don't want to build you can download at links above.
- GO Language
- GO-Bindata - Component to help for settings
- To install
go get -u github.com/jteeuwen/go-bindata/...
- To install
Use the script init.sh or the command
$ go-bindata -o "./modules/bindata/bindata.go" -pkg "bindata" conf/*
$ env GOOS=linux GOARCH=arm GOARM=7 go build -o server main.go
$ env GOOS=darwin GOARCH=386 go build -o server main.go
$ env GOOS=windows GOARCH=386 go build -o server.exe main.go
Execute ./server or ./server web to start server.
In a folder named ./fakes/default, you need to have the seed (json files) that will represent your api, the server will read all files inside folder and load them.
Use the file name to define the URL of api.
P.S. All files seed needs to start with api_[ANYTHING].
e.g.: If file name is api_account_signup.json the url will be /api/account/signup.
The file seed needs to follow this format: the seed file needs to follow this rules, method_status_code: response (Response can be any format)
{
"[METHOD]_[STATUS_CODE]": [RESPONSE]
}
Example seed format:
{
"POST_200": {
"response": "Post Request with status code 200",
"statusCode: 200,
}
}
Example request:
curl -X POST "http://localhost:9090/api/account/signup"
Response will be:
{
"response": "POST Request with status code 200",
"statusCode: 200,
}
You can add more then one response in seeds file for the same method and different methods too, just follow the rule in seed.
E.g: Seed file name is api_account_user.json
{
"GET_200": {
"response": "GET Request with status code 200",
"statusCode: 200,
},
"POST_400": {
"response": "POST Request with status code 400",
"statusCode: 400,
"error": {
"email": "email has invalid format",
"time": "the date is invalid"
}
}
"POST_200": {
"response": "Post Request with status code 200",
"statusCode: 200,
}
}
Request POST: when you are using multiple response and no specify the status code in your header request, the response will be random between data that you putting in your seed file.
curl -X POST "/api/account/user"
Response POST Dynamic:
{
"response": "POST Request with status code 400",
"statusCode: 400,
"error": {
"email": "email has invalid format",
"time": "the date is invalid"
}
}
or
{
"response": "Post Request with status code 200",
"statusCode: 200,
}
Request POST: use the header X-Fake-Response-Code to specify the response that you want to receive.
curl -X POST -H "X-Fake-Response-Code: 400" "/api/account/user"
Response POST specific:
{
"response": "POST Request with status code 400",
"statusCode: 400,
"error": {
"email": "email has invalid format",
"time": "the date is invalid"
}
}
Multiples Response for some method
You can use multiple response for the same method and status for defined it you need to use as:
Request GET:
curl -X POST -H "X-Fake-Response-Index: 1" "/api/account/user"
Response GET specific position:
{
"GET_200:0": {
"response": "First response of GET 200",
"statusCode: 200,
},
"GET_200:1": {
"response": "Second response of GET 200",
"statusCode: 200,
},
}
If you specify slice by header as X-Fake-Response-Index: 1 the fakeApi will return data at position
if you want to use multiples domain you just add a new folder inside of folder fakes and use the
header to specific the domain name.
if you don't want to use the custom domain you can use default folder for yours files seed.
Folders example:
➜ fakeApi git:(develop) ✗ ls -la fakes
total 0
drwxr-xr-x 3 rlopes staff 102B 22 Dec 23:34 default/
drwxr-xr-x 8 rlopes staff 272B 23 Dec 00:11 hecate.com/
drwxr-xr-x 3 rlopes staff 102B 22 Dec 23:33 olx.com/
Request example:
curl -X POST -H "X-Fake-Domain: hecate.com" "http://localhost:9090/api/account/profile"
Response must be:
{
"user": {
"company": "OLX",
"country": "PT",
"email": "rodrigo.lopes@olx.com",
"id": 1,
"name": "Rodrigo Lopes",
"phone": "000000000",
"phone_region": "PT",
"username": "rlopes"
}
}
If you want to simulate delay of response you can use the header X-Fake-Delay to do that, use the Millisecond
Request example:
time curl -X POST -H "X-Fake-Delay: 3000" -H "X-Fake-Domain: hecate.com" "http://localhost:9090/api/account/profile"
Response example:
curl ... 0.01s user 0.01s system 0% cpu 3.020 total
If you want to set a condition for your DATA response,
you can test response 200 or 400 depending on value of request,
you can set a additional field named CONDITIONS for that,
if body of request match with field DATA will render the method that indicated ACTION.
{
"CONDITIONS": [
{
"ACTION": "POST_200",
"DATA": {
"username": "rodrigo.lopes@olx.com",
"password": "correct_password"
}
},
{
"ACTION": "POST_400",
"DATA": {
"username": "rodrigo.lopes@olx.com",
"password": "wrong_password"
}
}
],
"INPUT": {
"username": "rodrigo.lopes@olx.com",
"password": "secret_password"
},
"POST_200": {
"message": "Account authentication with success",
"access_token": "2bc9ef94406489a5181fbd5898aa2202836810f2",
"success": "true"
},
"POST_400": {
"message": "Failed to authenticate user",
"success": "false",
"error": {
"exception": "Exception: invalid_grant",
"title": "Invalid username and password combination"
}
}
}
You can see which links are available at FakeApi seed files, access the link http://localhost:9090/api
this link will show list of endpoints available.
The docs will be generate automatic
{
"domain": "default",
"message": "List of endpoints available for this domain",
"resource": {
"Domain": "default",
"Path": "fakes/default",
"Docs": [
{
"Path": "fakes/default/api_account_confirmation_d019ccfd071164ae7ac8ca8a934a90e8b612.json",
"Url": "/api/account/confirmation/d019ccfd071164ae7ac8ca8a934a90e8b612",
"Error": "Something is worng with file api_account_confirmation_d019ccfd071164ae7ac8ca8a934a90e8b612.json error invalid character ':' after object key:value pair",
"Endpoints": null
},
{
"Path": "fakes/default/api_account_forgot_rodrigo.lopes@olx.com.json",
"Url": "/api/account/forgot/rodrigo.lopes@olx.com",
"Error": null,
"Endpoints": [
{
"Method": "GET",
"StatusCode": 200,
"StatusText": "OK",
"Data": {
"data": {
"message": "User password recovery email was sent with success",
"success": true
}
}
},
...
]
},
...
]
}
}
You can use web page friendly if you access http://localhost:9090/docs.
this page will be generate in realtime the documents that you have in JSONS file.
This is a simple example of page:
When click at title the collapse will open then you can see the response.
If the json has error the docs will render like this
If you want to show more descriptions about your endpoint it is possible if you create a node DOC at you Seed files
this node needs to have set title and description, you can see the example above.
-
DOC:
- level: It is the category that this json belongs to.
- title: Title with little text about endpoint.
- description: Text more descriptive about what your endpoint does.
-
INPUT :
- The text saying what your endpoints are expecting to receive from client/frontend, it validate if format of request is equal what was written in seed.
P.S: Seed file with comments:
{
"DOC": {
"title": "Validate account",
"description": "This endpoint will validate the account changing flag 'pending' to 'activate'."
},
"INPUT": {
"email": "rodrigo.lopes@olx.com",
"token": "d019ccfd071164ae7ac8ca8a934a90e8b612"
},
"POST_201": {
"data": {
"success": true,
"message": "OK"
}
}
}
The web page will be rendered this seed above like it:
You need to enter in folder /etc/supervisor/conf.d and create a file with name fake-api.conf
and inside you have so set the environment.
- My app is in
/var/www/fakeApi - My logs are in
/var/log/fakeApi
[program:FakeApi]
environment=MACARON_ENV=production,FAKE_API=/var/www/fakeapiFAKE_API_CUSTOM=/var/www/fakeapi
directory=/var/www/fakeapi
command=/var/www/fakeapi/server web
autostart=true
autorestart=true
stderr_logfile=/var/log/fakeApi/err.log
stdout_logfile=/var/log/fakeApi/out.log
I am writing this step ....
server {
listen 80; ## listen for ipv4; this line is default and implied
#listen [::]:80 default_server ipv6only=on; ## listen for ipv6
root /usr/share/nginx/www;
index index.html index.htm;
# Make site accessible from http://localhost/
server_name localhost fake-api.local fake-api.olx.com;
location / {
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header X-Fake-Domain $host;
proxy_set_header Host $host;
proxy_pass http://127.0.0.1:9090;
}
# Next config of nginx...
}
P.S: By default the cross domain is always enabled.