totole/services
1
0
Fork 0
mirror of https://github.com/kevin-DL/services.git synced 2026-01-11 19:04:35 +00:00
Code Issues Packages Projects Releases Wiki Activity

tweaks to docs (#200)

Browse Source
This commit is contained in:
Dominic Wong
2021-09-02 15:23:24 +01:00
committed by GitHub
parent 2e5af32faf
commit d378ef2de5
39 changed files with 83 additions and 88 deletions
Download Patch File Download Diff File Expand all files Collapse all files

4
.github/workflows/integration.yml vendored
View File

@@ -7,10 +7,10 @@ jobs:
name: Integration tests name: Integration tests
runs-on: ubuntu-latest runs-on: ubuntu-latest
steps: steps:
- name: Set up Go 1.13 - name: Set up Go 1.15
uses: actions/setup-go@v2 uses: actions/setup-go@v2
with: with:
go-version: 1.13 go-version: 1.15
id: go id: go
- name: Install Protoc - name: Install Protoc

2
.github/workflows/tests.yml vendored
View File

@@ -24,7 +24,7 @@ jobs:
- name: Set up Go 1.13 - name: Set up Go 1.13
uses: actions/setup-go@v1 uses: actions/setup-go@v1
with: with:
go-version: 1.13 go-version: 1.15
id: go id: go
- name: Check out code into the Go module directory - name: Check out code into the Go module directory

2
answer/proto/answer.proto
View File

@@ -8,7 +8,7 @@ service Answer {
rpc Question(QuestionRequest) returns (QuestionResponse) {} rpc Question(QuestionRequest) returns (QuestionResponse) {}
} }
// Answer a question and receive an instant answer // Ask a question and receive an instant answer
message QuestionRequest { message QuestionRequest {
// the question to answer // the question to answer
string query = 1; string query = 1;

4
cache/README.md vendored
View File

@@ -2,6 +2,6 @@ Quick access key-value storage
# Cache Service # Cache Service
The cache service provides simple get/set/delete key-value storage along with ttl support. The cache service provides simple get/set/delete key-value storage. Values can be stored with an optional time-to-live (TTL) to automatically expire entries.
The max value size is 1mb The max value size is 1MB.

14
cache/proto/cache.proto vendored
View File

@@ -53,32 +53,32 @@ message DeleteResponse {
string status = 1; string status = 1;
} }
// Increment a value (if its a number) // Increment a value (if it's a number)
message IncrementRequest { message IncrementRequest {
// The key to increment // The key to increment
string key = 1; string key = 1;
// The value to add // The amount to increment the value by
int64 value = 2; int64 value = 2;
} }
message IncrementResponse { message IncrementResponse {
// The key incremented // The key incremented
string key = 1; string key = 1;
// The result value // The new value
int64 value = 2; int64 value = 2;
} }
// Decrement a value (if its a number) // Decrement a value (if it's a number)
message DecrementRequest { message DecrementRequest {
// The key to decrement // The key to decrement
string key = 1; string key = 1;
// The delta value to decrement // The amount to decrement the value by
int64 value = 2; int64 value = 2;
} }
message DecrementResponse { message DecrementResponse {
// The key of the item // The key decremented
string key = 1; string key = 1;
// The result value of the item // The new value
int64 value = 2; int64 value = 2;
} }

4
crypto/README.md
View File

@@ -1,7 +1,7 @@
Cryptocurrency prices, quotes and news Cryptocurrency prices, quotes, and news
# Crypto Service # Crypto Service
Get up to the second cryptocurrency prices, quotes, previous close information and news. Get up to the second cryptocurrency prices, quotes, previous close information, and news.
Powered by [Finage](https://finage.co.uk) Powered by [Finage](https://finage.co.uk)

4
crypto/proto/crypto.proto
View File

@@ -39,7 +39,7 @@ message NewsResponse {
// Get the last price for a given crypto ticker // Get the last price for a given crypto ticker
message PriceRequest { message PriceRequest {
// crypto symbol e.g BTCUSD // the crypto symbol e.g BTCUSD
string symbol = 1; string symbol = 1;
} }
@@ -50,7 +50,7 @@ message PriceResponse {
double price = 2; double price = 2;
} }
// Get the last quote for the crypto // Get the last quote for a given crypto ticker
message QuoteRequest { message QuoteRequest {
// the crypto symbol e.g BTCUSD // the crypto symbol e.g BTCUSD
string symbol = 1; string symbol = 1;

2
db/README.md
View File

@@ -2,4 +2,4 @@ Simple database service
# DB Service # DB Service
The DB service is a simple database which provides persistent storage via a CRUD API. It includes fast querying, ordering and more. The DB service is a simple database which provides persistent storage via a Create Read Update Delete (CRUD) API. It includes fast querying, ordering, and more.

16
db/proto/db.proto
View File

@@ -16,7 +16,7 @@ service Db {
// Read data from a table. Lookup can be by ID or via querying any field in the record. // Read data from a table. Lookup can be by ID or via querying any field in the record.
message ReadRequest { message ReadRequest {
// Optional table name // Optional table name. Defaults to 'default'
string table = 1; string table = 1;
// Read by id. Equivalent to 'id == "your-id"' // Read by id. Equivalent to 'id == "your-id"'
string id = 2; string id = 2;
@@ -27,7 +27,7 @@ message ReadRequest {
// Accessing list elements is not supported yet. // Accessing list elements is not supported yet.
string query = 3; string query = 3;
int32 offset = 4; int32 offset = 4;
// Default limit is 25. // Maximum number of records to return. Default limit is 25.
// Maximum limit is 1000. Anything higher will return an error. // Maximum limit is 1000. Anything higher will return an error.
int32 limit = 5; int32 limit = 5;
// field name to order by // field name to order by
@@ -41,9 +41,9 @@ message ReadResponse {
repeated google.protobuf.Struct records = 1; repeated google.protobuf.Struct records = 1;
} }
// Create a record in the database. Optionally include an "id" field otherwise its set automatically. // Create a record in the database. Optionally include an "id" field otherwise it's set automatically.
message CreateRequest { message CreateRequest {
// Optional table name // Optional table name. Defaults to 'default'
string table = 1; string table = 1;
// JSON encoded record or records (can be array or object) // JSON encoded record or records (can be array or object)
google.protobuf.Struct record = 2; google.protobuf.Struct record = 2;
@@ -56,9 +56,9 @@ message CreateResponse {
// Update a record in the database. Include an "id" in the record to update. // Update a record in the database. Include an "id" in the record to update.
message UpdateRequest { message UpdateRequest {
// Optional table name // Optional table name. Defaults to 'default'
string table = 1; string table = 1;
// The id of the record // The id of the record. If not specified it is inferred from the 'id' field of the record
string id = 2; string id = 2;
// record, JSON object // record, JSON object
google.protobuf.Struct record = 3; google.protobuf.Struct record = 3;
@@ -68,7 +68,7 @@ message UpdateResponse {}
// Delete a record in the database by id. // Delete a record in the database by id.
message DeleteRequest { message DeleteRequest {
// Optional table name // Optional table name. Defaults to 'default'
string table = 1; string table = 1;
// id of the record // id of the record
string id = 2; string id = 2;
@@ -80,7 +80,7 @@ message DeleteResponse {
// Truncate the records in a table // Truncate the records in a table
message TruncateRequest { message TruncateRequest {
// Optional table name // Optional table name. Defaults to 'default'
string table = 1; string table = 1;
} }

2
email/README.md
View File

@@ -2,7 +2,7 @@ Send emails in a flash
# Emails Service # Emails Service
A quick and easy email api. Simply provide a from, to and text or html body. A quick and easy email API. Simply provide a from, to, and text or html body.
Powered by [Sendgrid](https://sendgrid.com) Powered by [Sendgrid](https://sendgrid.com)

4
email/proto/email.proto
View File

@@ -8,9 +8,9 @@ service Email {
rpc Send(SendRequest) returns (SendResponse) {} rpc Send(SendRequest) returns (SendResponse) {}
} }
// Send an email by passing in from, to, subject and a text or html body // Send an email by passing in from, to, subject, and a text or html body
message SendRequest { message SendRequest {
// the name of the sender // the display name of the sender
string from = 1; string from = 1;
// the email address of the recipient // the email address of the recipient
string to = 2; string to = 2;

4
emoji/proto/emoji.proto
View File

@@ -45,9 +45,9 @@ message PrintResponse {
string text = 1; string text = 1;
} }
// Send an emoji to anyone via SMS // Send an emoji to anyone via SMS. Messages are sent in the form '<message> Sent from <from>'
message SendRequest { message SendRequest {
// who the message is from e.g Alice // the name of the sender from e.g Alice
string from = 1; string from = 1;
// phone number to send to (including international dialing code) // phone number to send to (including international dialing code)
string to = 2; string to = 2;

4
file/README.md
View File

@@ -1,5 +1,5 @@
Store, list and retrieve text files Store, list, and retrieve text files
# File Service # File Service
Save, list and retrieve text files by project and path. Save, list, and retrieve text files. Files can have a path in the same way they would on your computer e.g.`/documents/text-files/file.txt`. Files can optionally be grouped in to projects.

4
file/proto/file.proto
View File

@@ -56,12 +56,12 @@ message SaveRequest {
message SaveResponse { message SaveResponse {
} }
// List file by their project and optionally a path. // List files by their project and optionally a path.
message ListRequest { message ListRequest {
// Project, required for listing. // Project, required for listing.
string project = 1; string project = 1;
// Defaults to '/', ie. lists all files in a project. // Defaults to '/', ie. lists all files in a project.
// Supply path if of a folder if you want to list // Supply path to a folder if you want to list
// files inside that folder // files inside that folder
// eg. '/docs' // eg. '/docs'
string path = 2; string path = 2;

4
forex/README.md
View File

@@ -1,8 +1,8 @@
Foreign Exchange (FX) rates Foreign exchange (FX) rates
# Forex Service # Forex Service
Real-time and Historical Foreign Exchange (FX) rates from over 200 world currencies. Real-time and historical foreign exchange (FX) rates for over 200 world currencies. Get the latest rates and bid/ask prices.
Powered by [Finage](https://finage.co.uk) Powered by [Finage](https://finage.co.uk)

4
forex/proto/forex.proto
View File

@@ -10,7 +10,7 @@ service Forex {
rpc History(HistoryRequest) returns (HistoryResponse) {} rpc History(HistoryRequest) returns (HistoryResponse) {}
} }
// Get the last price for a given forex ticker // Get the latest price for a given forex ticker
message PriceRequest { message PriceRequest {
// forex symbol e.g GBPUSD // forex symbol e.g GBPUSD
string symbol = 1; string symbol = 1;
@@ -23,7 +23,7 @@ message PriceResponse {
double price = 2; double price = 2;
} }
// Get the last quote for the forex // Get the latest quote for the forex
message QuoteRequest { message QuoteRequest {
// the forex symbol e.g GBPUSD // the forex symbol e.g GBPUSD
string symbol = 1; string symbol = 1;

2
geocoding/README.md
View File

@@ -2,5 +2,5 @@ Geocode an address to gps location and the reverse.
# Geocoding Service # Geocoding Service
The geocoding service provides address to lat lng geocoding as well as the reverse. The geocoding service provides address to latitude longitude geocoding as well as the reverse.
It's useful for building mapping or location based services. It's useful for building mapping or location based services.

2
geocoding/proto/geocoding.proto
View File

@@ -23,7 +23,7 @@ message Location {
double longitude = 2; double longitude = 2;
} }
// Lookup returns a geocoded address including normalized address and gps coordinates // Lookup returns a geocoded address including normalized address and gps coordinates. All fields are optional, provide more to get more accurate results
message LookupRequest { message LookupRequest {
string address = 1; string address = 1;
string city = 2; string city = 2;

8
go.mod
View File

@@ -1,16 +1,14 @@
module github.com/micro/services module github.com/micro/services
go 1.14 go 1.15
require ( require (
github.com/HdrHistogram/hdrhistogram-go v1.1.0 // indirect
github.com/Masterminds/semver/v3 v3.1.1 github.com/Masterminds/semver/v3 v3.1.1
github.com/PuerkitoBio/goquery v1.6.1 github.com/PuerkitoBio/goquery v1.6.1
github.com/SlyMarbo/rss v1.0.1 github.com/SlyMarbo/rss v1.0.1
github.com/asim/mq v0.1.0 github.com/asim/mq v0.1.0
github.com/cdipaolo/goml v0.0.0-20190412180403-e1f51f713598 // indirect github.com/cdipaolo/goml v0.0.0-20190412180403-e1f51f713598 // indirect
github.com/cdipaolo/sentiment v0.0.0-20200617002423-c697f64e7f10 github.com/cdipaolo/sentiment v0.0.0-20200617002423-c697f64e7f10
github.com/cpuguy83/go-md2man/v2 v2.0.0 // indirect
github.com/crufter/lexer v0.0.0-20120907053443-23fe8c7add01 github.com/crufter/lexer v0.0.0-20120907053443-23fe8c7add01
github.com/disintegration/imaging v1.6.2 github.com/disintegration/imaging v1.6.2
github.com/enescakir/emoji v1.0.0 github.com/enescakir/emoji v1.0.0
@@ -32,8 +30,6 @@ require (
github.com/mattheath/kala v0.0.0-20171219141654-d6276794bf0e github.com/mattheath/kala v0.0.0-20171219141654-d6276794bf0e
github.com/micro/micro/v3 v3.4.1-0.20210827085315-cdb3e3adc9b3 github.com/micro/micro/v3 v3.4.1-0.20210827085315-cdb3e3adc9b3
github.com/miekg/dns v1.1.31 // indirect github.com/miekg/dns v1.1.31 // indirect
github.com/onsi/ginkgo v1.15.0 // indirect
github.com/opentracing/opentracing-go v1.2.0 // indirect
github.com/oschwald/geoip2-golang v1.5.0 github.com/oschwald/geoip2-golang v1.5.0
github.com/patrickmn/go-cache v2.1.0+incompatible github.com/patrickmn/go-cache v2.1.0+incompatible
github.com/paulmach/go.geo v0.0.0-20180829195134-22b514266d33 github.com/paulmach/go.geo v0.0.0-20180829195134-22b514266d33
@@ -46,8 +42,6 @@ require (
github.com/tkuchiki/go-timezone v0.2.2 github.com/tkuchiki/go-timezone v0.2.2
github.com/ttacon/builder v0.0.0-20170518171403-c099f663e1c2 // indirect github.com/ttacon/builder v0.0.0-20170518171403-c099f663e1c2 // indirect
github.com/ttacon/libphonenumber v1.2.1 // indirect github.com/ttacon/libphonenumber v1.2.1 // indirect
github.com/uber/jaeger-client-go v2.29.1+incompatible // indirect
github.com/uber/jaeger-lib v2.4.1+incompatible // indirect
go.opencensus.io v0.22.4 // indirect go.opencensus.io v0.22.4 // indirect
golang.org/x/crypto v0.0.0-20210322153248-0c34fe9e7dc2 golang.org/x/crypto v0.0.0-20210322153248-0c34fe9e7dc2
golang.org/x/net v0.0.0-20210226172049-e18ecbb05110 golang.org/x/net v0.0.0-20210226172049-e18ecbb05110

2
go.sum
View File

@@ -358,8 +358,6 @@ github.com/mattn/go-sqlite3 v1.14.5 h1:1IdxlwTNazvbKJQSxoJ5/9ECbEeaTTyeU7sEAZ5KK
github.com/mattn/go-sqlite3 v1.14.5/go.mod h1:WVKg1VTActs4Qso6iwGbiFih2UIHo0ENGwNd0Lj+XmI= github.com/mattn/go-sqlite3 v1.14.5/go.mod h1:WVKg1VTActs4Qso6iwGbiFih2UIHo0ENGwNd0Lj+XmI=
github.com/mattn/go-tty v0.0.0-20180219170247-931426f7535a/go.mod h1:XPvLUNfbS4fJH25nqRHfWLMa1ONC8Amw+mIA639KxkE= github.com/mattn/go-tty v0.0.0-20180219170247-931426f7535a/go.mod h1:XPvLUNfbS4fJH25nqRHfWLMa1ONC8Amw+mIA639KxkE=
github.com/matttproud/golang_protobuf_extensions v1.0.1/go.mod h1:D8He9yQNgCq6Z5Ld7szi9bcBfOoFv/3dc6xSMkL2PC0= github.com/matttproud/golang_protobuf_extensions v1.0.1/go.mod h1:D8He9yQNgCq6Z5Ld7szi9bcBfOoFv/3dc6xSMkL2PC0=
github.com/micro/micro/v3 v3.3.1-0.20210611161948-fd9821dd4f52 h1:laHYhHMiGtbv/jjykUubxxGW+1HAgTi0RFDsNOnwXxg=
github.com/micro/micro/v3 v3.3.1-0.20210611161948-fd9821dd4f52/go.mod h1:0NVo+HuGK22cbFqkLe59rGZZeXh2++XBfhU+xheOh8g=
github.com/micro/micro/v3 v3.4.1-0.20210827085315-cdb3e3adc9b3 h1:oS7027tNGjfpLeLOIFTHF06xXGJ2HjHXfk+8VaU19AY= github.com/micro/micro/v3 v3.4.1-0.20210827085315-cdb3e3adc9b3 h1:oS7027tNGjfpLeLOIFTHF06xXGJ2HjHXfk+8VaU19AY=
github.com/micro/micro/v3 v3.4.1-0.20210827085315-cdb3e3adc9b3/go.mod h1:cgV1bNfRLOE4vytanTo+N/QvjsdTRJRKTVqKq6XH7AA= github.com/micro/micro/v3 v3.4.1-0.20210827085315-cdb3e3adc9b3/go.mod h1:cgV1bNfRLOE4vytanTo+N/QvjsdTRJRKTVqKq6XH7AA=
github.com/miekg/dns v1.1.15/go.mod h1:W1PPwlIAgtquWBMBEV9nkV9Cazfe8ScdGz/Lj7v3Nrg= github.com/miekg/dns v1.1.15/go.mod h1:W1PPwlIAgtquWBMBEV9nkV9Cazfe8ScdGz/Lj7v3Nrg=

5
helloworld/proto/helloworld.proto
View File

@@ -18,10 +18,11 @@ message Response {
string message = 1; string message = 1;
} }
// Stream returns a streaming helloworld response // Stream returns a stream of "Hello $name" responses
message StreamRequest { message StreamRequest {
string name = 1; string name = 1;
int64 messages = 2; // the number of messages to send back
int64 messages = 2;
} }
message StreamResponse { message StreamResponse {

2
id/README.md
View File

@@ -2,5 +2,5 @@ Generate unique IDs (uuid, snowflake, etc)
# ID Service # ID Service
The ID service provides unique ID generation. Including uuid, snowflake (64 bit) and bigflake (128 bit) The ID service provides unique ID generation. Including UUID, [snowflake](https://en.wikipedia.org/wiki/Snowflake_ID) (64 bit) and [bigflake](https://archive.is/2015.07.08-082503/http://www.boundary.com/blog/2012/01/flake-a-decentralized-k-ordered-unique-id-generator-in-erlang/) (128 bit)

4
image/README.md
View File

@@ -1,5 +1,5 @@
Quickly upload, resize and convert images Quickly upload, resize, and convert images
# Image Service # Image Service
The image service provides upload, resize and image conversion. It provides a cdn for uploaded images and a simple API. The image service provides upload, resize, and image conversion. It provides a CDN for uploaded images and a simple API.

2
ip/README.md
View File

@@ -2,4 +2,4 @@ IP to geolocation lookup
# IP Service # IP Service
The IP service provides IP to geolocation lookup including asn, city, country, timezone and lat/long. The IP service provides IP to geolocation lookup including asn, city, country, timezone, and latitude/longitude.

5
location/README.md
View File

@@ -2,6 +2,9 @@ Real time GPS location tracking and search
# Location Service # Location Service
Send, store and search real time gps point data and tracking info using the location API. Send, store, and search real time GPS point data and tracking information using the location API.
- Record and retrieve the locations of your entities
- Perform location based search of them including filters
Build powerful map rendered views with up to the second updated points on the map. Build powerful map rendered views with up to the second updated points on the map.

8
location/proto/location.proto
View File

@@ -16,9 +16,9 @@ service Location {
// A point is a GPS coordinate. // A point is a GPS coordinate.
message Point { message Point {
double latitude = 1; double latitude = 1;
double longitude = 2; double longitude = 2;
int64 timestamp = 3; int64 timestamp = 3;
} }
message Entity { message Entity {
@@ -53,7 +53,7 @@ message SearchRequest {
double radius = 2; double radius = 2;
// type of entities to filter // type of entities to filter
string type = 3; string type = 3;
// number of entities to return // Maximum number of entities to return
int64 numEntities = 4; int64 numEntities = 4;
} }

2
otp/README.md
View File

@@ -2,4 +2,4 @@ One time password generation
# OTP Service # OTP Service
Generate one time passwords (OTP) for any unique id, email or user. Codes are valid for up to 60 seconds. Generate one time passwords (OTP) for any unique id, email, or user. Codes have a user configurable expiry time.

2
otp/proto/otp.proto
View File

@@ -33,6 +33,6 @@ message ValidateRequest {
} }
message ValidateResponse { message ValidateResponse {
// returns true if successful // returns true if the code is valid for the ID
bool success = 1; bool success = 1;
} }

4
postcode/README.md
View File

@@ -1,5 +1,5 @@
Instant and fast postcode lookup Fast UK postcode lookup
# Postcode Service # Postcode Service
Lookup postcodes for their related country, region and additional information. Lookup UK postcodes for their related latitude/longitude, region, and additional information.

3
postcode/proto/postcode.proto
View File

@@ -33,7 +33,7 @@ message LookupResponse {
double longitude = 7; double longitude = 7;
} }
// Validate a postcode. Should return valid: true or valid: false // Validate a postcode.
message ValidateRequest { message ValidateRequest {
// UK postcode e.g SW1A 2AA // UK postcode e.g SW1A 2AA
string postcode = 1; string postcode = 1;
@@ -41,6 +41,7 @@ message ValidateRequest {
} }
message ValidateResponse { message ValidateResponse {
// Is the postcode valid (true) or not (false)
bool valid = 1; bool valid = 1;
} }

2
routing/README.md
View File

@@ -3,6 +3,6 @@ Etas, routes and turn by turn directions
# Routing Service # Routing Service
The routing service provides a faster and cheaper alternative to the Google Maps API. The routing service provides a faster and cheaper alternative to the Google Maps API.
Get etas, routes and turn by turn directions all from openstreetmap data. Get etas, routes, and turn by turn directions all from OpenStreetMap data.
Powered by [OSRM](http://project-osrm.org/) Powered by [OSRM](http://project-osrm.org/)

4
routing/proto/routing.proto
View File

@@ -56,7 +56,7 @@ message Direction {
repeated Intersection intersections = 7; repeated Intersection intersections = 7;
} }
// Turn by turn directions from a starting and endpoint including maneuvers and bearings // Turn by turn directions from a start point to an end point including maneuvers and bearings
message DirectionsRequest { message DirectionsRequest {
// The staring point for the journey // The staring point for the journey
Point origin = 1; Point origin = 1;
@@ -81,7 +81,7 @@ message EtaRequest {
Point origin = 1; Point origin = 1;
// The end point for the eta calculation // The end point for the eta calculation
Point destination = 2; Point destination = 2;
// type of transport e.g car, foot, bicycle // type of transport. Only "car" is supported currently.
string type = 3; string type = 3;
// speed in kilometers // speed in kilometers
double speed = 4; double speed = 4;

2
rss/README.md
View File

@@ -2,5 +2,5 @@ RSS feed crawler and reader
# RSS Service # RSS Service
Provides a simple way to crawl and index RSS feeds making them accessibly via a simple unified API. Provides a simple way to crawl and index RSS feeds making them accessible via a simple unified API.

2
rss/proto/rss.proto
View File

@@ -41,7 +41,7 @@ message Entry {
string date = 7; string date = 7;
} }
// Add a new RSS feed with a name, url and category // Add a new RSS feed with a name, url, and category
message AddRequest { message AddRequest {
// rss feed name // rss feed name
// eg. a16z // eg. a16z

4
time/README.md
View File

@@ -1,7 +1,7 @@
Time, date and timezone info Time, date, and timezone info
# Time Service # Time Service
Get the time, date and timezone info for any given location in the world. Get the time, date, and timezone info for any given location in the world.
Powered by [Weather API](https://weatherapi.com) Powered by [Weather API](https://weatherapi.com)

4
url/README.md
View File

@@ -1,5 +1,5 @@
URL shortening, sharing and tracking URL shortening, sharing, and tracking
# URL Service # URL Service
The url service provides one time short urls for anything. Shorten, share and track the usage. The url service provides one time short urls for anything. Shorten, share, and then track the usage.

5
url/proto/url.proto
View File

@@ -30,8 +30,7 @@ message URLPair {
int64 hitCount = 5; int64 hitCount = 5;
} }
// List shortened URLs. It has no input parameters, as it will take // List information on all the shortened URLs that you have created
// the user ID from the token and list the user's (caller's) shortened URLs.
message ListRequest { message ListRequest {
// filter by short URL, optional // filter by short URL, optional
string shortURL = 2; string shortURL = 2;
@@ -42,8 +41,6 @@ message ListResponse {
} }
// Proxy returns the destination URL of a short URL. // Proxy returns the destination URL of a short URL.
// Proxy resolves even URLs not owned by the token holder,
// unlike the List endpoint.
message ProxyRequest { message ProxyRequest {
// short url ID, without the domain, eg. if your short URL is // short url ID, without the domain, eg. if your short URL is
// `m3o.one/u/someshorturlid` then pass in `someshorturlid` // `m3o.one/u/someshorturlid` then pass in `someshorturlid`

17
user/proto/user.proto
View File

@@ -154,7 +154,7 @@ message LogoutResponse {
// Verify the email address of an account from a token sent in an email to the user. // Verify the email address of an account from a token sent in an email to the user.
message VerifyEmailRequest { message VerifyEmailRequest {
// The token from the verification email // The token from the verification email
string token = 1; string token = 1;
} }
@@ -163,21 +163,22 @@ message VerifyEmailResponse{
} }
// Send a verification email // Send a verification email
// to the user being signed up. Email from will be 'support@m3o.com', // to the user being signed up. Email from will be from 'support@m3o.com',
// but you can provide the title and contents. // but you can provide the title and contents.
// Use $micro_verification_link template variable in the content. // The verification link will be injected in to the email as a template variable, $micro_verification_link.
// Example: 'Hi there, welcome onboard! Use the link below to verify your email: $micro_verification_link'
// The variable will be replaced with an actual url that will look similar to this:
// 'https://user.m3o.com/user/verify?token=a-verification-token&rediretUrl=your-redir-url'
message SendVerificationEmailRequest{ message SendVerificationEmailRequest{
string email = 1; string email = 1;
string subject = 2; string subject = 2;
// Example: 'Hi there, welcome onboard! Use the link below to verify your email: $micro_verification_link' // Text content of the email. Don't forget to include the string '$micro_verification_link' which will be replaced by the real verification link
// The variable will be replaced with an actual url that will look similar to this:
// 'https://user.m3o.com/user/verify?token=a-verification-token&rediretUrl=your-redir-url'
// HTML emails are not available currently. // HTML emails are not available currently.
string textContent = 3; string textContent = 3;
string redirectUrl = 4; string redirectUrl = 4;
string failureRedirectUrl = 5; string failureRedirectUrl = 5;
// While the from email address can't be changed, // Display name of the sender for the email. Note: the email address will still be 'support@m3o.com'
// the from name (ie. sender name) can.
string fromName = 6; string fromName = 6;
} }

2
weather/proto/weather.proto
View File

@@ -61,7 +61,7 @@ message ForecastResponse {
string timezone = 6; string timezone = 6;
// the local time // the local time
string local_time = 7; string local_time = 7;
// forecase for the next number of days // forecast for the next number of days
repeated Forecast forecast = 8; repeated Forecast forecast = 8;
} }