<h2>Introduction</h2>
<p>Welcome to the Encore Tour!
We’re going to teach you everything there is to know about using Encore
to build backend services.</p>
<p>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>.</p>
<h2>Your first API</h2>
<p>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>.</p>
<p>Use the <strong>API Explorer</strong> to make an API call.
Then, click Next below to continue.</p>


Basics

<h2>Request Parameters</h2>
<p>An API that doesn’t accept any request data is not very useful!
Let’s fix that.</p>
<p>First, add a new <code>Request</code> type with a <code>Name</code> field:</p>
<pre><code class="language-go">type Request struct {
    Name string
}
</code></pre>
<p>Then, change the <code>Greet</code> function to accept a <code>*Request</code> as its second parameter:</p>
<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>
<p>Try changing <code>Hello</code> to another greeting and press <strong>Deploy</strong> to see your changes.</p>


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
}
