# Aplicações móveis

As aplicações para iOS, Android, Flutter e React Native acedem **ao seu backend**, e o seu backend acede ao TryOnCloud. Nunca coloque a chave da API na aplicação: qualquer pessoa pode extraí-la do pacote da aplicação.

```flow
Mobile app -> Your backend: POST /try-on (photo + product image URL)
Your backend -> TryOnCloud API: POST /api/v1/generate (X-API-KEY)
TryOnCloud API --> Your backend: 200 image/png
Your backend --> Mobile app: 200 image/png
```

Crie o ponto de extremidade do backend com [Node.js](/docs/nodejs), [Python](/docs/python) ou [PHP](/docs/php). Em seguida, chame-o a partir da aplicação:

## React Native

```js
const form = new FormData()
form.append("person", { uri: photo.uri, name: "person.jpg", type: "image/jpeg" })
form.append("garmentUrl", product.imageUrl)

const res = await fetch("https://api.yourapp.com/try-on", { method: "POST", body: form })
// Show the result: save the PNG with expo-file-system or react-native-fs, then render it.
```

## Flutter

```dart
final req = http.MultipartRequest('POST', Uri.parse('https://api.yourapp.com/try-on'))
  ..files.add(await http.MultipartFile.fromPath('person', photo.path))
  ..fields['garmentUrl'] = product.imageUrl;
final res = await http.Response.fromStream(await req.send());
if (res.statusCode == 200) {
  setState(() => resultBytes = res.bodyBytes); // Image.memory(resultBytes!)
}
```

## Swift (iOS)

```swift
var req = URLRequest(url: URL(string: "https://api.yourapp.com/try-on")!)
req.httpMethod = "POST"
req.timeoutInterval = 120
// Build a multipart body with "person" (JPEG data) and "garmentUrl", then:
let (data, response) = try await URLSession.shared.upload(for: req, from: body)
if (response as? HTTPURLResponse)?.statusCode == 200 { image = UIImage(data: data) }
```

## Kotlin (Android)

```kotlin
val body = MultipartBody.Builder().setType(MultipartBody.FORM)
    .addFormDataPart("person", "person.jpg", photoFile.asRequestBody("image/jpeg".toMediaType()))
    .addFormDataPart("garmentUrl", product.imageUrl)
    .build()
val request = Request.Builder().url("https://api.yourapp.com/try-on").post(body).build()
client.newCall(request).execute().use { res -> if (res.isSuccessful) bitmap = BitmapFactory.decodeStream(res.body!!.byteStream()) }
```

Defina o tempo limite HTTP para, pelo menos, 120 segundos; um «try-on» demora cerca de 20 segundos.

Em redes móveis pouco fiáveis, faça com que o seu backend envie uma `Idempotency-Key` por cada prova para que uma nova tentativa nunca seja cobrada duas vezes, ou utilize uma [tarefa assíncrona](/docs/async) e avise a aplicação (por exemplo, com uma notificação push) quando chegar o webhook `generation.completed`.
