# Sharklio Publisher Docs

> Developer docs for Sharklio publishers: show the Sharklio offerwall with a signed link, list offers in your own design with the Offers API, open a native offerwall with the mobile SDKs, and reward your users from signed server-to-server postbacks.

Every docs page is also plain Markdown: add `.md` to its URL, and use `/index.md` for the quick start. Keys and secrets never belong in a browser or an app: build links, sessions, and postback checks on your server.

## Getting started

- [Quick start](https://docs.sharklio.com/index.md): Sharklio publisher quick start: show the offerwall with a signed link, receive postbacks, and credit or deduct rewards.
- [Set up with an AI coding agent](https://docs.sharklio.com/ai-agent-setup.md): Set up Sharklio with an AI coding agent: the ready-made prompt in your dashboard, Markdown docs and llms.txt, the OpenAPI spec, where your keys go, and how to test.

## Web offerwall

- [Offerwall Link, Embed, and Button](https://docs.sharklio.com/offerwall-link.md): Build the Sharklio offerwall link: user_id and hash, HMAC-SHA256 with your link hash salt, iframe embed, floating button, offer filters, and error pages.

## Mobile SDKs

- [Android SDK](https://docs.sharklio.com/android-sdk.md): Sharklio Android SDK reference: install from the Sharklio Maven repository, create single-use sessions on your server, open the offerwall, and handle events.
- [iOS SDK](https://docs.sharklio.com/ios-sdk.md): Sharklio iOS SDK reference: install SharklioOfferwall with Swift Package Manager or CocoaPods, create single-use sessions on your server, open the offerwall from UIKit or SwiftUI, and handle events.
- [Flutter SDK](https://docs.sharklio.com/flutter-sdk.md): Sharklio Flutter SDK reference: install the sharklio_offerwall plugin from the Sharklio package repository, create single-use sessions on your server, open the offerwall, and handle events.
- [React Native SDK](https://docs.sharklio.com/react-native-sdk.md): Sharklio React Native SDK reference: install @sharklio/react-native-offerwall from the Sharklio npm registry, use it with Expo, create single-use sessions on your server, open the offerwall, and handle events.
- [Unity SDK](https://docs.sharklio.com/unity-sdk.md): Sharklio Unity SDK reference: install com.sharklio.offerwall from the Sharklio scoped registry, create single-use sessions on your server, open the offerwall from C#, and handle events.

## APIs

- [Offers API](https://docs.sharklio.com/offers-api.md): Sharklio Offers API reference: API key authentication, request parameters, the offer fields in the JSON response, starting offers, errors, and rate limits.
- [Reporting API](https://docs.sharklio.com/reporting-api.md): Sharklio Reporting API reference: statistics by day, country, offer, or sub ID, the conversion list with cursor paging, time zones, errors, and limits.

## Rewarding users

- [Postbacks](https://docs.sharklio.com/postbacks.md): Sharklio postback reference: URL setup, macros, status values, transaction and event IDs, HMAC-SHA256 verification, retries, and an example handler.
- [Credits and reversals](https://docs.sharklio.com/credits-and-reversals.md): How Sharklio credits and reversals work: status 1 and status 2 postbacks with one transaction ID, why results are reversed, what your server should do, and missing rewards.

## Help

- [Testing and troubleshooting](https://docs.sharklio.com/testing.md): Test your Sharklio integration and fix common problems: invalid links, hash mismatches, postbacks that fail, and duplicate or missing rewards.

## API reference

- [OpenAPI spec](https://docs.sharklio.com/openapi.json): Sharklio Publisher API 1.1.0, OpenAPI 3.1.0. List offers for your users, create sessions for the mobile SDKs, pull your statistics, and receive results through postbacks.

## Optional

- [Sharklio main site](https://sharklio.com/llms.txt): The company, the publisher program, and the Sharklio Academy guides.