<h2>Introduction</h2>
Welcome to the Encore Tour!
We’re going to teach you everything there is to know about using Encore
to build backend services.
If you haven’t used Go, we recommend going through the basics of
the <a href="https://tour.golang.org/welcome/1" rel="nofollow" target="_blank">Go Tour</a>.
<h2>Your first API</h2>
As you can see on the right, defining an API with Encore
is done by defining a function and annotating it with <code>//encore:api public</code>.
Use the API Explorer to make an API call.
Then, click Next below to continue.

Basics

<h2>Request Parameters</h2>
An API that doesn’t accept any request data is not very useful!
Let’s fix that.
First, add a new <code>Request</code> type with a <code>Name</code> field:
<pre><code class="language-go">type Request struct {
 Name string
}
</code></pre>
Then, change the <code>Greet</code> function to accept a <code>*Request</code> as its second parameter:
<pre><code class="language-go">func Greet(ctx context.Context, req *Request) (*Response, error) {
 return &amp;Response{Message: &quot;Hello, &quot; + req.Name + &quot;!&quot;}, nil
}
</code></pre>
Try changing <code>Hello</code> to another greeting and press Deploy to see your changes.

Request Data

Introduction

module play

require "encore.dev" v0.0.0


package hello

import "context"

type Response struct {
    Message string
}

//encore:api public
func World(ctx context.Context) (*Response, error) {
    return &Response{Message: "Hello, world!"}, nil
}
