Stio.HashidsNet.AspNetCore 1.6.1

Hashids.AspNetCore

Extension library for hashids.net.
Auto decode and encode hash ids for your api.

Getting started

1. Install package:

From PM console:

Install-Package Stio.Hashids.AspNetCore

or .net core cli:

dotnet add package Stio.Hashids.AspNetCore

2. Register service:

builder.Services.AddHashids("this is my salt");

3. Decorate hash properties:
   In your DTOs, decorate the properties that you want to be hash with one of the:

• HashidsIntJsonConverterAttribute
• HashidsNullableIntJsonConverterAttribute
• HashidsLongJsonConverterAttribute
• HashidsNullableLongJsonConverterAttribute

public class SampleModel
{
    [HashidsLongJsonConverter]
    public long HashidsLong { get; set; }

    [HashidsNullableLongJsonConverter]
    public long? NullableHashidsLong { get; set; }

    public long NonHashidsLong { get; set; }

    [HashidsIntJsonConverter]
    public int HashidsInt { get; set; }

    [HashidsNullableIntJsonConverter]
    public int? HashidsNullableInt { get; set; }

    public int NonHashidsInt { get; set; }
}

Use decorated model in your api for request or response

[HttpPost]
public ActionResult<SampleModel> DecodeFromBody(SampleModel request)
{
    return this.Ok(request);
}

For hash the parameters of a route, query, or form-data, use the HashidsBinderAttribute

 [HttpGet("decode/{id}")]
 public IActionResult DecodeFromRoute([HashidsBinder] long id)
 {
     return this.Ok(id);
 }

 [HttpGet("decode")]
 public IActionResult DecodeFromQuery([HashidsBinder] long id)
 {
     return this.Ok(id);
 }

 [HttpPost("decode")]
 public IActionResult DecodeFromForm([FromForm, HashidsBinder] long id)
 {
     return this.Ok(id);
 }

See full example.